jsdelivr/globalping-probeO código do probe globalping que é executado no seu hardware e se conecta à rede comunitária global de probes
<img width="1000" alt="Cabeçalho da Sonda Globalping" src="https://assets.kitploit.com/production/public/readmes/11285/fd236190c18d0688eb15080e41595c607384aa6dbca36e9db0a1415102a04160.png"> # Sonda Globalping A [plataforma Globalping](https://github.com/jsdelivr/globalping) depende de uma rede globalmente distribuída de sondas hospedadas pela comunidade, permitindo que qualquer pessoa execute comandos de teste de rede como ping ou traceroute de qualquer local. ## Junte-se à comunidade de sondas Globalping O Globalping prospera com a contribuição da sua comunidade – com o seu apoio, podemos melhorar continuamente a plataforma e fornecer resultados de medição melhorados e confiáveis a todos os usuários gratuitamente. Ficaremos felizes em recebê-lo em nossa comunidade hospedando uma sonda! ### Configurar uma nova sonda Para ingressar na rede de sondas Globalping, tudo o que você precisa fazer é executar nosso contêiner Docker, que funciona tanto em arquiteturas x86 quanto ARM. #### Recomendado: Assistente do painel para Docker e Podman > [!TIP] > Recomendamos usar o assistente do painel para começar. Ele gera um comando que inclui seu token de adoção exclusivo para que a sonda seja adicionada automaticamente à sua conta. > > [Iniciar e adotar uma nova sonda](https://dash.globalping.io/probes?view=start-a-probe) #### Alternativa #1: Docker com adoção opcional/manual ``` docker run -d --log-driver local --network host --restart=always --name globalping-probe globalping/globalping-probe ``` Se você tem uma conta Globalping, lembre-se de adicionar seu token de adoção para gerar créditos e aumentar seus limites de taxa `-e GP_ADOPTION_TOKEN=XXX` > [!TIP] > Para automação, considere usar nosso [script de instalação universal para servidores Linux](https://gist.github.com/jimaek/7b8312c2c37f9002a5cc0108ebfd43e1) e adaptá-lo conforme necessário. #### Alternativa #2: Podman com adoção opcional/manual Para usuários que optam pelo Podman, [siga as instruções aqui](https://linuxhandbook.com/autostart-podman-containers/) para garantir que o contêiner inicie automaticamente na inicialização. Além disso, verifique os logs do contêiner para ver se ele iniciou corretamente, pois o Podman pode exigir permissões adicionais. Execute o contêiner com o seguinte comando: ``` sudo podman run --cap-add=NET_RAW -d --network host --restart=always --name globalping-probe globalping/globalping-probe ``` ### Registro alternativo Caso o registro principal do Docker Hub esteja inacessível para o seu servidor por qualquer motivo, você pode usar nosso espelho oficial do GitHub Packages. ``` docker run -d --log-driver local --network host --restart=always --name globalping-probe ghcr.io/jsdelivr/globalping-probe ``` Observe que o ghcr.io não suporta IPv6 no momento. ## Adote suas sondas Cada nova sonda que fica online é uma grande ajuda para nossa plataforma e para a comunidade, e queremos incentivar todos a iniciar novas sondas em todo hardware disponível! Se você também é um usuário ativo do Globalping que precisa de limites maiores que os gratuitos, recomendamos que se registre no [Painel Globalping](https://dash.globalping.io/) e adote suas sondas. Cada sonda adotada gerará créditos diários adicionais que você pode usar para executar ainda mais testes. Saiba mais sobre [créditos Globalping](https://globalping.io/credits) ### Adoção automatizada Você também pode tornar o processo de adoção totalmente automatizado definindo uma variável de ambiente `GP_ADOPTION_TOKEN` com seu token de adoção exclusivo. Basta verificar o [Painel](https://dash.globalping.io/probes?view=start-a-probe) para um comando personalizado que inclui o token. Observe que qualquer pessoa que conheça seu token de adoção poderá registrar novas sondas em sua conta. ## Onde executar Você pode executar a sonda virtual em qualquer coisa que possa executar um contêiner Docker, suportando arquiteturas x86 e ARM. Isso inclui qualquer servidor Linux hospedado com um provedor de nuvem, seu servidor doméstico ou até mesmo um Raspberry Pi por aí no seu escritório. Nenhuma configuração é necessária; basta executar o contêiner com uma conexão de internet estável. ## Como atualizar Você não precisa se preocupar com atualizações: A sonda atualiza automaticamente para a versão mais recente assim que disponível. Ela é baixada diretamente do GitHub e instalada dentro do contêiner. > [!NOTE] > O próprio contêiner não é atualizado automaticamente, apenas o código que ele executa. ### Opcional: Atualização do contêiner Como a atualização automática não atualiza o contêiner, recomendamos que você baixe uma versão nova do contêiner regularmente. Para atualizar o contêiner, execute o seguinte: ``` docker pull globalping/globalping-probe docker stop globalping-probe docker rm globalping-probe docker run -d --log-driver local --network host --restart=always --name globalping-probe globalping/globalping-probe ``` ## Limitações - Você pode executar apenas uma (1) sonda por endereço IP. - Desconectamos sondas que não podemos resolver de forma confiável para uma localização física. - Bloqueamos sondas cujo tráfego é roteado através de proxies anônimos, nós de saída Tor ou serviços VPN. ## Segurança - A sonda só se conecta à nossa API por uma conexão segura; ela não abre portas no seu dispositivo nem aceita conexões de entrada. - Usamos listas e bancos de dados atualizados regularmente de [domínios](https://github.com/jsdelivr/globalping/blob/master/src/lib/malware/domain.ts) e [endereços IP](https://github.com/jsdelivr/globalping/blob/master/src/lib/malware/ip.ts) associados a malware ou conteúdo potencialmente perigoso e os banimos no nível da API. - Bloqueamos endereços IP privados como alvos. - Limitamos a taxa de todos os usuários no nível da API para evitar abuso de rede. ## Ajustando o número de testes O número de testes de medição que sua sonda pode processar é dimensionado com base nos núcleos de CPU disponíveis e na carga média da CPU nos últimos minutos. Nosso código é muito leve e não consome muitos recursos, então na maioria dos casos, **recomendamos executar nossa sonda como está**. No entanto, se você ainda quiser controlar o uso de recursos, adicione o parâmetro docker `--cpuset-cpus="0-2"` ao seu comando `docker run` e defina o número de CPUs dentro das aspas. ## Sondas de Hardware <img src="https://assets.kitploit.com/production/public/readmes/11285/776ba05c4fe27e23932d0be09370be05944aa779000eb2d2a10662d499a40976.png" alt="sonda globalping" height="200px" align="right"/> Como Patrocinador do GitHub contribuindo com $10+ por mês, você pode solicitar uma sonda de hardware e instalá-la em casa ou no seu escritório. ### Como funciona? Conecte a sonda ao seu switch ou roteador, e pronto! Não há necessidade de configurar o contêiner Docker você mesmo ou ter um computador ligado 24/7. O pacote da sonda de hardware inclui tudo o que você precisa para começar: - Mini computador baseado em ARM em uma caixa de metal - Fonte de alimentação - Cartão SD com SO e contêiner de sonda pré-instalados - Cabo de rede Ethernet Para solicitar uma sonda, torne-se um Patrocinador do GitHub e [preencha este formulário](https://docs.google.com/forms/d/e/1FAIpQLSetKnI7CheDuwgl8QeARu2XzhXTXmek0GdKkpN5MW7WV3pVtw/viewform). > [!TIP] > Você também pode explorar o firmware da sonda de hardware e criar sua própria versão. Saiba mais [aqui](https://github.com/jsdelivr/globalping-hwprobe). ### Torne-se um provedor de sondas de hardware Oferecemos a empresas a oportunidade de patrocinar sondas de hardware co-branded para distribuir em conferências ou enviar para seus usuários com seus próprios adesivos e brindes incluídos. Saiba mais sobre [como se tornar um provedor de sondas de hardware](https://docs.google.com/document/d/1xIe-BaZ-6mmkjN1yMH5Kauw3FTXADrB79w4pnJ4SLa4/edit?usp=sharing). ## Suporte e feedback Se você estiver com dificuldades ou quiser nos dar seu feedback, por favor [abra uma nova issue](https://github.com/jsdelivr/globalping-probe/issues). ## Desenvolvimento Por favor, consulte [CONTRIBUTING.md](https://github.com/jsdelivr/globalping-probe/blob/master/CONTRIBUTING.md) para mais informações.
