Ir al contenido
Octoboard Documentación

Navegador a través de Tailscale

Abre Octoboard en un navegador de otro equipo a través de tu propia red de Tailscale, sin SSH ni escritorio remoto. El host es el equipo que ejecuta Octoboard: un Mac, un PC con Windows o un servidor Linux que ejecuta octoboardd. El inicio de sesión por SSH (Acceso remoto en macOS) puede seguir desactivado.

¿No estás seguro de que esta sea la mejor opción? Consulta Elige cómo conectarte.

Navegador en tu equipo → relé en tu equipo (127.0.0.1) ⟷ Tailscale ⟷ relé en el host (127.0.0.1) → Octoboard

¿Es la primera vez?
  • Tailscale: un servicio que une tus dispositivos en una red privada a través de internet, estén donde estén. Inicias sesión en él con tu propia cuenta.
  • Tailnet: tu red de Tailscale: los dispositivos que han iniciado sesión en tu cuenta de Tailscale.
  • 127.0.0.1 (loopback): una dirección que siempre significa «este mismo equipo».
  • Puerto: un número que elige un programa de un equipo, como el número de una puerta. 127.0.0.1:3369 es el puerto 3369 de este equipo.
  • socat: un programa pequeño y gratuito que pasa una conexión de un lugar a otro. Aquí es el relé.
  • Tailscale Serve: un comando de Tailscale que comparte un puerto solo con tu tailnet. Su pariente, Tailscale Funnel, lo compartiría con todo internet; nunca lo uses aquí.
  • Terminal: la ventana en la que escribes comandos: Terminal en macOS, PowerShell en Windows.

