Aller au contenu
Localtonet Localtonet Tableau de bord

Démarrer un tunnel avec votre client SSH

Offre gratuite Tunnels HTTP et TCP

Aide pour cette page
Sur cette page 11 sections
  1. Quand l'utiliser
  2. Avant de commencer
  3. Étapes
  4. Créer un tunnel HTTP ou TCP
  5. Ouvrir la commande SSH
  6. Choisir la reconnexion automatique ou non
  7. Exécuter la commande
  8. Garder la fenêtre ouverte
  9. Depuis l'assistant de configuration de tunnel
  10. La commande en détail
  11. Reconnexion automatique
  12. Durée de validité d'une commande
  13. Limites
  14. Ce que vous voyez dans le tableau de bord
  15. Dépannage
  16. Messages dans le tableau de bord
  17. Messages dans le terminal
  18. Pages associées

Mettez un service local en ligne sans installer Localtonet. Le tableau de bord vous fournit une commande ssh prête à l'emploi ; tant que cette commande s'exécute, votre tunnel HTTP ou TCP est actif.

Quand l'utiliser #

Utilisez le SSH sans installation sur une machine où vous ne pouvez pas ou ne voulez pas installer le client Localtonet, par exemple un serveur auquel vous n'accédez que ponctuellement, un poste de travail verrouillé ou une démonstration rapide. Le client ssh fourni avec Windows, macOS et Linux suffit.

La commande SSH remplace le client Localtonet pour un seul tunnel. Tout le reste reste dans le tableau de bord : l'adresse du tunnel, ses paramètres, ses journaux et sa bande passante.

Type de tunnelCommande SSH
HTTP / HTTPSDisponible
TCPDisponible
UDP, UDP / TCP mixte, TLS, Serveur de fichiers, Serveur proxy et les autres typesNon disponible. Ces types nécessitent le client Localtonet.

Cette page n'explique pas comment accéder à un serveur SSH. Pour publier votre propre serveur SSH via un tunnel, consultez Utiliser Localtonet avec SSH. Pour ouvrir un shell sur l'un de vos appareils depuis le tableau de bord, consultez Terminal d'appareil.

Avant de commencer #

  • Un compte Localtonet et un service déjà en cours d'exécution, par exemple une application web sur le port 3000.
  • Un client ssh sur la machine qui peut accéder au service. Vérifiez avec ssh -V.
  • Les connexions TCP sortantes vers le port 223 doivent être autorisées sur le réseau de cette machine.
  • Un AuthToken qu'aucun client Localtonet en cours d'exécution n'utilise. Un tunnel appartient toujours à un jeton, mais avec SSH aucun client ne s'authentifie avec lui. Si un client est connecté avec le jeton du tunnel, le tableau de bord refuse de délivrer la commande.

