Aller au contenu
Localtonet Localtonet Tableau de bord

Terminal d'appareil

Gratuit Desktop v8.6+ Windows, Linux et macOS

Aide pour cette page
Sur cette page 13 sections
  1. Fonctionnement
  2. Avant de commencer
  3. Ajouter un appareil
  4. Ouvrir Ajouter un appareil
  5. Choisir le jeton
  6. Exécuter la commande sur l'ordinateur
  7. Saisir le code et approuver
  8. Sans personne devant l'ordinateur
  9. Options de la commande
  10. La liste des appareils
  11. Ouvrir un terminal dans le navigateur
  12. Sélectionner Terminal
  13. Saisir votre code d'authentification
  14. Se connecter avec ssh
  15. Clés SSH
  16. Avec le client Localtonet
  17. Clés d'accès pour les scripts et les agents IA
  18. Elio
  19. Historique des connexions
  20. Renommer, retirer ou désactiver un appareil
  21. Notes de sécurité
  22. Dépannage
  23. Pages associées

Mes appareils liste vos ordinateurs avec leur utilisation du CPU, de la mémoire et du disque, et ouvre un véritable shell sur chacun d'eux depuis votre navigateur. Vous l'activez avec une seule commande sur la machine ; rien sur l'ordinateur n'a besoin d'écouter sur un port public.

Fonctionnement #

Vous exécutez localtonet --terminal enable sur la machine et vous approuvez dans votre tableau de bord le court code qu'elle affiche. Ensuite, un bouton Terminal ouvre un shell sur cette machine dans un onglet du navigateur. Ce même shell est accessible depuis n'importe quel terminal avec une commande ssh que le tableau de bord affiche.

  • L'appareil n'établit que des connexions sortantes. Il n'y a aucun port entrant à ouvrir et aucun serveur SSH à installer.
  • L'ouverture d'un shell depuis le navigateur exige à chaque fois un nouveau code de votre application d'authentification.
  • Seule la commande locale peut activer le terminal. Il est impossible de l'activer depuis le tableau de bord.

Avant de commencer #

  • Localtonet sur la machine. Version minimale de l'application Localtonet requise pour utiliser cette fonctionnalité : Desktop v8.6. Téléchargez-la depuis la page Téléchargements.
  • Un AuthToken pour cette machine. Donnez à chaque ordinateur son propre jeton : utiliser un même jeton sur un second ordinateur déconnecte le premier. Le terminal fonctionne avec les jetons de votre compte personnel, pas avec les jetons d'équipe. Voir AuthTokens.
  • Authentification à deux facteurs. L'ouverture d'un shell nécessite une application d'authentification sur votre compte. Si elle n'est pas encore configurée, Mes appareils affiche Activer l'authentification à deux facteurs. Voir Compte et sécurité.

Mes appareils se trouve dans le menu de votre tableau de bord personnel. Cette page n'apparaît pas lorsqu'une équipe est sélectionnée.

Ajouter un appareil #

  1. Ouvrir Ajouter un appareil #

    Ouvrez Mes appareils et sélectionnez Ajouter un appareil.

  2. Choisir le jeton #

    Choisissez un jeton existant, ou sélectionnez Générer un nouveau jeton pour en créer un et l'intégrer à la commande. Si Localtonet s'exécute déjà sur cet ordinateur, choisissez son jeton. La liste signale les jetons en ligne ou déjà utilisés sur un autre appareil. Un jeton actuellement connecté affiche un avertissement : ne l'utilisez que si Localtonet s'exécute sur ce même ordinateur.

  3. Exécuter la commande sur l'ordinateur #

    Copiez la commande depuis la boîte de dialogue et exécutez-la dans un terminal sur l'ordinateur que vous voulez ajouter. Si Localtonet s'y exécute comme un service, utilisez un terminal administrateur ou sudo.

    Sur l'ordinateur
    localtonet --terminal enable --authtoken <YOUR_TOKEN>

    La commande affiche un code d'approbation et attend :

    Sortie
    Approval code: ABCD-EFGH
    Open https://localtonet.com/devices, choose Add device and enter this code.
    Waiting for approval...

    Lorsque vous l'exécutez en tant qu'administrateur ou root, elle demande d'abord Run shells as user: et propose votre propre compte. Sans ces droits, les shells s'exécutent sous le compte qui a lancé la commande.

  4. Saisir le code et approuver #

    De retour dans la boîte de dialogue, saisissez le code d'approbation sous 2. Saisissez le code affiché. Les majuscules et le tiret sont ajoutés pour vous, et vous pouvez coller toute la ligne affichée par la commande. Saisissez le code à 6 chiffres de votre application d'authentification et sélectionnez Approuver l'appareil.

    La commande sur l'ordinateur affiche alors Terminal enabled. Shells will run as … et l'appareil apparaît dans la liste. Il est indiqué en ligne tant que Localtonet s'exécute dessus.

