# Solución de problemas

## "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](https://github.com/inline0/termbridge/issues/4)); pulse `Ctrl+C`, instale tmux y vuelva a iniciarlo.

```bash
# 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.

```bash
# macOS
brew install cloudflared
```

Para Linux, descárguelo desde [cloudflare.com/downloads](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/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](https://github.com/inline0/termbridge/issues/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:

```bash
# 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:

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

## ¿Sigue teniendo problemas?

Abra una incidencia en [github.com/inline0/termbridge](https://github.com/inline0/termbridge/issues) e incluya:
- Su sistema operativo y la versión de Node.js
- El mensaje de error
- Los pasos para reproducirlo