Étapes #

  1. Créer un tunnel HTTP ou TCP #

    Ouvrez Mes tunnels › HTTP ou Mes tunnels › TCP - UDP (protocole TCP) et créez le tunnel comme d'habitude. Adresse IP locale et Port local indiquent où le client SSH enverra le trafic : 127.0.0.1 et le port de votre service lorsque vous exécutez la commande sur la même machine que le service. Laissez le tunnel arrêté.

  2. Ouvrir la commande SSH #

    Dans la liste des tunnels, sélectionnez Paramètres pour le tunnel, puis Afficher la commande SSH. La boîte de dialogue Commande SSH s'ouvre avec la commande de ce tunnel. Un avis vous indique de combien de secondes vous disposez pour l'exécuter ; une commande inutilisée expire, et vous en demandez alors une nouvelle de la même manière.

  3. Choisir la reconnexion automatique ou non #

    Laissez Reconnexion automatique désactivée pour obtenir la commande ssh simple. Activez-la pour encapsuler la commande dans une boucle qui la relance lorsque la connexion tombe, puis choisissez sous Où vous allez l'exécuter le shell pour lequel la boucle est écrite : PowerShell, Invite de commandes ou macOS ou Linux.

  4. Exécuter la commande #

    Copiez le texte sous Commande. Ouvrez un terminal sur l'ordinateur qui exécute votre service, collez la commande et appuyez sur Enter. Aucun mot de passe n'est demandé. Lorsque la connexion est établie, le terminal affiche les points d'accès du tunnel :

    Terminal
    +--------------------------------------------------------------+
    | Welcome to Localtonet!                                       |
    +--------------------------------------------------------------+
    | Localtonet Tunnel Endpoints                                  |
    +--------------------------------------------------------------+
    | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000               |
    | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000             |
    +--------------------------------------------------------------+
    | Server Time: ...                                             |
    +--------------------------------------------------------------+
    
    You can view your requests and configure your tunnel settings from the Localtonet Dashboard.

    Un tunnel TCP affiche à la place une seule ligne : TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>.

  5. Garder la fenêtre ouverte #

    Le tunnel démarre de lui-même lorsque la commande se connecte ; vous ne sélectionnez pas Démarrer. Il reste en ligne tant que la commande s'exécute. Fermer la fenêtre met fin à la connexion, et l'adresse publique ne répond plus. Pour arrêter vous-même la commande, saisissez exit et appuyez sur Enter, ou appuyez sur Ctrl + C.

    Arrêter la commande n'arrête pas le tunnel dans le tableau de bord. Le tunnel reste démarré avec sa connexion indiquée comme inactive, afin que la même commande puisse se reconnecter. Lorsque vous avez fini avec le tunnel, sélectionnez Arrêter pour lui dans le tableau de bord. Le tableau de bord ne délivre une nouvelle commande SSH que pour un tunnel arrêté.

Depuis l'assistant de configuration de tunnel #

L'Assistant de configuration de tunnel du Tableau de bord propose la même commande. À la dernière étape, où vous choisissez votre plateforme, sélectionnez SSH puis Obtenir la commande SSH. Le choix SSH n'apparaît que pour les tunnels HTTP et TCP. L'assistant affiche En attente de SSH jusqu'à ce que votre commande se connecte, puis Connecté via SSH. Reconnexion automatique ajoute la même boucle de reconnexion, et Obtenir une nouvelle commande remplace une commande qui a expiré.

La commande en détail #

La commande a toujours cette forme. Le tableau de bord renseigne les valeurs de votre tunnel :

Bash
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>
ÉlémentFonction
-p 223Se connecte au port 223, sur lequel Localtonet accepte ces connexions SSH.
-l <COMMAND_KEY>Le nom de connexion. C'est une clé que le tableau de bord génère pour ce tunnel, et non votre AuthToken ni le mot de passe de votre compte. Elle indique à Localtonet quel tunnel démarrer, ce qui explique qu'aucun mot de passe ne soit demandé.
<TUNNEL_ADDRESS>L'adresse de votre tunnel. La connexion SSH est dirigée vers le serveur qui l'héberge.
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>La redirection distante : les connexions qui arrivent pour le tunnel sur le serveur sont envoyées via la connexion SSH vers <LOCAL_IP>:<LOCAL_PORT>. Les deux dernières valeurs sont l'Adresse IP locale et le Port local du tunnel. Le port du serveur est attribué par Localtonet et ne doit pas être modifié.
-o ExitOnForwardFailure=yesFait quitter ssh si la redirection ne peut pas être établie, au lieu de rester connecté sans tunnel fonctionnel.
-o ServerAliveInterval=15 -o ServerAliveCountMax=3Envoie un signal de maintien de connexion toutes les 15 secondes et met fin à la connexion après trois signaux sans réponse, de sorte qu'une connexion morte est détectée en 45 secondes environ.
-o ConnectTimeout=15Abandonne au bout de 15 secondes si le serveur est injoignable.
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/nullIgnore la question sur la clé d'hôte et n'écrit pas le serveur dans votre fichier known_hosts.
-o LogLevel=ERRORMasque les messages d'information de ssh. Les erreurs restent affichées.

