Sonda Globalping

A plataforma 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

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 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 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 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

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 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 e endereços IP 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

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.

[!TIP] Você também pode explorar o firmware da sonda de hardware e criar sua própria versão. Saiba mais aqui.

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.

Suporte e feedback

Se você estiver com dificuldades ou quiser nos dar seu feedback, por favor abra uma nova issue.

Desenvolvimento

Por favor, consulte CONTRIBUTING.md para mais informações.