Le code d'approbation est valable 15 minutes. Il comporte 8 caractères et ne contient jamais I, L, O, U, 0 ni 1. S'il expire, la commande l'indique : exécutez-la de nouveau.

Après l'approbation, une commande que vous avez lancée à la main dans une console continue comme une exécution normale de Localtonet. Dans un script, ou lorsque Localtonet s'exécute déjà sur l'appareil avec ce jeton, la commande se termine une fois le terminal activé.

Sans personne devant l'ordinateur #

Pour une machine où personne ne peut lire un code, par exemple un serveur que vous configurez avec un script, utilisez une clé à usage unique à la place du code d'approbation.

  1. Dans la boîte de dialogue Ajouter un appareil, choisissez le jeton et saisissez votre code d'authentification.
  2. Ouvrez Personne ne peut lire un code sur cet ordinateur ? et sélectionnez Créer une clé à usage unique. La clé est valable une heure et ne fonctionne qu'une seule fois.
  3. Copiez la commande et remplacez ACCOUNT par le compte utilisateur sous lequel les shells doivent s'exécuter sur cet ordinateur.
Sur l'ordinateur
localtonet --terminal enable --authtoken <YOUR_TOKEN> --terminal-user <ACCOUNT> --pairing-key <PAIRING_KEY>

Avec une clé valide, l'appareil est approuvé immédiatement et aucun code n'est affiché.

Options de la commande #

OptionFonction
--terminal enableActive le terminal distant pour cet ordinateur et lance l'appairage.
--terminal disableLe désactive sur cet ordinateur et retire l'appareil de votre compte.
--terminal statusAffiche si le terminal est activé et sous quel compte les shells s'exécutent.
--terminal-user <ACCOUNT>Le compte sous lequel les shells s'exécutent, lorsque vous activez en tant que root ou administrateur. Obligatoire dans ce cas lorsque la commande s'exécute sans console, par exemple depuis un script.
--pairing-key <PAIRING_KEY>La clé à usage unique du tableau de bord, qui rend le code d'approbation inutile.

La liste des appareils #

La liste s'actualise d'elle-même tant que la page est ouverte.

ColonneCe qu'elle affiche
AppareilLe nom de l'ordinateur, son système d'exploitation et son architecture, ainsi que le compte sous lequel les shells s'exécutent.
StatutEn ligne signifie que Localtonet s'exécute sur l'ordinateur et qu'il est connecté.
CPUCharge actuelle du processeur. Affichée lorsque l'appareil est en ligne.
MémoireMémoire utilisée sur le total. Affichée lorsque l'appareil est en ligne.
DisqueEspace disque utilisé sur le total. Affiché lorsque l'appareil est en ligne.
ActionsTerminal, Clés, historique des connexions, renommage et suppression.

Ouvrir un terminal dans le navigateur #

  1. Sélectionner Terminal #

    Sélectionnez Terminal dans la ligne de l'appareil. Le bouton ne fonctionne que lorsque l'appareil est en ligne. La boîte de dialogue vous indique sous quel compte le shell s'exécute.

  2. Saisir votre code d'authentification #

    Saisissez le code à 6 chiffres de votre application d'authentification et sélectionnez Ouvrir le terminal. Le shell s'ouvre dans un nouvel onglet du navigateur.

Se connecter avec ssh #

La boîte de dialogue Terminal affiche aussi une commande sous Ou depuis n'importe quel terminal, sans rien installer. Elle fonctionne depuis tout ordinateur disposant d'un client ssh. La commande a la forme suivante, où <DEVICE> est le nom de votre appareil et <NODE> le serveur Localtonet auquel il est connecté :

N'importe quel terminal
ssh -p 24 <DEVICE>@<NODE>

