Ir al contenido
Octoboard Documentación

Conectarse por SSH

Usa Octoboard en un servidor Linux o en otro equipo desde este, en la app de escritorio o en un navegador, por SSH: una conexión cifrada directa a esa máquina, sin relé ni servicio en la nube.

¿No estás seguro de que esta sea la mejor opción? Elige cómo conectarte la compara con las formas que solo usan el navegador y no necesitan SSH.

App de escritorio en este equipo · Navegador mediante un reenvío SSH ⟷ SSH ⟷ Servidor Linux u otro equipo

¿Es la primera vez?
  • Host: la máquina en la que se ejecuta Octoboard y a la que quieres acceder: un servidor Linux u otro Mac o PC con Windows.
  • Servidor: aquí, una máquina Linux en la que inicias sesión por la red, normalmente una que alquilas, sin pantalla propia.
  • SSH: una forma estándar y cifrada de iniciar sesión en otra máquina y escribir comandos en ella. Viene incluida en macOS, Windows y Linux.
  • Terminal: la ventana en la que escribes comandos: Terminal en macOS, PowerShell en Windows.
  • Reenvío SSH: un comando SSH que hace que algo del host aparezca en tu propio equipo, para que tu navegador pueda abrirlo allí.
  • Huella (clave de host): un código corto que identifica el SSH de una máquina. Comprobarlo una vez te dice que has llegado a la máquina correcta.
  • Archivo de clave: un archivo que te permite iniciar sesión en lugar de una contraseña. Algunos proveedores de servidores te dan uno.
  • Una forma de iniciar sesión en el host por SSH. En un servidor Linux, su proveedor te da la dirección y tu nombre de usuario. Para comprobar que funciona, abre Terminal (macOS) o PowerShell (Windows) y ejecuta el comando siguiente con tu nombre de usuario y la dirección del servidor. La primera vez, responde yes cuando pregunte si confías en el servidor.

    Terminal window
    ssh <you>@<server>

    Si el host es un Mac o un PC con Windows, activas el inicio de sesión por SSH en los ajustes del sistema; Usar otro equipo como host explica cómo.

  • Para un servidor Linux, Octoboard instalado e iniciado en él. Instalación › Servidor Linux explica cómo. El programa de servidor de Octoboard, octoboardd, es lo que la app llama el servicio.

  • La app de Octoboard en este equipo, para macOS o Windows, salvo que uses solo un navegador.

  1. Inicia sesión en el servidor por SSH como el usuario que ejecuta Octoboard, ejecuta este comando y copia la línea que empieza por octoboard+ssh://: los datos de conexión, que le dicen a la app dónde y cómo conectarse.

    Terminal window
    octoboardd connection

    Si este equipo accede al servidor con otra dirección u otro puerto SSH, añade --host o --ssh-port al comando para que muestre los datos de conexión correctos.

    El código QR que también muestra contiene la misma línea. Todavía ninguna app lo escanea.

  2. En la app de Octoboard de este equipo, abre Dispositivos remotos desde la barra lateral izquierda o, en macOS, elige Remoto › Dispositivos remotos en la barra de menús. En Windows, también puedes elegir Dispositivos remotos en el menú del sistema de la ventana o en la lista de accesos directos del icono de la barra de tareas.

  3. Selecciona Añadir servicio remoto y luego Pegar en Datos de conexión para rellenar los campos.

  4. En Autenticación, elige Contraseña si inicias sesión con la contraseña de tu cuenta. Elige Archivo de clave si tu proveedor del servidor te dio un archivo de clave (a menudo con un nombre como id_ed25519 o que termina en .pem), e indica dónde está en este equipo.

  5. Selecciona Guardar y luego Conectar. Introduce tu contraseña si la pide.

    Si pegaste los datos de conexión, la identidad del servidor (su huella) venía incluida y la app la comprueba por ti. Si escribiste la dirección a mano, la app muestra una huella la primera vez. Para asegurarte de que has llegado a la máquina correcta, compárala con la que muestra este comando en el servidor y conéctate solo si coinciden:

    Terminal window
    ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

Sabrás que ha funcionado cuando se abra una ventana de Octoboard aparte con los proyectos y las sesiones del servidor.

