bambouville

Redirection de ports

La redirection de ports locale vous permet d'atteindre les services situés derrière votre serveur — une base de données, un notebook, un serveur de développement — depuis votre appareil, comme s'ils étaient locaux.

Ajouter une règle

Ouvrez un hôte dans l'éditeur et allez dans l'onglet redirection. Chaque règle comprend :

  • port local — le port sur votre appareil (au moins 1024 ; le bac à sable iOS ne peut pas se lier en dessous),
  • hôte distant — tel que le voit le serveur SSH (par défaut localhost),
  • port distant,
  • un libellé facultatif,
  • démarrer automatiquement à la connexion.

Les préréglages couvrent les habitués : jupyter 8888, postgres 5432, mysql 3306, redis 6379, web 3000, web 8080.

Les ports locaux ne peuvent pas se répéter au sein d'un même hôte. Les modifications de règles s'appliquent en direct à un hôte déjà connecté.

L'onglet redirection de l'éditeur d'hôtes avec une règle : port local 8080 vers localhost:18080, libellée dev server, avec son interrupteur d'activation.
Une règle enregistrée dans l'onglet redirection de l'éditeur d'hôtes, avec son interrupteur d'activation et son état actuel.

La page des tunnels

La page tunnels de la barre latérale rassemble toutes les règles de redirection de tous vos hôtes, groupées par hôte avec leur état connecté/déconnecté. Chaque règle affiche son état (par exemple « à l'écoute · 0 active »), des compteurs d'octets ↑/↓ en direct, un interrupteur d'activation et un bouton pour ouvrir les ports de type HTTP dans Safari.

Dans une session, une pastille ⇄ N dans la barre supérieure affiche le même état pour cet hôte.

Sur iPhone, les tunnels sont visibles depuis la barre supérieure de la session, mais les règles se créent et se modifient sur iPad.

La page des tunnels listant une règle de redirection, 8080 vers localhost:18080 libellée dev server, groupée sous un hôte connecté, avec son état à l'écoute et un interrupteur d'activation.
Toutes les règles de tous les hôtes, groupées par hôte, chacune avec son état en direct et son interrupteur.

Utiliser un tunnel

Dès qu'une règle est à l'écoute, pointez n'importe quelle app de l'appareil vers localhost:<local port> — un navigateur pour un serveur de développement, un client Postgres pour une base de données. Le trafic circule à l'intérieur de la connexion SSH jusqu'à votre serveur, qui se connecte ensuite à l'hôte:port distant.

Mosh et redirection

Les règles de redirection empruntent la connexion SSH. Avec le transport mosh :

  • les modes de lancement tmux automatique et tmux nommé conservent un canal SSH secondaire pour tmux, et la redirection fonctionne par ce canal.
  • le mode de lancement personnalisé n'a aucune connexion SSH pour transporter les redirections, l'ajout de règles est donc désactivé — passez le mode de lancement à tmux automatique ou tmux nommé.

Limites

  • Le port local doit être ≥ 1024 (bac à sable iOS).
  • Pas de ports locaux en double par hôte.
  • La redirection est uniquement locale vers distante ; il n'y a pas de redirection distante (-R).