Un tunnel SSH local créé avec ssh -L 5432:localhost:5432 user@server ouvre le port 5432 sur votre machine et transfère chaque connexion, chiffrée dans SSH, vers le PostgreSQL du serveur. La base de données continue d’écouter uniquement sur le localhost distant, sans aucun port exposé sur Internet, et votre client se connecte à 127.0.0.1 comme si elle était locale.

Comment fonctionne ssh -L 5432:localhost:5432, étape par étape

La syntaxe de -L est [bind_address:]local_port:dest_host:dest_port, et l’hôte de destination est résolu depuis le serveur SSH, pas depuis votre machine. C’est pourquoi le localhost du milieu signifie « la machine distante ». La référence complète se trouve dans la page de manuel officielle de ssh.

# Foreground tunnel, no remote shell
ssh -N -L 5432:localhost:5432 [email protected]

# In another terminal, connect as if PostgreSQL were local
psql -h 127.0.0.1 -p 5432 -U app db_name
  • -L 5432:localhost:5432 : écoute sur le port local 5432 et achemine le trafic vers le port 5432 du serveur.
  • -N : n’exécute aucune commande distante ; la connexion sert uniquement à transporter le tunnel.
  • -f (facultatif) : envoie ssh en arrière-plan après l’authentification.

Si la base de données tourne sur un autre hôte du réseau interne, changez la destination : ssh -N -L 5432:db.internal:5432 admin@bastion. Le saut entre le bastion et db.internal n’est alors plus chiffré par SSH, ne le faites donc que sur un réseau de confiance. Par défaut, ssh lie le port local à l’interface loopback ; ne l’exposez pas sur 0.0.0.0 et n’activez pas GatewayPorts sauf si vous savez qui d’autre peut atteindre votre machine.

Si un PostgreSQL local occupe déjà le port 5432, ssh signale bind: Address already in use. Choisissez un autre port local, par exemple -L 15432:localhost:5432, et connectez-vous avec -p 15432.

LocalForward dans ~/.ssh/config : le tunnel SSH sans mémoriser d’options

LocalForward est la directive ssh_config équivalente à -L : d’abord le port local, puis la destination host:port, séparés par un espace.

Host db-prod
    HostName server.example.com
    User admin
    IdentityFile ~/.ssh/id_ed25519
    LocalForward 15432 localhost:5432
    ExitOnForwardFailure yes
    ServerAliveInterval 30

Avec ce bloc, il suffit de taper ssh -N db-prod. Trois choix dans l’exemple :

  1. Port local 15432 : évite le conflit avec un PostgreSQL qui écoute déjà sur le port 5432 de votre machine.
  2. ExitOnForwardFailure yes : si le port local est occupé, ssh quitte au lieu d’ouvrir une session qui semble normale mais sans tunnel.
  3. ServerAliveInterval 30 : envoie un keepalive toutes les 30 secondes pour détecter plus tôt une connexion morte.

OpenSSH est strict sur les permissions : ~/.ssh en 700 et la clé privée en 600. Toutes les directives sont répertoriées dans la documentation officielle de ssh_config.

Vérifier que le tunnel SSH local écoute et se connecte

Le symptôme classique d’un tunnel cassé est un Connection refused dans le client de base de données ; avant de toucher à PostgreSQL, testez chaque extrémité séparément.

# On your machine: is anything listening on the local port?
ss -ltn | grep 15432              # Linux
lsof -iTCP:15432 -sTCP:LISTEN     # macOS

# On the server: is PostgreSQL listening on loopback?
ss -ltn | grep 5432

# Debug ssh itself
ssh -v -N db-prod

Avec -v, vous verrez si le serveur refuse la redirection avec un message administratively prohibited. Dans sshd_config, AllowTcpForwarding no désactive les tunnels ; vérifiez aussi la présence de blocs Match qui la restreignent pour certains utilisateurs.

Tunnel SSH local depuis un téléphone : ce qui change par rapport à un ordinateur

Mosh ne fait aucune redirection de ports : il transporte la session sur UDP, par défaut sur les ports 60000-61000, et n’utilise SSH que pour démarrer mosh-server. Un tunnel -L nécessite une connexion SSH classique ouverte pendant toute la durée d’utilisation, et iOS et Android peuvent suspendre les applications qui passent en arrière-plan.

