Saltar al contenido

Primeros pasos

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

Instalar los requisitos previos

Para la configuración predeterminada del túnel local, instala estas herramientas en el equipo:

Node.js 20+

Descárgalo desde nodejs.org o usa tu gestor de paquetes.

Shell
# Check if installed
node --version

tmux

El multiplexor de terminales que impulsa las sesiones de Termbridge.

Shell
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux

cloudflared

Crea el túnel seguro hasta tu terminal (no se necesita para el modo directo de sandbox).

Shell
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Descargar cloudflared

Ejecutar Termbridge

Shell
npx termbridge

Verás una salida como esta:

Código
┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘

Nota El trycloudflare.com URL es un túnel rápido que no requiere cuenta. Si usas Termbridge con frecuencia, configura un token de túnel con nombre de Cloudflare para evitar los límites de solicitudes.

Conectarse desde el teléfono

  1. Abre la cámara del teléfono
  2. Apúntala al código QR
  3. Toca el enlace que aparece
  4. La terminal se abrirá en el navegador

Eso es todo: ¡ya estás conectado!

¿Qué acaba de pasar?

  1. Termbridge inició un servidor local en tu equipo
  2. Creó una sesión de tmux para tu terminal
  3. Cloudflare creó un túnel seguro (el trycloudflare.com URL)
  4. El código QR contiene un token de un solo uso para acceder de forma segura. Funciona una vez y caduca 90 segundos después del inicio, así que escanéalo enseguida; si ha caducado, reinicia Termbridge para generar otro
  5. Al escanearlo, obtuviste una cookie de sesión y te conectaste

Pruébalo

Una vez conectado, prueba algunos comandos:

Shell
# See system info
htop

# Check a git repo
cd ~/your-project && git status

# Run any CLI tool

La terminal admite colores completos, TUI y todas las teclas habituales.

Mantenerlo en ejecución

Termbridge debe seguir ejecutándose para que funcione la conexión. Cuando termines:

  • Pulsa Ctrl+C en la terminal donde se está ejecutando Termbridge
  • El túnel se cierra y la conexión termina
  • La sesión de tmux sigue activa (salvo que hayas usado --kill-on-exit)

Comportamiento de la primera sesión

  • Termbridge crea una sesión de tmux (el nombre predeterminado se deriva del puerto)
  • La primera terminal de la lista se carga automáticamente
  • Puedes crear varias sesiones al iniciar si defines TERMBRIDGE_SESSIONS=2

Usar una sesión de tmux existente

Si pasas --session <name> y esa sesión ya existe, Termbridge se conectará a ella en lugar de crear una nueva. Esto resulta útil para supervisar procesos de larga duración que ya hayas iniciado.

Pasos siguientes

Controles móviles

Consejos para usar Termbridge en teléfonos y tabletas

Varias terminales

Ejecuta varias sesiones y alterna entre ellas

Vista previa del servidor de desarrollo

Previsualiza tu aplicación de Vite junto a la terminal

Referencia de CLI

Consulta todas las opciones y marcas disponibles