Un tunnel SSH vous permet d’atteindre un service non exposé à Internet — une base de données, un dashboard d’admin, une API interne — en faisant transiter le trafic par un serveur auquel vous accédez déjà en SSH. Bifrost le configure par connexion, sans avoir à retenir les options ssh -L ni éditer ~/.ssh/config.
Trois types de redirection
- Locale (la plus courante) — ouvre un port sur votre Mac qui tunnelise vers un hôte/port joignable depuis le serveur. Exemple : atteindre un PostgreSQL qui n’écoute que sur le réseau privé du serveur en pointant votre client DB local sur
127.0.0.1. - Distante — ouvre un port sur le serveur qui tunnelise vers un service sur votre Mac (ou votre côté du réseau). Utile pour exposer à l’hôte distant quelque chose tournant en local.
- Dynamique (SOCKS5) — transforme le serveur en proxy SOCKS5 sur un port local, pour qu’un navigateur ou une app configurée dessus fasse transiter son trafic par le serveur.
1. Créer une connexion Tunnel SSH
Les tunnels SSH sont un type de connexion à part dans Bifrost. Créez une connexion, choisissez Tunnel SSH, et indiquez l’hôte du serveur et vos identifiants SSH — la même authentification qu’une connexion SSH normale. Ajoutez ensuite une ou plusieurs règles, chacune en locale, distante ou dynamique :
- Locale — un port local sur votre Mac plus l’hôte et port de destination vus depuis le serveur (ex.
127.0.0.1:5432). - Distante — un port distant sur le serveur plus la destination de votre côté.
- Dynamique — juste un port local ; c’est votre proxy SOCKS5.
Une même connexion tunnel peut porter plusieurs règles à la fois — une base, une interface d’admin et un proxy SOCKS, le tout depuis un seul serveur.
2. Monter le tunnel
Ouvrez la connexion : Bifrost établit la session SSH et active chaque règle, avec son propre indicateur d’état. Pointez ensuite votre app sur l’extrémité locale — pour une règle locale vers une base, connectez votre client DB à 127.0.0.1:<port local> comme si la base était sur votre machine. Bifrost lie les ports locaux à 127.0.0.1 : ils ne sont joignables que depuis votre Mac.
Un exemple rapide
Pour atteindre un PostgreSQL lié à 127.0.0.1:5432 sur le serveur :
- Type : locale
- Port local :
5432 - Destination :
127.0.0.1:5432
Connectez ensuite votre outil DB à localhost:5432 — le trafic emprunte le canal SSH chiffré jusqu’au serveur puis jusqu’à Postgres.
Dépannage
« Address already in use ».
Quelque chose sur votre Mac utilise déjà ce port local. Choisissez-en un autre (ex. 15432 au lieu de 5432).
Le tunnel est monté mais le service ne répond pas.
La destination est évaluée du point de vue du serveur. Assurez-vous que le serveur lui-même atteint cet hôte et ce port (nc -z <hôte> <port> en SSH), et que le service écoute bien là.
Kubernetes plutôt que SSH ? Pour les clusters, utilisez le port-forward de pod/service depuis la vue Kubernetes — c’est l’équivalent natif Kubernetes.
Toujours bloqué ? Contactez-nous — joignez le texte exact de l’erreur affichée par Bifrost.