Copiez la commande depuis la boîte de dialogue : elle affiche la commande exacte pour votre appareil.

  • La boîte de dialogue affiche l'Empreinte du serveur. ssh affiche une empreinte lors de la première connexion. Si elle correspond, vous avez bien atteint Localtonet.
  • Si vous n'avez pas ajouté de clé SSH, ssh affiche un lien à approuver dans votre navigateur. La page Approuver la connexion indique l'appareil et l'adresse IP d'où la demande provient. Saisissez votre code d'authentification et sélectionnez Autoriser la connexion, puis revenez à votre terminal. La demande expire au bout de 5 minutes.

N'approuvez une connexion que si vous venez de lancer vous-même la commande ssh. Quiconque a fait la demande obtient un shell sur cet ordinateur.

Clés SSH #

Ajoutez la clé SSH publique de votre propre ordinateur pour que ssh, scp et sftp se connectent sans demander d'approbation dans le navigateur.

  1. Dans Mes appareils, sélectionnez Clés SSH.
  2. Saisissez un Nom et collez une ligne de votre fichier de clé publique, par exemple ~/.ssh/id_ed25519.pub, dans Clé publique. Ne collez jamais votre clé privée.
  3. Saisissez votre code d'authentification et sélectionnez Ajouter la clé.

Les types de clés acceptés sont ssh-ed25519, ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521 et ssh-rsa. Une clé s'applique à tous les appareils de votre compte. Sélectionnez Retirer à côté d'une clé pour l'empêcher de fonctionner. La boîte de dialogue affiche aussi un exemple scp pour l'un de vos appareils :

N'importe quel terminal
scp -P 24 file.txt <DEVICE>@<NODE>:/tmp/

Avec le client Localtonet #

Si Localtonet est installé sur l'ordinateur depuis lequel vous vous connectez, localtonet ssh se connecte aussi, et la session reste chiffrée jusqu'à l'appareil.

N'importe quel terminal
localtonet ssh <DEVICE>
localtonet ssh <DEVICE> -- uptime

Sans clé, la commande affiche Approve this connection in your browser avec un lien, et continue une fois que vous avez approuvé. Tout ce qui suit -- est exécuté comme une seule commande sur l'appareil au lieu d'ouvrir un shell.

Clés d'accès pour les scripts et les agents IA #

Une clé d'accès permet à un script ou à un agent IA d'atteindre un ordinateur sans navigateur. Toute personne qui la détient peut y exécuter des commandes : gardez-la confidentielle.

  1. Sélectionnez Clés dans la ligne de l'appareil.
  2. Saisissez un Nom, définissez Valable (jours) et saisissez votre code d'authentification. La clé cesse de fonctionner après ce nombre de jours, 3650 au maximum.
  3. Sélectionnez Créer la clé et copiez la clé maintenant. Elle ne sera plus affichée.

Façons d'utiliser la clé :

  • ssh. Exécutez la commande ssh affichée par la boîte de dialogue. Lorsque ssh le demande, collez la clé.
  • Client Localtonet. Transmettez la clé avec l'option --key, comme dans l'exemple ci-dessous.
  • MCP. Les agents IA connectés au serveur MCP de Localtonet peuvent transmettre la clé à l'outil RunDeviceCommand.
Script
localtonet ssh <DEVICE> --key <ACCESS_KEY> -- uptime

La boîte de dialogue liste les clés de l'appareil avec leur date d'expiration. Sélectionnez Retirer pour en révoquer une.

Elio #

Le bouton Elio de Mes appareils concerne Elio, le client SSH gratuit et open source de Localtonet. Vous le téléchargez sur elio.sh, vous vous connectez depuis Elio et vous approuvez la demande dans le tableau de bord avec votre code à deux facteurs. Elio voit alors les noms et le statut de vos appareils. Ouvrir un shell sur l'un d'eux nécessite toujours la clé d'accès de cet appareil ou une approbation. La boîte de dialogue liste les copies d'Elio connectées ; en retirer une la déconnecte.

Historique des connexions #

Sélectionnez le bouton en forme d'horloge dans la ligne d'un appareil pour voir ses dernières connexions. Chaque ligne indique quand elle a eu lieu, comment elle a été établie et depuis quelle adresse IP. Le mode est l'un des suivants : le terminal du navigateur, ssh avec votre clé SSH, ssh avec une clé d'accès, ssh approuvé dans le navigateur, localtonet ssh avec une clé d'accès ou approuvé dans le navigateur, et un agent IA via MCP avec une clé d'accès. La liste contient les 50 connexions les plus récentes.

