Saltar al contenido

Solución de problemas

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

"spawn tmux ENOENT"

tmux no está instalado o no se encuentra en su PATH. Termbridge muestra este error, pero por ahora sigue ejecutándose sin servir una terminal (#4); pulse Ctrl+C, instale tmux y vuelva a iniciarlo.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

"spawn cloudflared ENOENT"

El cliente de túnel de Cloudflare no está instalado o no se encuentra en su PATH. Solo se necesita para el modo túnel; --no-tunnel y Daytona en modo directo no necesitan cloudflared.

Shell
# macOS
brew install cloudflared

Para Linux, descárguelo desde cloudflare.com/downloads.

El túnel no se inicia

Hay varias cosas que puede comprobar (omita esto si usa el modo de sandbox directo):

  1. Compruebe que cloudflared funcione: cloudflared --version
  2. Asegúrese de poder acceder a https://trycloudflare.com
  3. Compruebe si algún firewall bloquea las conexiones salientes

Si el túnel no se inicia, Termbridge muestra el error, detiene su servidor y se cierra con el estado 1. No cambia a un modo solo local, y el servidor solo escucha en 127.0.0.1 de forma predeterminada, así que otros dispositivos de su red tampoco pueden acceder a él. Las sesiones tmux creadas en esa ejecución siguen activas (#4).

Para usar Termbridge sin el túnel Cloudflare, ejecútelo con --no-tunnel --public-url <url> detrás de su propio proxy inverso o túnel.

«429 Too Many Requests» de trycloudflare

Cloudflare limita la frecuencia de los túneles sin cuenta. Si ve errores como 429 Too Many Requests, pruebe lo siguiente:

  1. Espere unos minutos y vuelva a intentarlo
  2. Compruebe que no haya procesos antiguos de cloudflared en ejecución
  3. Use un token de túnel con nombre (recomendado para uso frecuente)

Pantalla en blanco o «Unable to load terminals»

Esto suele significar que el navegador no tiene una cookie de sesión válida; por ejemplo, porque se abrió sin canjear un enlace para compartir o porque cambió el URL del túnel:

  1. Compruebe si el servidor local sigue en ejecución
  2. Busque errores de 401/403 en la consola del navegador
  3. Reinicie Termbridge para obtener un código nuevo de URL y QR

No aparece nada en la terminal

Es posible que la sesión tmux no esté en ejecución:

Shell
# Check if sessions exist
tmux ls

Si aparecen sesiones, pero la terminal está en blanco, pruebe lo siguiente:

  • Recargue la página
  • Compruebe que su shell sea compatible con TERM=xterm-256color

Se escanea el código QR, pero la página está en blanco

El código QR contiene un token de un solo uso. Funciona una sola vez y solo durante los 90 segundos posteriores al inicio de Termbridge. Si el enlace ya se usó o caducó, se devuelve invalid token.

Solución: reinicie Termbridge para generar un código QR nuevo y escanéelo enseguida.

Errores de node-pty relacionados con spawn-helper

Termbridge intenta solucionarlo automáticamente, pero si ve errores de permisos:

Shell
chmod +x node_modules/node-pty/prebuilds/**/spawn-helper

¿Sigue teniendo problemas?

Abra una incidencia en github.com/inline0/termbridge e incluya:

  • Su sistema operativo y la versión de Node.js
  • El mensaje de error
  • Los pasos para reproducirlo