Aller au contenu
Octoboard Documentation

Navigateur via UU Remote

Ouvrez Octoboard dans un navigateur sur un autre ordinateur grâce au mappage de ports d’UU Remote, l’app de contrôle à distance de NetEase, sans SSH ni bureau à distance. L’hôte est l’ordinateur sur lequel fonctionne Octoboard ; la connexion SSH (Connexion à distance sur macOS) peut rester désactivée, et aucune session de bureau à distance n’est nécessaire. L’interface d’UU Remote est en chinois, donc ce guide donne ses libellés chinois à côté du français.

Ce guide ouvre Octoboard dans un navigateur sur votre propre ordinateur. C’est plus net et plus réactif que le bureau à distance, mais cela demande plus d’étapes. Si le décalage et le flou ne vous dérangent pas, utilisez simplement le bureau à distance d’UU Remote pour travailler directement sur l’hôte.

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

Navigateur sur votre ordinateur → 127.0.0.1 sur votre ordinateur ⟷ UU Remote ⟷ 127.0.0.1 sur l’hôte → Octoboard

Vous débutez ?
  • 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.
  • Mappage de ports (端口映射) : une fonction d’UU Remote qui fait apparaître un port de l’hôte comme un port de votre propre ordinateur.
  • socat : un petit programme gratuit qui fait passer une connexion d’un endroit à un autre. Un hôte Mac en a besoin comme relais.
  • Terminal : la fenêtre dans laquelle vous tapez des commandes : Terminal sur macOS, PowerShell sous Windows.

Le mappage de ports d’UU Remote fait apparaître Octoboard de l’hôte sur votre propre ordinateur à l’adresse 127.0.0.1, la seule adresse sur laquelle Octoboard accepte un navigateur.

  • Les deux ordinateurs sont des Mac ou des PC Windows. UU Remote n’a pas de mappage de ports pour Linux ; atteignez plutôt un serveur Linux par Tailscale ou SSH.
  • Les deux ont UU Remote installé et connecté au même compte, en version 4.21.0 ou ultérieure sous Windows et 4.32.0 ou ultérieure sous macOS. Le mappage de ports ne fonctionne que pour TCP, ce qui suffit à Octoboard. À la date de rédaction, UU Remote range le mappage de ports parmi ses fonctions gratuites ; consultez ses offres actuelles en cas de doute.
  • L’hôte apparaît sous Mes appareils (我的设备) dans UU Remote sur l’ordinateur depuis lequel vous naviguerez.
  • Un hôte Mac a aussi besoin de Homebrew, pour installer socat ci-dessous.
  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. Créez un port sur l’adresse 127.0.0.1 de l’hôte qui mène à Octoboard. Ce port est le port de l’hôte dans les étapes suivantes.

    Un Mac sert le navigateur d’une manière qu’UU Remote ne peut pas mapper, donc il faut socat comme relais. Installez-le dans Terminal :

    Terminal window
    brew install socat

    Exécutez ensuite ceci 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.

  1. Dans UU Remote, ouvrez l’hôte depuis Mes appareils (我的设备), choisissez Plus (更多) sur sa carte puis Mappage de ports (端口映射), et ajoutez un mappage :

    ChampValeur
    Nom (名称)Octoboard
    Port local (本地端口)3369
    Adresse cible (目标地址)127.0.0.1
    Port cible (目标端口)le port de l’hôte

    Enregistrez-le et activez-le, puis attendez qu’il s’affiche comme connecté. Si 3369 est pris sur cet ordinateur, choisissez un autre port local et modifiez-le aussi dans l’adresse du navigateur.

  2. Vérifiez que seul cet ordinateur peut utiliser le mappage. Ouvrez Terminal (macOS) ou PowerShell (Windows) sur cet ordinateur et exécutez :

    Terminal window
    lsof -nP -iTCP:3369 -sTCP:LISTEN

    Vous devriez voir une ligne contenant 127.0.0.1:3369 et LISTEN.

    Si vous voyez *:3369 ou 0.0.0.0:3369 à la place, supprimez le mappage : d’autres appareils de votre réseau pourraient atteindre Octoboard.

  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.

  • Le mappage s’affiche comme connecté, mais la page ne se charge pas : sur un hôte Mac, la fenêtre de socat a été fermée ou sa commande s’est arrêtée ; ou Autoriser l’accès à distance est désactivé, ou Octoboard ne fonctionne pas sur l’hôte.
  • Le mappage ne s’enregistre pas ou ne se connecte pas : le port local est peut-être pris sur cet ordinateur. Choisissez-en un autre, et 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.
  • Sur l’ordinateur depuis lequel vous naviguiez : désactivez le mappage dans le panneau de mappage de ports d’UU Remote, ou supprimez-le. Fermer le panneau ou se déconnecter l’arrête aussi.
  • Sur un hôte Mac : arrêtez socat avec Ctrl+C.
  • Sur l’hôte, 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. 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é. Sur l’hôte, il écoute uniquement sur 127.0.0.1 ; toute personne qui peut utiliser votre compte UU Remote pour mapper des ports vers l’hôte peut aussi l’atteindre, alors protégez bien ce compte.
  • 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 que le mappage ou socat ne tourne pas, il peut prendre le 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.