Localtonet ne conserve que cet enregistrement. Les commandes que vous saisissez et leur sortie ne sont pas stockées. Servez-vous de la liste pour repérer une connexion que vous n'avez pas établie : si vous en trouvez une, retirez les clés d'accès et les clés SSH dont vous n'avez plus besoin.

Renommer, retirer ou désactiver un appareil #

ActionOùRésultat
RenommerLe bouton en forme de crayon dans la ligne.Modifie le nom affiché dans la liste et utilisé dans la commande ssh. Utilisez des lettres, des chiffres, des points, des tirets ou des traits de soulignement.
RetirerLe bouton en forme de corbeille dans la ligne.Retire l'ordinateur de votre compte. Ses clés cessent de fonctionner et il doit être approuvé de nouveau pour revenir.
DésactiverSur l'ordinateur lui-même.Désactive le terminal localement et retire l'appareil de votre compte.
Sur l'ordinateur
localtonet --terminal disable --authtoken <YOUR_TOKEN>
localtonet --terminal status --authtoken <YOUR_TOKEN>

La désactivation fonctionne toujours sur l'ordinateur, même lorsque le tableau de bord est inaccessible. Dans ce cas, la commande vous indique de retirer aussi l'appareil dans le tableau de bord.

Notes de sécurité #

  • Un shell sur une machine donne un accès complet à tout ce que son compte peut faire. Choisissez avec soin le compte sous lequel les shells s'exécutent ; un compte sans privilèges limite ce qu'une session peut modifier.
  • Tout ce qui peut mener à un shell demande un nouveau code d'authentification : approuver un appareil, ouvrir un terminal, créer une clé d'accès, ajouter une clé SSH et approuver une connexion ssh.
  • Une clé d'accès ou une clé SSH ajoutée se connecte sans ce code. Donnez aux clés une courte durée de validité, conservez-les comme des mots de passe et retirez celles que vous n'utilisez plus.
  • Après trop de tentatives en peu de temps, le tableau de bord répond Trop de tentatives. Patientez une minute et réessayez.
  • Consultez de temps en temps l'historique des connexions. Une connexion que vous ne reconnaissez pas signifie qu'une clé ou une approbation a été utilisée sans que vous l'ayez prévu.
  • Retirer un appareil, ou exécuter --terminal disable dessus, met fin à l'accès de toutes ses clés.

Dépannage #

Ce code d'approbation est incorrect ou a expiré.

Comparez le code avec celui qu'a affiché la commande. Un code est valable 15 minutes et appartient au compte du jeton indiqué dans la commande. Exécutez de nouveau la commande pour obtenir un nouveau code.

Remote terminal is available on personal tokens only

Le jeton de la commande appartient à une équipe. Créez un jeton dans votre compte personnel et utilisez celui-ci.

The pairing key is not valid or has expired

Une clé à usage unique ne fonctionne qu'une fois et pendant une heure. Créez-en une nouvelle dans la boîte de dialogue Ajouter un appareil.

Choose the account for shells with --terminal-user

La commande s'exécute en tant que root ou administrateur sans console, elle ne peut donc pas poser la question. Ajoutez --terminal-user <ACCOUNT>.

Le bouton Terminal est désactivé, ou Cet appareil est hors ligne

Le terminal ne s'ouvre que lorsque l'appareil est en ligne. Démarrez Localtonet sur cet ordinateur avec le même jeton.

Ce code d'authentification n'est pas correct.

Saisissez le code à 6 chiffres que votre application d'authentification affiche pour Localtonet. Ce n'est ni votre mot de passe ni le code affiché sur l'ordinateur, et il change toutes les 30 secondes.

Cette demande a expiré. Recommencez depuis Mes appareils.

Une demande d'ouverture de terminal ou d'approbation de connexion ssh est de courte durée. Sélectionnez de nouveau Terminal, ou exécutez de nouveau la commande ssh.

Cela ne ressemble pas à une clé publique SSH.

Collez la ligne entière de votre fichier .pub, en commençant par le type de clé.

The terminal is already enabled on this device

Rien à faire. Pour appairer de nouveau la machine, exécutez d'abord --terminal disable, puis --terminal enable.

Support