También puedes acceder a un Mac o a un PC con Windows que ejecute la app de Octoboard.

  1. En el equipo al que quieres acceder, abre Ajustes › Acceso remoto en Octoboard.
  2. Selecciona allí Abrir Ajustes del Sistema (macOS) o Abrir Configuración (Windows) y activa Acceso remoto (macOS) u OpenSSH Server (Windows), siguiendo la ruta que indica la fila, para que este equipo acepte inicios de sesión por SSH. Esto requiere un administrador. De vuelta en Octoboard, la fila mostrará Activado.
  3. Activa Permitir acceso remoto, selecciona Permitir para confirmar y mantén Octoboard en ejecución: si lo cierras, el acceso remoto se detiene.
  4. En la pestaña App de Octoboard, selecciona Copiar datos de conexión y envíalos al otro equipo, por ejemplo por correo o por chat.
  5. En el equipo desde el que vas a trabajar, añade el host como en los pasos 2 a 5 de Conectar con un servidor Linux, pegando los datos que enviaste. Inicia sesión con tu nombre de usuario y tu contraseña en el host.

Sabrás que ha funcionado cuando se abra una ventana aparte con los proyectos y las sesiones del host.

  1. Obtén el comando de reenvío SSH:

    • En un host Mac o Windows, haz primero los pasos 1 a 3 de Usar otro equipo como host. Después, en la pestaña Navegador, mira Paso 1: reenvío SSH. Haz clic en la dirección del comando para elegir cómo accede tu otro equipo a este (o elige Introducir la dirección manualmente y sustituye <server> después), y luego selecciona Copiar comando de reenvío. Selecciona también Copiar dirección en Paso 2: dirección del navegador.

    • En un servidor Linux, ejecuta esto en el servidor. Muestra la dirección del navegador y después el comando SSH que debes ejecutar.

      Terminal window
      octoboardd address

      Sustituye <server> en el comando por la dirección del servidor.

  2. En el equipo desde el que vas a navegar, ejecuta el comando SSH en Terminal (macOS) o PowerShell (Windows). Puede que la ventana pida tu contraseña y después no muestra nada más; es normal. Déjala abierta mientras trabajas: si la cierras, el navegador se desconecta.

  3. Abre en tu navegador la dirección del navegador, que empieza por http://127.0.0.1:.

Sabrás que ha funcionado cuando Octoboard se abra en la pestaña del navegador sin pedirte que inicies sesión.

Solo quien pueda acceder a Octoboard a través del reenvío SSH puede usar esta dirección. Mantenla privada: su clave da control total, y queda en el historial y los marcadores del navegador y se sincroniza con tus otros dispositivos si la sincronización del navegador está activada.

  • «No se pudo llegar al servidor», o el comando SSH dice «Connection refused» o agota el tiempo de espera: el inicio de sesión por SSH está desactivado en el host, o la dirección o el puerto SSH son incorrectos. Comprueba que Acceso remoto u OpenSSH Server esté activado y que puedes iniciar sesión con el comando ssh de arriba.
  • «No se pudo iniciar sesión», o «Permission denied»: el nombre de usuario, la contraseña o el archivo de clave son incorrectos.
  • «La clave de host no coincide»: la máquina que responde no es la misma a la que te conectaste antes. Esto ocurre cuando se reinstala un servidor, pero también puede significar que algo va mal. No continúes hasta saber por qué.
  • La página del navegador no carga: se cerró la ventana de SSH o su comando se detuvo. Ejecútalo de nuevo y recarga la página.
  • Sin puertos públicos adicionales: Octoboard solo acepta conexiones del propio host, así que para conectarte desde otro equipo primero debes iniciar sesión en el host por SSH. Por eso necesitas SSH o uno de los relés.
  • Comprueba a qué máquina accedes: la app recuerda la clave de host, la identidad SSH de la máquina, en la primera conexión correcta y bloquea la conexión con una alerta si esa identidad cambia más tarde.
  • Sin contraseña guardada: después de que inicies sesión por primera vez con una contraseña o con tu propio archivo de clave, la app crea una clave SSH independiente para que este equipo la use en los inicios de sesión posteriores.
  • Quitar el acceso a un equipo: elimina la entrada de ese equipo de la lista de claves SSH permitidas del host (~/.ssh/authorized_keys en Linux y macOS). Esa clave ya no podrá iniciar sesión; una conexión que ya esté abierta seguirá hasta que termine.
  • Una ventana por destino SSH: las conexiones con otro nombre de usuario, host o puerto SSH abren cada una su propia ventana, así que sus proyectos, sesiones y notificaciones nunca se mezclan.
  • Consulta el estado de cada conexión: abre el icono de la barra de menús de la app en macOS o su icono del área de notificación en Windows para ver una pestaña por cada conexión.
  • Abre aquí los sitios web remotos: cuando un agente inicia un sitio web en el host, haz clic en el enlace localhost que da, y la app abre ese sitio web en este equipo a través de SSH.
  • Abre aquí los archivos remotos: consulta un archivo en la ventana remota o descarga una copia para abrirla con la app predeterminada de este equipo para ese tipo de archivo.
  • Reconexión automática: si se cae la red, la ventana sigue intentando reconectarse hasta que lo consigue o la cierras.