Méthode d’accèsRedirige des ports ?Ce qu’elle exigeUsage idéal
ssh -L sur un ordinateurOui, TCP dans SSHPort 22 accessible et AllowTcpForwarding activéClients graphiques de base de données, migrations depuis votre machine
Mosh sur iOS/AndroidNonUDP 60000-61000 et mosh-server sur l’hôteUn shell qui survit au passage du wifi aux données mobiles
psql sur le serveur, dans tmuxPas nécessaireSession SSH ou Mosh et psql installéRequêtes rapides depuis un téléphone
Réseau maillé (Prialo, Tailscale)Non ; accès direct par IP privéeUn agent sur chaque appareilAccès régulier sans ports ouverts ni tunnels

Depuis un téléphone, la solution pratique consiste généralement à se connecter avec Mosh, s’attacher à tmux et lancer psql directement sur le serveur. Avec un terminal SSH et Mosh mobile comme termi1, la session survit aux changements de réseau, tmux conserve la longue requête que vous avez laissée tourner, et le clavier intégré fournit Ctrl, Tab et les flèches pour parcourir l’historique de psql ou quitter avec Ctrl+D. L’IA transforme « connecte-moi à la base de données de l’application » en commande et la saisit dans l’invite sans appuyer sur Entrée ; sur les connexions marquées comme production, Production Guard bloque tout ce qui supprime ou modifie des données. Le SFTP intégré vous permet de télécharger un fichier pg_dump sans quitter la session.

Quand ne pas utiliser un tunnel SSH local (-L)

Un tunnel -L est une solution ponctuelle pour une personne et une session ; en dehors de ce cas, il existe généralement une meilleure option.

  • Accès permanent ou partagé : si plusieurs personnes ont besoin de la base de données chaque jour, un réseau privé sans ports ouverts comme Prialo ou Tailscale vaut mieux que l’entretien de tunnels individuels.
  • Sessions Mosh : Mosh ne redirige pas les ports ; si vous avez besoin du tunnel, ouvrez une connexion SSH séparée.
  • Liaison à 0.0.0.0 ou utilisation de GatewayPorts : cela transforme votre ordinateur portable en passerelle vers la base de données pour tout le réseau local.
  • Serveurs avec AllowTcpForwarding no : c’est une politique de l’administrateur, pas un bug à contourner.
  • Requêtes ponctuelles depuis un téléphone : lancer psql sur le serveur est plus simple que de maintenir un tunnel en vie.

Questions fréquentes

Que signifie localhost dans ssh -L 5432:localhost:5432 ?

Dans ssh -L 5432:localhost:5432, localhost est résolu par le serveur SSH, et non par votre machine. Il désigne donc le PostgreSQL qui écoute sur l’interface loopback de l’hôte distant. Pour atteindre une autre machine du réseau interne, remplacez-le par le nom ou l’IP privée de cet hôte.

Comment exécuter un tunnel SSH local en arrière-plan ?

Un tunnel SSH local s’exécute en arrière-plan avec ssh -f -N -L 15432:localhost:5432 admin@server : -f envoie ssh en arrière-plan après l’authentification et -N évite le shell distant. Pour le fermer, trouvez le processus avec pgrep -f 15432 et arrêtez-le avec kill.

Mosh peut-il rediriger des ports comme un tunnel SSH ?

Mosh ne peut pas rediriger de ports : il ne prend en charge ni la redirection de ports ni la redirection X11 et transporte la session sur UDP, par défaut sur les ports 60000-61000. Rediriger un port exige une connexion SSH classique, qui peut fonctionner en même temps que la session Mosh.

Un tunnel SSH local vers une base de données de production est-il sûr ?

Un tunnel SSH local vers la production chiffre le trafic et évite d’exposer le port de la base sur Internet, mais tout processus local peut utiliser le port redirigé tant qu’il reste ouvert. Liez-le uniquement à 127.0.0.1, fermez-le une fois terminé et utilisez un compte de base de données aux droits minimaux.