Saltearse al contenido
OpenChamber

Instancias remotas

La app de escritorio puede conectarse a OpenChamber ejecutándose en otra máquina por SSH —un servidor de trabajo, una máquina en la nube, un homelab— y traer su UI a tu pantalla como si fuera local. Configúralo en Settings → Remote Instances.

Las instancias remotas son una función solo de escritorio. En la web o en VS Code, conéctate a un servidor remoto con las variables de entorno de OpenCode Server en su lugar.

Añade una instancia remota

  1. Abre Settings → Remote Instances y añade una.
  2. Dale el comando SSH que usarías normalmente para alcanzar la máquina, más un apodo.
  3. Elige cómo se ejecuta OpenChamber allí:
    • managed — OpenChamber se instala y se inicia por sí mismo en la máquina remota
    • external — conéctate a una que ya está en funcionamiento
  4. Conecta.

OpenChamber recorre los pasos —comprobar la conexión, configurar el remoto, iniciar el servidor y reenviar el puerto— y muestra en qué punto está en cada etapa. Cuando llega a ready, la UI remota se carga localmente.

Credenciales

Tú decides si guardar las contraseñas de SSH y de UI o introducirlas cada vez. Si la conexión se cae, OpenChamber informa qué paso falló para que puedas arreglarlo; consulta Acceso remoto.

Enlaces de conexión

Si una máquina remota ya ejecuta OpenChamber, la forma más fácil de conectar la app de escritorio es un enlace de vinculación. En la UI del servidor remoto, abre Settings → Remote Instances → Conectarse a este servidor → Añadir un dispositivo, crea un enlace e impórtalo en tu escritorio en Settings → Remote Instances → Otros servidores de OpenChamber → Importar enlace. Consulta Conectar un dispositivo para el flujo completo.

Un enlace creado con En cualquier lugar lleva tanto una dirección directa como una ruta por el Private Relay: el escritorio se conecta directamente cuando puede alcanzar el servidor (misma red) y recurre al relay cifrado de extremo a extremo cuando estás fuera. El estado junto a cada servidor guardado muestra qué ruta se está usando.

También puedes crear un enlace desde una terminal en la máquina remota:

Ventana de terminal
openchamber connect-url --port 3000 --server http://your-host:3000 --qr

connect-url inicia el servidor primero si no hay nada ejecutándose en ese puerto. Añade --api-only para un servidor headless, --lan para escuchar en la LAN al iniciar, --ui-password para proteger el acceso del navegador y --name para etiquetar la conexión guardada. Añade --relay para un enlace que también funciona fuera de la red local: el dispositivo prefiere la conexión directa cuando el servidor está accesible y recurre al Private Relay en caso contrario; la instancia levanta el relay por sí sola.

El enlace generado contiene un secreto de vinculación de un solo uso. Una vez importado, el dispositivo conserva su propio token de cliente —independiente de la contraseña de la UI del navegador— que sobrevive a los reinicios del servidor hasta que lo revoques en el servidor emisor.

Relacionado