Aller au contenu
Octoboard Documentation

Se connecter via SSH

Utilisez Octoboard sur un serveur Linux ou un autre ordinateur depuis cet ordinateur, dans l’app de bureau ou un navigateur, par SSH : une connexion chiffrée directe vers cette machine, sans relais ni service cloud.

Vous ne savez pas si c’est la bonne voie pour vous ? Choisir comment se connecter la compare aux voies réservées au navigateur qui n’ont pas besoin de SSH.

App de bureau sur cet ordinateur · Navigateur via une redirection SSH ⟷ SSH ⟷ Serveur Linux ou autre ordinateur

Vous débutez ?
  • Hôte : la machine sur laquelle Octoboard fonctionne et que vous voulez atteindre, un serveur Linux ou un autre Mac ou PC Windows.
  • Serveur : ici, une machine Linux à laquelle vous vous connectez par le réseau, en général une machine que vous louez, sans écran propre.
  • SSH : une façon standard et chiffrée de se connecter à une autre machine et d’y taper des commandes. Il est intégré à macOS, Windows et Linux.
  • Terminal : la fenêtre dans laquelle vous tapez des commandes : Terminal sur macOS, PowerShell sous Windows.
  • Redirection SSH : une commande SSH qui fait apparaître sur votre propre ordinateur quelque chose qui se trouve sur l’hôte, pour que votre navigateur puisse l’y ouvrir.
  • Empreinte (clé d’hôte) : un court code qui identifie le SSH d’une machine. La vérifier une fois vous confirme que vous avez atteint la bonne machine.
  • Fichier de clé : un fichier qui vous connecte à la place d’un mot de passe. Certains fournisseurs de serveurs vous en donnent un.
  • Un moyen de vous connecter à l’hôte en SSH. Pour un serveur Linux, son fournisseur vous donne l’adresse et votre nom d’utilisateur. Pour vérifier que ça marche, ouvrez Terminal (macOS) ou PowerShell (Windows) et exécutez la commande ci-dessous avec votre nom d’utilisateur et l’adresse du serveur. La première fois, répondez yes quand on vous demande si vous faites confiance au serveur.

    Terminal window
    ssh <you>@<server>

    Si l’hôte est un Mac ou un PC Windows, vous activez la connexion SSH dans ses réglages système ; Utiliser un autre ordinateur comme hôte montre comment faire.

  • Pour un serveur Linux, Octoboard installé et démarré dessus. Installation › Serveur Linux montre comment faire. Le programme serveur de Octoboard, octoboardd, est ce que l’app appelle le service.

  • L’app Octoboard sur cet ordinateur, pour macOS ou Windows, sauf si vous n’utilisez qu’un navigateur.

  1. Connectez-vous au serveur en SSH avec l’utilisateur qui exécute Octoboard, exécutez cette commande et copiez la ligne qui commence par octoboard+ssh:// : les informations de connexion, qui indiquent à l’app où et comment se connecter.

    Terminal window
    octoboardd connection

    Si cet ordinateur atteint le serveur à une autre adresse ou sur un autre port SSH, ajoutez --host ou --ssh-port à la commande pour qu’elle affiche les bonnes informations de connexion.

    Le code QR qu’elle affiche aussi contient la même ligne. Aucune app ne le lit encore.

  2. Dans l’app Octoboard sur cet ordinateur, ouvrez Appareils distants depuis la barre latérale de gauche ou, sur macOS, choisissez À distance › Appareils distants dans la barre des menus. Sous Windows, vous pouvez aussi choisir Appareils distants dans le menu système de la fenêtre ou dans la liste de raccourcis de l’icône de la barre des tâches.

  3. Sélectionnez Ajouter un service distant, puis Coller sous Informations de connexion pour remplir les champs.

  4. Sous Authentification, choisissez Mot de passe si vous vous connectez avec le mot de passe de votre compte. Choisissez Fichier de clé si votre fournisseur de serveur vous a donné un fichier de clé à la place (souvent nommé comme id_ed25519 ou se terminant par .pem), et indiquez où il se trouve sur cet ordinateur.

  5. Sélectionnez Enregistrer, puis Se connecter. Saisissez votre mot de passe s’il vous est demandé.

    Si vous avez collé les informations de connexion, l’identité du serveur (son empreinte) est venue avec elles, et l’app la vérifie pour vous. Si vous avez saisi l’adresse à la main, l’app affiche une empreinte la première fois. Pour être sûr d’avoir atteint la bonne machine, comparez-la à celle qu’affiche cette commande sur le serveur, et ne vous connectez que si elles correspondent :

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

Vous saurez que ça a marché quand une fenêtre Octoboard distincte s’ouvre, avec les projets et les sessions du serveur.

