Réponse rapide. Les options qui reviennent le plus souvent : -p <port> (port non standard), -i <key> (forcer une clé précise), -L / -R / -D (redirections locale, distante et dynamique), -J <bastion> (rebondir par un bastion), -N -f (lancer un tunnel en arrière-plan, sans shell), -t (forcer un TTY pour sudo), -o Option=value (poser n’importe quelle directive ssh_config en ligne) et -vvv (déboguer une connexion qui échoue). Tout ce que vous passez deux fois a sa place dans ~/.ssh/config, de sorte que ssh web1 l’emporte sans aucune option.
ssh --help déverse quarante options par ordre alphabétique, soit la manière la moins utile de les apprendre. On recourt à une option selon ce qu’on cherche à faire — se connecter sous un autre utilisateur, rediriger un port, rebondir par un bastion, déboguer un refus — voici donc le même ensemble classé par tâche, avec une note sur celles qu’il vaut mieux arrêter de taper pour les mettre dans votre ssh_config (en anglais).
La règle qui sous-tend tout cela : les options sont pour les cas ponctuels ; la configuration, pour ce qui dure. Tout ce que vous passez deux fois a sa place dans le fichier.
Les bases de la connexion
Les options qui répondent à « qui, où et avec quelle clé ».
-p <port>— se connecter à un port non standard.ssh -p 2222 user@host. (-pminuscule ; le-Pmajuscule est l’option de port de scp, ce qui piège tout le monde une fois.)-l <user>— l’utilisateur de connexion, une alternative au préfixeuser@.ssh -l deploy hostéquivaut àssh deploy@host; vous verrez-ldans les scripts et la documentation ancienne.-i <identity>— désigner une clé privée précise.ssh -i ~/.ssh/work_ed25519 user@host. L’option la plus utile quand l’authentification échoue : elle force la clé exacte au lieu de laisser l’agent deviner.-F <configfile>— utiliser un autre fichier de configuration.ssh -F ./project.sshconfig web1, ou-F /dev/nullpour ignorer votre configuration personnelle et tester sans aucune personnalisation.-v/-vv/-vvv— la verbosité, et l’option qui met fin à la plupart des mystères. Un seul-vmontre les méthodes d’authentification tentées et les clés proposées ;-vvvmontre toute la poignée de main. Quand quelque chose échoue, relancez avec-vvvavant de théoriser — lire cette trace est une compétence à part entière.
L’option universelle -o
C’est l’option qui vaut la peine d’être comprise à fond, car elle en englobe des dizaines d’autres. -o définit n’importe quelle option de ssh_config en ligne. Tout ce que vous pourriez écrire dans ~/.ssh/config sous un bloc Host, vous pouvez le passer sous la forme -o Option=value — pas une courte liste d’options autorisées, mais tout le vocabulaire de la configuration, disponible pour une seule connexion.
Quelques-unes qui reviennent constamment :
ssh -o IdentitiesOnly=yes -i ~/.ssh/right_key user@host # ne proposer que cette clé
ssh -o StrictHostKeyChecking=accept-new user@host # faire confiance aux nouveaux hôtes, détecter quand même les changements
ssh -o ServerAliveInterval=30 user@host # keepalive pour un lien instable
ssh -o ProxyJump=bastion.example.com db.internal # rebondir par un bastion en ligne
-o IdentitiesOnly=yes est le correctif pour Too many authentication failures quand votre agent propose six clés et qu’un serveur strict vous coupe après cinq. -o StrictHostKeyChecking=accept-new est le juste milieu raisonnable — faire confiance automatiquement à un hôte jamais vu, mais crier quand même si la clé d’un hôte connu change.
L’essentiel : vous n’avez pas besoin d’une option spéciale pour chaque comportement. Si vous connaissez la directive de configuration, vous connaissez l’option — c’est -o Directive=value. Dès que vous en passez trois ou quatre à chaque fois, déplacez-les dans la configuration une bonne fois pour toutes.
Redirections et tunnels
Les options de plomberie des ports. Le modèle mental — quel côté ouvre le port — a son propre article dans la redirection de port SSH expliquée ; voici le résumé des options.
-L <local>:<host>:<port>— redirection locale. Ouvre un port sur votre machine qui crée un tunnel vers une destination joignable depuis le serveur.ssh -L 5432:localhost:5432 db.example.comamène une base distante sur votre127.0.0.1:5432.-R <remote>:<host>:<port>— redirection distante. Ouvre un port sur le serveur qui crée un tunnel de retour vers votre côté — l’astuce du tunnel inverse pour atteindre une machine derrière un NAT.-D <port>— redirection dynamique. Un proxy SOCKS sur votre machine ; destination choisie connexion par connexion.ssh -D 1080 jump.example.com, puis pointez un navigateur vers127.0.0.1:1080.-N— ne pas exécuter de commande distante. À associer à n’importe quelle redirection quand vous voulez seulement le tunnel et pas de shell.-f— passersshen arrière-plan une fois connecté. À combiner avec-Npour un tunnel qu’on lance et qu’on oublie :ssh -fN -L 5432:localhost:5432 db.example.com.-g— laisser d’autres machines de votre réseau local utiliser une redirection locale (-L/-D), pas seulement127.0.0.1. Une petite exposition — vous ouvrez le tunnel à tout votre réseau, utilisez-la donc à dessein.
Hôtes de rebond et agent
Atteindre le saut suivant, et l’option avec laquelle il faut être prudent.
-J <jumphost>— ProxyJump. Crée un tunnel à travers un bastion et authentifie de bout en bout depuis votre portable jusqu’à la cible.ssh -J bastion.example.com db.internal. Le bastion ne fait transiter que des octets chiffrés ; votre clé n’y atterrit jamais — la bonne façon de traverser une passerelle. Cas complet : ProxyJump : atteindre des serveurs derrière un bastion.-A— redirection d’agent. Expose sur l’hôte distant un socket qui relaie les demandes de signature vers votre agent local, de sorte qu’un processus là-bas peut s’authentifier en votre nom auprès du serveur suivant. Pratique et plus risquée qu’il n’y paraît : quiconque dispose des droits root sur cet hôte peut emprunter votre identité tant que la session est ouverte. Utilisez-Jpour « atteindre le saut suivant » et réservez-Aaux hôtes en qui vous avez pleinement confiance — les raisons sont dans la redirection d’agent est pratique et dangereuse (en anglais).
Entre les deux : -J amène votre shell jusqu’à un hôte derrière le bastion sans prêter vos clés à personne ; -A prête l’usage en direct de vos clés à la machine à laquelle vous vous êtes connecté. Ce n’est pas le même compromis.
Contrôle de session
Les petites options qui corrigent des désagréments précis.
-t— forcer un pseudo-terminal. Nécessaire pour une commande distante qui attend un TTY interactif :ssh -t host 'sudo systemctl status nginx'vous donne un vrai terminal pour l’invitesudoet la sortie colorée. Doublez-la (-tt) pour en forcer un quand il n’y a pas de TTY local.-q— mode silencieux. Supprime les avertissements et les bannières ; utile dans les scripts où vous ne voulez que la sortie propre de la commande.-C— demander la compression. Un vrai gain sur les liens lents et à forte latence ; négligeable ou légèrement négatif sur un réseau local rapide.-o BatchMode=yes— ne jamais demander. Si l’authentification nécessitait un mot de passe ou une phrase secrète, échouer immédiatement au lieu de rester bloqué. C’est ce qui rend SSH sûr dans cron et la CI — une invite bloquée dans un script sans surveillance reste bloquée indéfiniment.
Quel port SSH utilise-t-il ?
SSH utilise le port TCP 22 par défaut — c’est ce que supposent ssh, scp, sftp et git-sur-SSH quand vous ne dites rien. Pour atteindre un serveur qui écoute ailleurs, passez le port avec -p :
ssh -p 2222 user@host
Pour changer le port sur lequel écoute le serveur, définissez Port dans /etc/ssh/sshd_config et redémarrez sshd — puis ouvrez le nouveau port à la fois dans le pare-feu de l’hôte et dans le groupe de sécurité du cloud avant de vous déconnecter, car déplacer SSH sans autoriser le nouveau port est le moyen le plus rapide de vous enfermer dehors. (Quitter le 22 fait taire les scanners de passage ; ce n’est pas en soi une vraie sécurité.) Définissez-le une fois par hôte dans votre ssh_config (en anglais) sous la forme Port 2222 et vous ne taperez plus jamais -p.
Comment exécuter une commande via SSH sans shell
Placez la commande entre guillemets après l’hôte : SSH l’exécute, affiche la sortie et quitte — aucun shell interactif ne s’ouvre :
ssh user@host 'df -h /'
ssh user@host 'systemctl is-active nginx'
C’est l’ossature des scripts et de cron : une connexion, une commande, un code de sortie que vous pouvez tester. Mettez la commande entre guillemets pour que votre shell local ne la développe pas d’abord. Deux options comptent ici :
-tforce un TTY pour une commande qui en a besoin —ssh -t user@host 'sudo systemctl restart nginx'donne àsudoune vraie invite interactive.-o BatchMode=yes(ou-n) l’empêche d’attendre une saisie, de sorte qu’une tâche sans surveillance échoue vite au lieu de rester bloquée sur une invite.
Comment quitter une session SSH
Tapez exit, ou appuyez sur Ctrl-D, pour fermer le shell et couper la connexion. Les deux envoient une fin de fichier au shell distant, ce qui vous déconnecte et vous ramène à votre invite locale :
exit # ou appuyez sur Ctrl-D
Quand une session est gelée — le lien est tombé et le terminal ignore tout, même Ctrl-C — exit ne peut rien, car rien de ce que vous tapez n’atteint l’autre bout. Utilisez plutôt la séquence d’échappement propre à SSH : appuyez sur Entrée, puis tapez ~. (tilde, puis point). Cela indique à votre ssh local de démolir la connexion sur-le-champ, aussi coincé que soit le côté distant. L’échappement ~ n’est lu qu’immédiatement après un saut de ligne, d’où l’appui sur Entrée au préalable.
La référence compacte
| Option | Effet | Équivalent ssh_config |
|---|---|---|
-p 2222 | Port non standard | Port 2222 |
-l user / user@ | Utilisateur de connexion | User user |
-i ~/.ssh/key | Identité précise | IdentityFile ~/.ssh/key |
-F file | Autre fichier de configuration | — (c’est lui, la configuration) |
-v … -vvv | Verbeux / débogage | LogLevel DEBUG3 |
-o Opt=val | N’importe quelle option de config en ligne | (l’option elle-même) |
-L a:host:b | Redirection locale | LocalForward a host:b |
-R a:host:b | Redirection distante | RemoteForward a host:b |
-D 1080 | Redirection dynamique (SOCKS) | DynamicForward 1080 |
-N | Pas de commande distante | RequestTTY no (+ aucune commande) |
-f | En arrière-plan après connexion | — (ponctuel uniquement) |
-g | Ouvrir la redirection à votre réseau local | GatewayPorts yes |
-J host | Rebondir par un bastion | ProxyJump host |
-A | Rediriger l’agent | ForwardAgent yes |
-t | Forcer un TTY | RequestTTY force |
-q | Silencieux | LogLevel QUIET |
-C | Compression | Compression yes |
-o BatchMode=yes | Ne jamais demander | BatchMode yes |
La colonne de droite est révélatrice. Presque chaque option a un équivalent en configuration, et c’est tout le mode opératoire : utilisez l’option une fois pour prouver qu’une connexion fonctionne, puis déplacez celles que vous répéterez dans ~/.ssh/config, de sorte que ssh web1 les porte toutes sans aucune option. Les options sans équivalent en configuration — -f, -F, la verbosité de débogage — sont les seules vraiment ponctuelles.
Là où un client garde l’état pour vous
Les options comme la configuration vivent dans vos fichiers de configuration, machine par machine, et cela fait mal à grande échelle : réglages recopiés à la main d’un portable à l’autre, tunnels relancés après chaque mise en veille, aucun moyen de voir lequel de quarante hôtes est en ligne. Termalin garde les mêmes informations qu’une option transporterait — port, utilisateur, clé, hôte de rebond, keepalives, redirections locales/distantes/dynamiques enregistrées — rattachées à l’hôte sous forme de données structurées, organisées en dossiers et en étiquettes, synchronisées entre vos machines, chiffrées de bout en bout. Il vérifie chaque serveur à la première connexion, affiche le statut en direct par hôte, et démarre les tunnels avec la connexion au lieu d’une commande retapée. Les options vous apprennent ce qui se passe ; un client vous évite de les retaper chaque matin.
Termalin est un client SSH gratuit et multiplateforme qui stocke pour vous les réglages, les clés et les tunnels propres à chaque hôte — téléchargez-le, ou lisez comment il gère vos clés en toute sécurité.