Aller au contenu
Octoboard Documentation

Navigateur via Tailscale

Ouvrez Octoboard dans un navigateur sur un autre ordinateur par votre propre réseau Tailscale, sans SSH ni bureau à distance. L’hôte est l’ordinateur sur lequel fonctionne Octoboard : un Mac, un PC Windows ou un serveur Linux où tourne octoboardd. La connexion SSH (Connexion à distance sur macOS) peut rester désactivée.

Vous ne savez pas si c’est la bonne voie pour vous ? Consultez Choisir comment se connecter.

Navigateur sur votre ordinateur → relais sur votre ordinateur (127.0.0.1) ⟷ Tailscale ⟷ relais sur l’hôte (127.0.0.1) → Octoboard

Vous débutez ?
  • Tailscale : un service qui relie vos appareils en un réseau privé par Internet, où qu’ils soient. Vous vous y connectez avec votre propre compte.
  • Tailnet : votre réseau Tailscale : les appareils connectés à votre compte Tailscale.
  • 127.0.0.1 (boucle locale) : une adresse qui signifie toujours « cet ordinateur-ci ».
  • Port : un nombre qui désigne un programme précis sur un ordinateur, comme un numéro de porte. 127.0.0.1:3369 est le port 3369 sur cet ordinateur.
  • socat : un petit programme gratuit qui fait passer une connexion d’un endroit à un autre. Ici, c’est le relais.
  • Tailscale Serve : une commande Tailscale qui partage un port avec votre tailnet uniquement. Sa cousine, Tailscale Funnel, le partagerait avec tout Internet ; ne l’utilisez jamais ici.
  • Terminal : la fenêtre dans laquelle vous tapez des commandes : Terminal sur macOS, PowerShell sous Windows.

Par sécurité, Octoboard n’accepte qu’un navigateur qui l’ouvre à l’adresse 127.0.0.1, une adresse qui signifie toujours « cet ordinateur-ci » (appelée aussi boucle locale). Vous ne pouvez donc pas simplement taper l’adresse Tailscale de l’hôte dans le navigateur. À la place, vous lancez un petit programme relais sur chaque ordinateur : sur le vôtre, il fait apparaître l’hôte comme local à l’adresse 127.0.0.1 ; sur l’hôte, il transmet la connexion à Octoboard. Tailscale transporte le trafic entre les deux.

  • Tailscale sur les deux ordinateurs, connectés au même tailnet. Utilisez un tailnet qui ne contient que vos propres appareils : chaque appareil qu’il autorise à atteindre l’hôte peut atteindre le port que vous partagez.

  • socat sur chaque ordinateur qui est un Mac ou qui tourne sous Linux. Un ordinateur Windows n’en a pas besoin.

    Installez d’abord Homebrew si vous ne l’avez pas (macOS ne fournit aucun outil capable de faire ce travail), puis exécutez ceci dans Terminal :

    Terminal window
    brew install socat
  • Deux ou trois fenêtres laissées ouvertes pendant que vous travaillez : le relais et Tailscale Serve sur l’hôte (sauf le relais sous Windows), et le relais sur votre ordinateur (sauf sous Windows).

  1. Obtenez l’adresse du navigateur, qui contient la clé qui connecte le navigateur.

    Dans Octoboard, ouvrez Réglages › Accès à distance, activez Autoriser l’accès à distance et sélectionnez Autoriser pour confirmer. Deux onglets apparaissent alors sous l’interrupteur. Dans l’onglet Navigateur, sélectionnez Copier l’adresse sous Étape 2 : adresse du navigateur.

    Transmettez l’adresse à l’autre ordinateur d’une façon que vous seul pouvez lire, par exemple une note envoyée à vous-même : elle fonctionne comme un mot de passe.

    Ignorez Étape 1 : redirection SSH. Les réglages de l’app mentionnent SSH à plusieurs endroits ; vous pouvez l’ignorer ici, puisque ce guide n’utilise que l’adresse du navigateur.

    Laissez Octoboard en marche : si vous le quittez, l’accès à distance s’arrête.

  2. Démarrez le relais sur l’hôte, qui relie un port de l’adresse 127.0.0.1 de l’hôte à Octoboard. Ce port est le port de l’hôte dans les étapes suivantes.

    Exécutez ceci dans Terminal et laissez la fenêtre ouverte. Il écoute uniquement sur 127.0.0.1:3370.

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

    Le port de l’hôte est 3370.

  3. Partagez le port de l’hôte avec votre tailnet grâce à Tailscale Serve, et laissez la fenêtre ouverte. N’utilisez jamais Tailscale Funnel, qui l’exposerait sur Internet.

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

    Avec l’app Tailscale de l’App Store, exécutez la commande avec /Applications/Tailscale.app/Contents/MacOS/Tailscale à la place de tailscale. Avec l’app autonome, installez d’abord la commande depuis ses réglages, sous CLI integration.

    Pour vérifier, exécutez tailscale serve status dans une autre fenêtre : il doit lister le port de l’hôte.

  1. Trouvez l’hôte dans l’app Tailscale sur cet ordinateur, et notez son nom (comme my-mac) ou son adresse (un nombre du genre 100.x.y.z).

  2. Démarrez le relais sur cet ordinateur, qui fait apparaître l’hôte à l’adresse 127.0.0.1:3369 ici. Si le port 3369 est déjà pris sur cet ordinateur, choisissez-en un autre et modifiez-le aussi dans l’adresse du navigateur.

    Dans la commande ci-dessous, remplacez <host> par le nom ou l’adresse de l’hôte, et <host port> par le port de l’hôte.

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

    Par exemple, pour un hôte Mac nommé my-mac :

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

    Exécutez-la dans Terminal et laissez la fenêtre ouverte.

  3. Ouvrez l’adresse du navigateur que vous avez copiée sur l’hôte. Elle commence par http://127.0.0.1:3369/.

