Envía tu terminal
Termbridge ejecuta un servidor local, crea un túnel mediante Cloudflare y transmite tu sesión de tmux a cualquier navegador.
npx termbridgeÚltima versión 0.3.13 MIT Node 20+, tmux, cloudflared
# Create a tmux session and start the agent
tmux new-session -d -s claude "claude"
# Then attach Termbridge to it
termbridge --session claudeEn la práctica
Inícialo en tu ordenador y luego abre el terminal en otro dispositivo.
Del portátil al teléfono
npx termbridge inicia un servidor local, una sesión de tmux y un túnel Cloudflare, y luego muestra un código QR con un enlace de inicio de sesión de un solo uso.
Al escanear el código, el token se canjea por una sesión de cookie. Añade --proxy 5173 para mostrar tu servidor de desarrollo en una vista Preview junto al terminal.
npx termbridge# Start your Vite app first
cd my-app && npm run dev # runs on port 5173
# Then start Termbridge with proxy
termbridge --proxy 5173Listo para móviles
Escanea el código QR y abre el terminal en el navegador de tu teléfono.
Terminal real
tmux + node-pty envían una PTY real a xterm.js con colores y TUI.
Túnel de Cloudflare
Quick Tunnel expone tu servidor local sin redirección de puertos.
Inicio de sesión con token
El enlace QR contiene un token de un solo uso válido durante 90 segundos. Al canjearlo, se establece una cookie de sesión HttpOnly y Secure, con comprobaciones CSRF y 5 canjes por minuto. Las sesiones no caducan.
Varias sesiones
Un servidor puede alojar varias sesiones de tmux, con cambio desde la aplicación.
Un solo comando
npx termbridge inicia el servidor, el túnel Cloudflare y el código QR. Requiere Node 20+, tmux y cloudflared en macOS o Linux; Windows no es compatible.
Primero CLI
Diseñado como herramienta centrada en el terminal, con estado TTY y salida QR.
Transferencia con QR
Cada ejecución muestra un código QR con un enlace de inicio de sesión de un solo uso. Escanéalo con el dispositivo que quieras usar.
Vista previa del servidor de desarrollo
Usa un proxy para tu aplicación local de Vite y previsualízala junto al terminal.
Paso de HMR
El proxy de WebSocket mantiene en funcionamiento Hot Module Replacement de Vite.
Cambio de vista
Cambia entre Terminal y Preview desde la hoja Views de la barra inferior.
Flujo de trabajo integral
Ejecuta comandos en el terminal y observa cómo se actualiza tu aplicación en tiempo real.
Por qué Termbridge
Sin redirección de puertos ni VPN
Un Quick Tunnel Cloudflare sin cuenta proporciona a tu servidor local un HTTPS URL público. El dispositivo desde el que te conectes solo necesita un navegador.
Funcionan los programas a pantalla completa
node-pty se conecta a tmux e indica un terminal de 256 colores, para que las TUI como htop y vim funcionen igual que en local.
Las sesiones siguen activas al cerrar el puente
Ctrl+C cierra el túnel y el servidor, pero deja las sesiones de tmux en ejecución. Reinicia con --session para conectarte a una sesión que ya tengas.
Se ejecuta en tu equipo
El servidor, el WebSocket y el registro de terminales se encuentran en tu ordenador y escuchan en 127.0.0.1 de forma predeterminada. Termbridge no opera ningún backend propio.
Comparación con
Otras formas de acceder a un terminal desde otro dispositivo y en qué se diferencia Termbridge.
| Herramienta | Ideal para | Diferencia con Termbridge |
|---|---|---|
| ttyd | Ideal parattyd comparte cualquier comando por la web, con entrada CJK e IME, transferencia de archivos mediante ZMODEM y trzsz, imágenes Sixel, SSL y autenticación básica; funciona en macOS, Linux, los BSD, OpenWrt y Windows. | Diferencia con TermbridgeTermbridge añade el túnel, un enlace de inicio de sesión QR de un solo uso y una barra de controles para el teléfono, y mantiene el shell en tmux para que sobreviva a un reinicio. Está diseñado para macOS y Linux. |
| sshx | Ideal parasshx comparte un terminal con cualquiera mediante un solo comando, en un lienzo infinito donde los colaboradores ven los cursores de los demás, con cifrado de extremo a extremo y binarios para Linux, macOS y Windows. | Diferencia con TermbridgeTermbridge permite acceder a tu propio terminal: cada ejecución genera un enlace de inicio de sesión que funciona una vez, y el tráfico pasa por un túnel Cloudflare hasta el servidor de tu equipo. |
| Tailscale SSH | Ideal paraTailscale SSH permite que Tailscale gestione la autenticación y autorización de las conexiones SSH en tu tailnet, cifradas mediante WireGuard con claves de nodo, desde cualquier dispositivo que ejecute Tailscale. | Diferencia con TermbridgeTermbridge no requiere un cliente ni una red privada en el otro dispositivo. Te proporciona un URL público y un código QR, y el terminal se abre en el navegador. |
Fuentes, marcado
Preguntas y respuestas
Respuestas breves de la documentación de Termbridge.
En el modo predeterminado, pasa por un Quick Tunnel Cloudflare antes de llegar al servidor Termbridge de tu ordenador. Termbridge no opera ningún backend propio. En el modo sandbox de Daytona, el terminal se ejecuta en un entorno aislado de tu cuenta Daytona; en el modo directo, el servidor también se ejecuta allí y te conectas mediante el enlace de vista previa Daytona.
El enlace QR contiene un token de un solo uso, válido durante 90 segundos. Al canjearlo, se establece una cookie de sesión HttpOnly; además, las conexiones WebSocket del terminal requieren un token CSRF. No compartas el código QR ni el URL con personas en las que no confíes.
Sí. Define TERMBRIDGE_SESSIONS=3 para iniciar tres sesiones de tmux y cambia entre ellas con el selector de terminal de la aplicación.
No oficialmente. Termbridge está diseñado para macOS y Linux. Puede que funcione con WSL, pero no se ha probado.
Todavía no. Cloudflare es el único proveedor de túneles. Puedes usar un túnel Cloudflare con nombre y tu propio nombre de host, desactivar el túnel y proporcionar tu propio URL público, o usar el modo directo de Daytona.
En el modo local, la conexión dura mientras Termbridge esté en ejecución y se cierra cuando el ordenador entra en suspensión o Termbridge se cierra. Tus sesiones de tmux siguen activas, así que puedes iniciar Termbridge de nuevo, escanear el nuevo código QR y conectarte con --session. En el modo directo de Daytona, el servidor se ejecuta dentro del entorno aislado.
Instala Node 20+, tmux y cloudflared, ejecuta npx termbridge y escanea el código QR para abrir el terminal en el navegador de tu teléfono.