Saltar al contenido

Túneles con nombre

Ver como Markdown Editar en GitHub Documentación de 1675df8

De forma predeterminada, Termbridge usa los Quick Tunnels sin cuenta de Cloudflare (trycloudflare.com). Son prácticos, pero pueden tener límites de frecuencia si se usan mucho.

Si usas Termbridge con frecuencia, configura un túnel con nombre con tu cuenta de Cloudflare.

¿Por qué usar un túnel con nombre?

  • Sin límites de frecuencia: con un uso intenso, los Quick Tunnels pueden devolver errores 429
  • URL coherente: obtén un subdominio estable en lugar de cadenas aleatorias
  • Dominio personalizado: usa tu propio dominio, como term.example.com
  • Mayor fiabilidad: los túneles con nombre son más estables en sesiones largas

Configuración

1. Crea una cuenta de Cloudflare

Regístrate en cloudflare.com si aún no tienes una.

2. Crea un túnel en Zero Trust

  1. Ve a Cloudflare Zero Trust
  2. Ve a Networks → Tunnels
  3. Haz clic en Create a tunnel
  4. Elige Cloudflared como conector
  5. Asigna un nombre al túnel (e.g, termbridge)
  6. Copia el token del túnel

3. Añade un nombre de host público

  1. En la configuración del túnel, ve a Public Hostname
  2. Añade un nombre de host que apunte a http://localhost:8080 (o al puerto que elijas)
  3. Usa un subdominio como term.example.com

4. Ejecuta Termbridge con tu token

Shell
termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com

O usa variables de entorno:

Shell
export TERMBRIDGE_TUNNEL_TOKEN=<TOKEN>
export TERMBRIDGE_TUNNEL_URL=https://term.example.com

termbridge --port 8080

Nota La opción --port es obligatoria con túneles con nombre porque el nombre de host está configurado para apuntar a un puerto específico.

Opciones de configuración

Opción Variable de entorno Descripción
--port <port> - Puerto local (obligatorio con túneles con nombre)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Tu token del túnel
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Tu nombre de host público URL

Desactivar completamente el túnel

Si tienes tu propio proxy inverso o URL público:

Shell
termbridge --no-tunnel --public-url https://your-server.com

O bien:

Shell
export TERMBRIDGE_TUNNEL=none
export TERMBRIDGE_PUBLIC_URL=https://your-server.com

termbridge

Termbridge omitirá el inicio de un túnel y usará el URL que proporciones para el código QR.

Solución de problemas

«429 Too Many Requests»

Esto significa que los Quick Tunnels tienen un límite de frecuencia. Soluciones:

  1. Espera unos minutos y vuelve a intentarlo
  2. Finaliza los procesos obsoletos de cloudflared: pkill cloudflared
  3. Cambia a un túnel con nombre (recomendado)

El túnel se inicia, pero URL no funciona

  • Comprueba que el nombre de host en Cloudflare coincida con --tunnel-url
  • Comprueba que el puerto en Cloudflare coincida con --port
  • Asegúrate de que cloudflared esté actualizado: cloudflared update

El túnel con nombre no conecta

  • Comprueba que el token sea correcto
  • Revisa si hay errores en el panel de Cloudflare Zero Trust
  • Prueba a ejecutar cloudflared tunnel run <TOKEN> directamente para ver los mensajes de error