API do Speedtest

Como funciona: Servidor Speedtest. O equivalente na CLI é dtvsol speedtest …. Autenticação e erros: veja a visão geral da API.

GET /speedtest

O estado e as configurações do servidor.

{
  "ok": true,
  "settings": {"enabled": true, "tcp_ports": [5060, 8080], "udp_ports": [5060, 8080], "ipv6": true,
               "allowed_domains": "*.ookla.com, *.speedtest.net", "tls": "certbot", "cert_file": "", "key_file": "",
               "hostname": "speedtest.your-isp.com", "max_conn_per_ip": null, "cpu_cores": 4, "auto_update": true},
  "installed": true,
  "version": "2.11.5.2 2026-06-04.1737.7d0993d",
  "running": true,
  "hello": {"ok": true, "answer": "hello 2.11 (2.11.5) 2026-06-04.1737.7d0993d"},
  "connections": 3,
  "tls_in_use": "self-signed",
  "tls_note": null,
  "certificate_expires": "2026-12-28 10:00:00",
  "certificate_days_left": 90,
  "register": "https://account.ookla.com (Speedtest server hosting): …"
}

POST /speedtest/install

Baixa o servidor da Ookla (o mais recente) e o configura; inicia-o quando ele está ligado. 502 quando o download falha.

POST /speedtest/set

Altera as configurações (os campos informados) e reinicia o servidor com elas.

Nome	Em	Tipo	Observações
enabled	body	boolean	Executá-lo, ou não.
hostname	body	string	O nome do servidor (o seu DNS precisa apontar para o roteador).
tcp_ports, udp_ports	body	array ou string	De 1 a 8 portas; 5060 e 8080 são as do speedtest.net.
ipv6	body	boolean	Escutar também em IPv6.
tls	body	string	certbot, file, letsencrypt (o da Ookla, depois de registrado) ou none.
cert_file, key_file	body	string	Caminhos completos, para tls: file.
allowed_domains	body	string	Quem pode testar: *.ookla.com, *.speedtest.net, ou *.
max_conn_per_ip	body	integer	50–3000; null = o padrão da Ookla.
cpu_cores	body	integer	O seu limite de CPU.
auto_update	body	boolean	A Ookla atualiza o servidor sozinha.

POST /speedtest/on

Inicia-o (enabled: true).

POST /speedtest/off

Para-o.

POST /speedtest/restart

Escreve de novo o seu arquivo de configurações e o reinicia.

POST /speedtest/certificate

Um certificado Let’s Encrypt para o hostname pelo certbot, depois tls: certbot.

Nome	Em	Tipo	Observações
email	body	string	Para o Let’s Encrypt. Obrigatório.
agree_tos	body	boolean	Termos do Let’s Encrypt aceitos. Obrigatório.

400 quando o hostname não está definido ou não leva a um dos endereços do roteador; 502 quando o certbot falha (a porta 80 precisa alcançar o roteador).

POST /speedtest/remove

Para-o e remove os arquivos da Ookla; as configurações são mantidas.