Comme <LOCAL_IP> est résolue sur la machine où vous exécutez ssh, le service n'a pas besoin de se trouver sur cette machine. Avec une adresse locale telle que 192.168.1.20, la commande redirige vers un autre appareil du même réseau.

Ne partagez pas la commande. Quiconque l'exécute pendant sa validité répond au trafic de votre tunnel.

Reconnexion automatique #

Lorsque Reconnexion automatique est activée, le tableau de bord encapsule la même commande ssh dans un petit script pour le shell que vous avez choisi. Pour Invite de commandes, le script est fourni sous la forme d'une seule ligne powershell -NoProfile -EncodedCommand …. Le script se comporte de la même façon dans tous les shells :

  • Lorsque ssh se termine, il patiente puis le relance. L'attente commence à environ 10 secondes et double après chaque échec, jusqu'à environ 2 minutes.
  • Une connexion qui a duré au moins 60 secondes compte comme une réussite et réinitialise le temps d'attente.
  • Après 8 tentatives consécutives qui ont chacune duré moins de 60 secondes, il s'arrête et affiche SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel.

La reconnexion réutilise la même commande. Cela fonctionne après une interruption réseau, mais pas après l'arrêt du tunnel dans le tableau de bord ou l'atteinte d'une limite ; dans ce cas, le script abandonne et vous avez besoin d'une nouvelle commande.

Durée de validité d'une commande #

  • Avant la première utilisation : la commande doit être exécutée dans le délai que le tableau de bord indique lorsqu'il la délivre. Passé ce délai, l'offre de port expire.
  • Pendant l'utilisation : une seule session SSH par tunnel. Une seconde copie de la commande est refusée tant que la première est connectée.
  • Après la fin de la connexion : la même commande peut se reconnecter, tant que le tunnel n'a pas été arrêté dans le tableau de bord et qu'aucune limite n'a été atteinte.
  • Après un arrêt : lorsque le tunnel a été arrêté dans le tableau de bord ou par une limite, la commande est périmée. Rouvrez Afficher la commande SSH pour en obtenir une nouvelle.

Le tableau de bord ne délivre une commande que lorsque le tunnel est arrêté. Une nouvelle commande peut comporter un autre port de serveur ; avec l'offre gratuite, chaque nouvelle commande en reçoit un nouveau. Pour un tunnel TCP, ce port fait partie de l'adresse publique : vérifiez donc l'adresse dans la sortie du terminal ou dans la liste des tunnels après avoir demandé une nouvelle commande. Le journal d'activité du tunnel enregistre le changement sous la forme Server port changed to "…" for SSH.

Limites #

  • Limite de session avec l'offre gratuite. Un tunnel démarré via SSH suit la même règle qu'un tunnel démarré avec le client : avec l'offre gratuite, les tunnels TCP s'arrêtent au bout de 30 minutes et peuvent être redémarrés, et les tunnels HTTP n'ont aucune limite de durée. Les 30 minutes sont comptées à partir de la première connexion d'une commande ; se reconnecter avec la même commande ne les réinitialise pas. Lorsqu'une session TCP atteint la limite, le serveur ferme la connexion SSH avec le message Session time limit reached. Get a new SSH command from the panel. Consultez Offres et solde.
  • Bande passante. Le trafic est décompté de votre bande passante comme celui de n'importe quel autre tunnel. Sans bande passante restante, aucune commande n'est délivrée, et le serveur ferme une session en cours avec le message Bandwidth limit reached. Get a new command after bandwidth is available.
  • Redirection inverse uniquement. Le point d'accès SSH n'accepte que la redirection unique de la commande. Il ne vous donne aucun shell sur un serveur Localtonet ni aucun autre type de redirection.
  • Un tunnel par commande. Pour exécuter plusieurs tunnels, demandez une commande pour chacun et exécutez chacune dans son propre terminal.

