API de Speedtest

Cómo funciona: Servidor Speedtest. El equivalente en la CLI es dtvsol speedtest …. Autenticación y errores: consulte la descripción general de la API.

GET /speedtest

El estado y la configuración del 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

Descarga el servidor de Ookla (el más reciente) y lo configura; lo inicia cuando está activado. 502 cuando la descarga falla.

POST /speedtest/set

Cambia la configuración (los campos indicados) y reinicia el servidor con ella.

Nombre	En	Tipo	Notas
enabled	body	boolean	Ejecutarlo o no.
hostname	body	string	El nombre del servidor (su DNS debe apuntar al router).
tcp_ports, udp_ports	body	array o string	De 1 a 8 puertos; 5060 y 8080 son los de speedtest.net.
ipv6	body	boolean	Escuchar también en IPv6.
tls	body	string	certbot, file, letsencrypt (el de Ookla, una vez registrado) o none.
cert_file, key_file	body	string	Rutas completas, para tls: file.
allowed_domains	body	string	Quién puede hacer pruebas: *.ookla.com, *.speedtest.net, o *.
max_conn_per_ip	body	integer	50–3000; null = el valor por defecto de Ookla.
cpu_cores	body	integer	Su límite de CPU.
auto_update	body	boolean	Ookla actualiza el servidor por sí solo.

POST /speedtest/on

Lo inicia (enabled: true).

POST /speedtest/off

Lo detiene.

POST /speedtest/restart

Vuelve a escribir su archivo de configuración y lo reinicia.

POST /speedtest/certificate

Un certificado de Let’s Encrypt para el hostname mediante certbot, y luego tls: certbot.

Nombre	En	Tipo	Notas
email	body	string	Para Let’s Encrypt. Obligatorio.
agree_tos	body	boolean	Términos de Let’s Encrypt aceptados. Obligatorio.

400 cuando el hostname no está configurado o no lleva a una de las direcciones del router; 502 cuando certbot falla (el puerto 80 debe llegar al router).

POST /speedtest/remove

Lo detiene y elimina los archivos de Ookla; la configuración se conserva.