Guia de Instalação do Probe

Siga estes passos para implantar seu próprio servidor de Speedtest em minutos usando Docker.

Requisitos Prévios

  • Servidor VPS ou Dedicado com Ubuntu 20.04+ ou Debian.
  • Domínio apontando para o IP do servidor (ex: speedtest.seu-isp.com).
  • IPs Públicos Estáticos (IPv4 obrigatório, IPv6 recomendado). Não use IPs dinâmicos nem CGNAT.
  • Geolocalização Correta: Os IPs devem estar registrados geograficamente na localização física do servidor (atualize bases de dados como MaxMind/IPinfo se necessário).
  • Conectividade de 1 Gbps ou superior (simétrico recomendado).
  • Portas 80 e 443 abertas (TCP).
  • Docker e Docker Compose instalados.

1. Preparar o Ambiente

Crie um diretório para o projeto e baixe os arquivos necessários.

git clone https://github.com/leatfre/probe-speedtest.net.ar.git
cd probe-speedtest.net.ar
# Configurar ambiente
cp .env.example .env

2. Configurar Variáveis

Crie um arquivo .env com seu domínio e email para o certificado SSL.

DOMAIN=speedtest.tu-isp.com
EMAIL=admin@tu-isp.com

3. Iniciar o Servidor

Suba os contêineres com o Docker Compose. Isso configurará automaticamente o Nginx e o SSL.

docker compose up -d

4. Verificação

Teste se os endpoints respondem corretamente a partir do seu navegador ou terminal.

https://speedtest.tu-isp.com/ipDeve retornar JSON com seu IP
https://speedtest.tu-isp.com/emptyDeve retornar HTTP 200 OK
Problemas com a instalação?

Se você precisar de ajuda técnica, entre em contato com nossa equipe de suporte em soporte@speedtest.net.ar