Vous saurez que ça a marché quand Octoboard s’ouvre dans l’onglet du navigateur sans vous demander de vous connecter.

  • La page ne se charge pas : l’une des fenêtres a été fermée, ou sa commande s’est arrêtée. Vérifiez que les relais et Tailscale Serve fonctionnent toujours, et que tailscale serve status sur l’hôte liste le port de l’hôte.
  • socat indique « Address already in use » : ce port est pris sur cet ordinateur. Choisissez-en un autre ; sur votre ordinateur, modifiez-le aussi dans l’adresse du navigateur.
  • La page est refusée ou vide : vérifiez que vous avez ouvert l’adresse à 127.0.0.1, et non le nom Tailscale de l’hôte ou son adresse 100.x.y.z.
  • Le relais sur l’hôte affiche « Connection refused » ou « No such file or directory » quand vous ouvrez la page : Autoriser l’accès à distance est désactivé, ou Octoboard ne fonctionne pas sur l’hôte (sous Linux, octoboardd ne tourne pas).
  • Sur l’ordinateur depuis lequel vous naviguiez : arrêtez socat avec Ctrl+C, ou, sous Windows, supprimez la redirection dans PowerShell lancé en tant qu’administrateur :

    Terminal window
    netsh interface portproxy delete v4tov4 listenaddress=127.0.0.1 listenport=3369
  • Sur l’hôte : arrêtez la commande Tailscale Serve et socat avec Ctrl+C. Vérifiez avec tailscale serve status que plus rien n’est partagé ; si le port est encore listé, retirez-le avec tailscale serve --tcp=3370 off (sous Windows, tailscale serve --tcp=3369 off).

  • Sur un hôte Mac ou Windows, désactivez Autoriser l’accès à distance quand vous n’en avez plus besoin. Cela ferme l’entrée du navigateur et déconnecte toutes les pages ouvertes avec la clé.

  • Si l’adresse a pu fuiter, donnez-lui une nouvelle clé avec Renouveler la clé dans l’onglet Navigateur, ou, sous Linux, avec octoboardd address --rotate. Les pages ouvertes avec l’ancienne adresse sont déconnectées.

  • L’adresse est le mot de passe : sa clé donne un contrôle total de Octoboard sur l’hôte, y compris l’exécution de n’importe quelle commande. Elle dure jusqu’à ce que vous la renouveliez. Elle reste dans l’historique et les favoris du navigateur, et se synchronise avec vos autres appareils si la synchronisation du navigateur est activée.
  • Qui peut l’atteindre : toute personne qui atteint le port de l’hôte et possède la clé. Les relais écoutent uniquement sur 127.0.0.1, donc les autres appareils du réseau local de l’hôte ou du vôtre ne peuvent pas les atteindre ; Tailscale Serve rend le port de l’hôte accessible depuis votre tailnet uniquement, dans la limite de ses règles d’accès.
  • Uniquement sur des ordinateurs auxquels personne d’autre ne se connecte : un autre compte utilisateur sur l’hôte ou sur votre ordinateur peut se connecter à ces ports 127.0.0.1, et tant qu’un relais ne tourne pas, il peut prendre son port et recevoir la clé quand votre navigateur se reconnecte. La méthode Se connecter via SSH n’a pas cette faiblesse sur un hôte Mac ou Linux, et votre propre ordinateur ne l’a pas non plus quand vous utilisez l’app de bureau. Dans un navigateur, votre ordinateur l’a toujours, car la redirection SSH y écoute aussi sur un port 127.0.0.1.
  • Jamais Funnel : Tailscale Funnel publierait le port sur tout Internet.