Ce que vous voyez dans le tableau de bord #

Tant que la commande est connectée, le tunnel apparaît comme démarré, et les requêtes s'affichent dans ses journaux comme d'habitude. Le Journal d'activité du tunnel enregistre Tunnel started over SSH. lorsqu'une commande se connecte. Consultez Journaux et inspection.

Dépannage #

Messages dans le tableau de bord #

MessageQue faire
Arrêtez le tunnel avant de demander une commande SSH.Le tunnel s'exécute avec le client Localtonet. Arrêtez-le, puis sélectionnez à nouveau Afficher la commande SSH.
Arrêtez le tunnel SSH en cours avant de demander une nouvelle commande.Le tunnel est toujours démarré via SSH, ou une session SSH de ce tunnel était active il y a un instant. Mettez fin à la commande ssh en cours, sélectionnez Arrêter pour le tunnel, puis réessayez.
Un client est connecté à ce tunnel avec l'AuthToken que vous avez créé. Créez un nouvel AuthToken.Un client Localtonet est connecté avec le jeton du tunnel. Arrêtez ce client, ou créez un autre jeton dans Mes jetons et utilisez-le pour ce tunnel.
Il ne vous reste pas assez de bande passante pour démarrer le tunnel.Votre bande passante est épuisée. Consultez Offres et solde.
Cette fonctionnalité n'est pas disponible pour ce type de protocole.Le tunnel n'est pas un tunnel HTTP ou TCP.
Cette fonctionnalité n'est pas disponible sur ce serveur. Déplacez votre tunnel vers un autre serveur.Le serveur de ce tunnel ne propose pas de commandes SSH. Créez le tunnel sur un autre serveur.
Une opération sur le tunnel est en cours. Veuillez réessayer dans un instant.Patientez quelques secondes et réessayez.
Impossible d'attribuer un nouveau port serveur.Réessayez. Si l'échec persiste, créez le tunnel sur un autre serveur.
Le port SSH n'a pas pu être enregistré. Veuillez réessayer.Réessayez.

Messages dans le terminal #

Lorsque le serveur ferme une session, il envoie l'un des messages ci-dessous comme motif. La manière dont ce motif s'affiche dépend de votre client ssh.

Message ou symptômeCause et solution
ssh se termine immédiatement avec une erreur d'authentification, généralement Permission deniedLocaltonet n'a pas accepté la commande. Elle n'a pas été exécutée à temps, le tunnel a été arrêté ou a atteint une limite depuis qu'elle a été délivrée, une autre session de la même commande est déjà connectée, ou le texte a été modifié lors de la copie. Obtenez une nouvelle commande depuis le tableau de bord et collez-la sans la modifier.
Port mismatch. Get a new SSH command from the panel.Le port du serveur après -R n'est pas celui que Localtonet a attribué. Utilisez la commande exactement telle qu'elle a été délivrée.
Session time limit reached. Get a new SSH command from the panel.La session de 30 minutes d'un tunnel TCP avec l'offre gratuite est terminée. Demandez une nouvelle commande pour redémarrer.
Bandwidth limit reached. Get a new command after bandwidth is available.Votre bande passante est épuisée.
Session stopped. Get a new SSH command from the panel.Le tunnel a été arrêté, par exemple depuis le tableau de bord.
Un délai de connexion dépassé, ou Connection refusedLa machine ne peut pas joindre le serveur sur le port 223. Autorisez les connexions TCP sortantes vers le port 223 dans le pare-feu ou essayez depuis un autre réseau.
Le tunnel est actif mais les visiteurs obtiennent une erreurssh est connecté mais ne parvient pas à joindre votre service. Vérifiez que le service fonctionne et que l'Adresse IP locale et le Port local du tunnel sont corrects. Après les avoir modifiés, demandez une nouvelle commande, car l'ancienne contient encore les anciennes valeurs.
Support