Túneles

Un túnel es un enlace público a tu OpenChamber, para que puedas acceder a él desde un navegador corriente en otra red. Usa openchamber tunnel para crear uno para una instancia en marcha.

Conectar tus propios dispositivos (la app móvil, otro escritorio) normalmente no necesita un túnel: vincúlalos y deja que el Private Relay, cifrado de extremo a extremo, se encargue del acceso fuera de casa sin configuración.

Requisitos previos

OpenChamber inicia el CLI del proveedor de túnel en tu máquina. Instala primero el proveedor que quieras usar:

brew install cloudflared
brew install ngrok

Los túneles rápidos de Cloudflare pueden funcionar con cloudflared. Ngrok requiere una cuenta de ngrok y un authtoken del panel de ngrok:

ngrok config add-authtoken <your-ngrok-token>

Inicio rápido

1. Inicia OpenChamber:

openchamber

Si omites este paso, openchamber tunnel start puede iniciar automáticamente un servidor CLI. Al hacerlo, puedes pasar opciones del servidor como --port, --host, --lan, --ui-password y --api-only.

2. Inicia un túnel de Cloudflare:

openchamber tunnel start --provider cloudflare --mode quick

O inicia un túnel de Ngrok:

openchamber tunnel start --provider ngrok --mode quick

3. Comprueba el estado:

openchamber tunnel status

Cuando el túnel está activo, status muestra una URL pública. Ábrela, o escanea el código QR, para acceder a OpenChamber desde cualquier lugar.

Por defecto, OpenChamber imprime un código QR en sesiones TTY interactivas. Usa --qr para forzar la salida del QR, o --no-qr para desactivarla.

Proveedores

• cloudflare: modos quick, managed remote y managed local
• ngrok: modo quick

Modos gestionados

Gestionado remoto

Usa un token + nombre de host gestionados por Cloudflare:

openchamber tunnel start --provider cloudflare --mode managed-remote --token-file ~/.secrets/cf-token --hostname app.example.com

Gestionado local

Usa una configuración local de cloudflared:

openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml

Perfiles (managed-remote)

Guarda un perfil reutilizable:

openchamber tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token-file ~/.secrets/cf-token

Inicia usando el perfil guardado:

openchamber tunnel start --profile prod-main

Comandos útiles

openchamber tunnel providers
openchamber tunnel ready --provider cloudflare
openchamber tunnel ready --provider ngrok
openchamber tunnel doctor --provider cloudflare
openchamber tunnel doctor --provider ngrok
openchamber tunnel stop --port 3000

Notas de comportamiento

• un único túnel activo por instancia de OpenChamber (puerto)
• iniciar un nuevo modo/proveedor en la misma instancia reemplaza el túnel anterior
• generar un nuevo enlace de conexión revoca el anterior sin usar
• el autoarranque del túnel conserva flags del servidor como --ui-password y --api-only en los ajustes de instancia usados por reinicios y actualizaciones

Relacionado

• Conectar un dispositivo — vincula tus propios dispositivos sin una URL pública
• Seguridad — protege la interfaz antes de exponerla
• Túneles de escritorio — configuración de túneles en la app de escritorio sin iniciar desde CLI
• PWA y acceso móvil — accede a OpenChamber desde tu teléfono
• Resolución de problemas — si el enlace del túnel no funciona