Vous pouvez aussi atteindre un Mac ou un PC Windows sur lequel fonctionne l’app Octoboard.

  1. Sur l’ordinateur que vous voulez atteindre, ouvrez Réglages › Accès à distance dans Octoboard.
  2. Sélectionnez-y Ouvrir Réglages Système (macOS) ou Ouvrir Paramètres (Windows), et activez Connexion à distance (macOS) ou OpenSSH Server (Windows), en suivant le chemin que donne la ligne, pour que cet ordinateur accepte les connexions SSH. Cela demande un administrateur. De retour dans Octoboard, la ligne affiche alors Activée.
  3. Activez Autoriser l’accès à distance, sélectionnez Autoriser pour confirmer, et laissez Octoboard en marche : si vous le quittez, l’accès à distance s’arrête.
  4. Dans l’onglet App Octoboard, sélectionnez Copier les informations de connexion, et envoyez-les à l’autre ordinateur, par exemple par e-mail ou par messagerie.
  5. Sur l’ordinateur depuis lequel vous travaillerez, ajoutez l’hôte comme aux étapes 2 à 5 de Se connecter à un serveur Linux, en collant les informations que vous avez envoyées. Connectez-vous avec votre nom d’utilisateur et votre mot de passe sur l’hôte.

Vous saurez que ça a marché quand une fenêtre distincte s’ouvre avec les projets et les sessions de l’hôte.

  1. Obtenez la commande de redirection SSH :

    • Sur un hôte Mac ou Windows, faites d’abord les étapes 1 à 3 de Utiliser un autre ordinateur comme hôte. Puis, dans l’onglet Navigateur, regardez Étape 1 : redirection SSH. Cliquez sur l’adresse dans la commande pour choisir comment votre autre ordinateur atteint celui-ci (ou choisissez Saisir l’adresse soi-même et remplacez <server> plus tard), puis sélectionnez Copier la commande de redirection. Sélectionnez aussi Copier l’adresse sous Étape 2 : adresse du navigateur.

    • Sur un serveur Linux, exécutez ceci sur le serveur. Il affiche l’adresse du navigateur, puis la commande SSH à exécuter.

      Terminal window
      octoboardd address

      Remplacez <server> dans la commande par l’adresse du serveur.

  2. Sur l’ordinateur depuis lequel vous naviguerez, exécutez la commande SSH dans Terminal (macOS) ou PowerShell (Windows). La fenêtre peut vous demander votre mot de passe, puis n’affiche plus rien : c’est normal. Laissez-la ouverte pendant que vous travaillez : la fermer déconnecte le navigateur.

  3. Ouvrez dans votre navigateur l’adresse du navigateur, qui commence par http://127.0.0.1:.

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

Seule une personne qui peut atteindre Octoboard par la redirection SSH peut utiliser cette adresse. Gardez-la privée : sa clé donne un contrôle total, et 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.

  • « Impossible de joindre le serveur », ou la commande SSH indique « Connection refused » ou expire : la connexion SSH est désactivée sur l’hôte, ou l’adresse ou le port SSH est incorrect. Vérifiez que Connexion à distance ou OpenSSH Server est activé, et que vous pouvez vous connecter avec la commande ssh ci-dessus.
  • « Connexion impossible », ou « Permission denied » : le nom d’utilisateur, le mot de passe ou le fichier de clé est incorrect.
  • « La clé d’hôte ne correspond pas » : la machine qui répond n’est pas celle à laquelle vous vous étiez connecté auparavant. Cela arrive après la réinstallation d’un serveur, mais cela peut aussi signaler un problème. Ne continuez pas avant de savoir pourquoi.
  • La page du navigateur ne se charge pas : la fenêtre SSH a été fermée, ou sa commande s’est arrêtée. Exécutez-la de nouveau et rechargez la page.
  • Aucun port public supplémentaire : Octoboard n’accepte que les connexions venant de l’hôte lui-même, donc pour vous connecter depuis un autre ordinateur, vous devez d’abord vous connecter à l’hôte en SSH. C’est pourquoi il faut SSH, ou l’un des relais.
  • Vérifiez quelle machine vous atteignez : l’app mémorise la clé d’hôte, l’identité SSH de la machine, lors de la première connexion réussie et bloque la connexion avec une alerte si cette identité change par la suite.
  • Aucun mot de passe enregistré : après votre première connexion avec un mot de passe ou votre propre fichier de clé, l’app crée une clé SSH distincte que cet ordinateur utilisera pour les connexions suivantes.
  • Retirer l’accès d’un ordinateur : supprimez l’entrée de cet ordinateur de la liste des clés SSH autorisées de l’hôte (~/.ssh/authorized_keys sous Linux et macOS). Cette clé ne pourra plus se connecter ; une connexion déjà ouverte reste active jusqu’à sa fin.
  • Une fenêtre par destination SSH : les connexions avec un nom d’utilisateur, un hôte ou un port SSH différent ouvrent chacune leur propre fenêtre, de sorte que leurs projets, sessions et notifications ne se mélangent jamais.
  • Voir l’état de chaque connexion : ouvrez l’icône de l’app dans la barre des menus sur macOS ou dans la zone de notification sous Windows pour voir un onglet par connexion.
  • Ouvrir ici les sites web distants : quand un agent démarre un site web sur l’hôte, cliquez sur le lien localhost qu’il donne, et l’app ouvre ce site web sur cet ordinateur par SSH.
  • Ouvrir ici les fichiers distants : affichez un fichier dans la fenêtre distante ou téléchargez-en une copie pour l’ouvrir dans l’app par défaut de cet ordinateur pour ce type de fichier.
  • Se reconnecter automatiquement : si le réseau tombe, la fenêtre continue d’essayer de se reconnecter jusqu’à y parvenir ou jusqu’à ce que vous la fermiez.