Por seguridad, Octoboard solo acepta un navegador que lo abra en 127.0.0.1, una dirección que siempre significa «este mismo equipo» (también llamada loopback). Por eso no basta con escribir en el navegador la dirección de Tailscale del host. En su lugar, ejecutas un pequeño programa de relé en cada equipo: en el tuyo hace que el host parezca local en 127.0.0.1; en el host entrega la conexión a Octoboard. Tailscale transporta el tráfico entre ambos.

  • Tailscale en ambos equipos, con la sesión iniciada en la misma tailnet. Usa una tailnet que contenga solo tus propios dispositivos: todo dispositivo al que permita llegar al host puede llegar al puerto que compartes.

  • socat en cada equipo que sea un Mac o ejecute Linux. Un equipo con Windows no lo necesita.

    Instala antes Homebrew si no lo tienes (macOS no incluye ninguna herramienta que pueda hacer este trabajo) y luego ejecuta esto en Terminal:

    Terminal window
    brew install socat
  • Dos o tres ventanas abiertas mientras trabajas: el relé y Tailscale Serve en el host (salvo el relé en Windows), y el relé en tu equipo (salvo en Windows).

  1. Obtén la dirección del navegador, que lleva la clave con la que el navegador inicia sesión.

    En Octoboard, abre Ajustes › Acceso remoto, activa Permitir acceso remoto y selecciona Permitir para confirmar. Debajo del interruptor aparecen dos pestañas. En la pestaña Navegador, selecciona Copiar dirección en Paso 2: dirección del navegador.

    Lleva la dirección al otro equipo de una forma que solo tú puedas leer, por ejemplo una nota para ti mismo: funciona como una contraseña.

    Omite Paso 1: reenvío SSH. Los ajustes de la app mencionan SSH en varios sitios; aquí puedes ignorarlo, porque esta guía solo usa la dirección del navegador.

    Mantén Octoboard en ejecución: si lo cierras, el acceso remoto se detiene.

  2. Inicia el relé en el host, que conecta un puerto del 127.0.0.1 del host con Octoboard. Este puerto es el puerto del host en los pasos siguientes.

    Ejecuta esto en Terminal y deja la ventana abierta. Escucha solo en 127.0.0.1:3370.

    Terminal window
    socat TCP-LISTEN:3370,bind=127.0.0.1,reuseaddr,fork UNIX-CONNECT:"$HOME/.octoboard/browser.sock"

    El puerto del host es 3370.

  3. Comparte el puerto del host con tu tailnet mediante Tailscale Serve y deja la ventana abierta. Nunca uses Tailscale Funnel, que lo pondría en internet público.

    Terminal window
    tailscale serve --tcp=3370 tcp://127.0.0.1:3370

    Con la app de Tailscale de la App Store, ejecuta el comando como /Applications/Tailscale.app/Contents/MacOS/Tailscale en lugar de tailscale. Con la app independiente, instala primero el comando desde sus ajustes, en CLI integration.

    Para comprobarlo, ejecuta tailscale serve status en otra ventana: debería mostrar el puerto del host.

  1. Busca el host en la app de Tailscale de este equipo y anota su nombre (como my-mac) o su dirección (un número como 100.x.y.z).

  2. Inicia el relé en este equipo, que hace que el host aparezca aquí en 127.0.0.1:3369. Si el puerto 3369 ya está ocupado en este equipo, elige otro puerto y cámbialo también en la dirección del navegador.

    En el comando siguiente, sustituye <host> por el nombre o la dirección del host, y <host port> por el puerto del host.

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:<host>:<host port>

    Por ejemplo, para un host Mac llamado my-mac:

    Terminal window
    socat TCP-LISTEN:3369,bind=127.0.0.1,reuseaddr,fork TCP:my-mac:3370

    Ejecútalo en Terminal y deja la ventana abierta.

  3. Abre la dirección del navegador que copiaste en el host. Empieza por http://127.0.0.1:3369/.

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

  • La página no carga: se cerró una de las ventanas o su comando se detuvo. Comprueba que los relés y Tailscale Serve siguen en marcha y que tailscale serve status en el host muestra el puerto del host.
  • socat dice «Address already in use»: ese puerto está ocupado en ese equipo. Elige otro puerto; en tu equipo, cámbialo también en la dirección del navegador.
  • La página se rechaza o aparece en blanco: comprueba que abriste la dirección en 127.0.0.1, no con el nombre de Tailscale del host ni con su dirección 100.x.y.z.
  • El relé del host muestra «Connection refused» o «No such file or directory» cuando abres la página: Permitir acceso remoto está desactivado, o Octoboard no se está ejecutando en el host (en Linux, octoboardd no se está ejecutando).
  • En el equipo desde el que navegaste: detén socat con Ctrl+C o, en Windows, elimina el reenvío en PowerShell ejecutado como administrador:

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • En el host: detén el comando de Tailscale Serve y socat con Ctrl+C. Comprueba con tailscale serve status que ya no se comparte nada; si el puerto sigue apareciendo, quítalo con tailscale serve --tcp=3370 off (en Windows, tailscale serve --tcp=3369 off).

  • En un host Mac o Windows, desactiva Permitir acceso remoto cuando ya no lo necesites. Esto cierra la entrada del navegador y desconecta todas las páginas abiertas con la clave.

  • Si la dirección puede haberse filtrado, dale una clave nueva con Renovar clave en la pestaña Navegador o, en Linux, con octoboardd address --rotate. Las páginas abiertas con la dirección anterior se desconectan.

  • La dirección es la contraseña: su clave da control total de Octoboard en el host, incluida la ejecución de cualquier comando. Dura hasta que la renuevas. Queda en el historial y los marcadores del navegador y se sincroniza con tus otros dispositivos si la sincronización del navegador está activada.
  • Quién puede acceder: cualquiera que llegue al puerto del host y tenga la clave. Los relés escuchan solo en 127.0.0.1, así que otros dispositivos de la red del host o de la tuya no pueden llegar a ellos; Tailscale Serve hace que el puerto del host sea accesible solo desde tu tailnet, dentro de lo que permitan sus reglas de acceso.
  • Solo en equipos en los que nadie más inicia sesión: otra cuenta de usuario del host o de tu equipo puede conectarse a estos puertos 127.0.0.1 y, mientras un relé no está en marcha, puede ocupar su puerto y recibir la clave cuando tu navegador se reconecte. Conectarse por SSH no tiene este punto débil en un host Mac o Linux, y tu propio equipo tampoco lo tiene si usas la app de escritorio. En un navegador, tu equipo sigue teniéndolo, porque allí el reenvío de SSH también escucha en un puerto 127.0.0.1.
  • Nunca Funnel: Tailscale Funnel publicaría el puerto en todo internet.