termal.in

← Blog

Le fichier ~/.ssh/config : arrêtez de retaper les mêmes options SSH

· mis à jour 12 nov. 2026 · Termalin Team sshssh-configproductivitytutorial

Réponse rapide. Créez ~/.ssh/config (et faites-en un chmod 600), puis donnez à chaque serveur un bloc Host avec HostName, User, Port et IdentityFile — désormais ssh web1 se déploie en toute la commande, et scp, sftp, rsync et git lisent le même alias. La première correspondance l’emporte : placez les hôtes précis en premier et les valeurs par défaut larges Host * en dernier. ProxyJump atteint un hôte derrière un bastion ; ServerAliveInterval 30 empêche les sessions inactives de tomber ; IdentitiesOnly yes fixe une seule clé pour qu’un serveur strict ne vous coupe pas l’accès.

Si vous avez déjà tapé ssh -i ~/.ssh/work_ed25519 -p 2222 -o ServerAliveInterval=30 deploy@203.0.113.10 plus de deux fois, vous avez déjà rentabilisé les dix minutes qu’il faut pour apprendre ssh_config. C’est le fichier au plus fort effet de levier de toute votre installation SSH : il transforme cette ligne entière en ssh web1, et il est lu automatiquement par ssh, les outils de transfert de fichiers scp/sftp/rsync (en anglais), git, et tout ce qui délègue à SSH.

Voici le tour pratique — les directives qui méritent vraiment leur place, et les pièges à connaître.

Où il se trouve et comment il est lu

Votre configuration personnelle est ~/.ssh/config (créez-la si elle n’existe pas ; chmod 600). Il existe aussi un /etc/ssh/ssh_config valable pour tout le système. Les règles qui font trébucher :

  • La première correspondance l’emporte, pas la plus précise. SSH lit de haut en bas et la première valeur qu’il voit pour chaque option est celle qu’il retient. Placez vos hôtes précis en haut et les valeurs par défaut larges Host * en bas.
  • Chaque réglage vit sous un bloc Host (un motif), indenté par convention (l’indentation n’est pas obligatoire, mais le fichier que vous relirez plus tard vous en remerciera).

La brique de base : un alias d’hôte

Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

Désormais, ssh web1 se déploie en la commande complète. Idem pour scp file.tar web1:/srv/, sftp web1 et rsync -a ./dist/ web1:/var/www/. Tout l’intérêt de l’alias est là : nommez le serveur une fois, utilisez le nom partout.

Les directives qui méritent leur place

ProxyJump — atteindre des serveurs à travers un bastion. Le remplaçant moderne de la vieille incantation ProxyCommand ... netcat :

Host db1
    HostName 10.0.0.5          # private address, only reachable from the bastion
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump

ssh db1 rebondit désormais de façon transparente par bastion pour atteindre un hôte sans adresse publique. Enchaînez-les avec des virgules (ProxyJump a,b,c) pour des réseaux plus profonds.

Keepalives — empêcher les sessions inactives de mourir. Le correctif pour client_loop: send disconnect: Broken pipe quand vous regardez ailleurs :

Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4

Un paquet toutes les 30 secondes empêche les routeurs NAT et les pare-feu d’oublier votre connexion ; quatre réponses manquées (deux minutes) avant qu’il n’abandonne.

IdentitiesOnly — ne proposer que la bonne clé. Si vous transportez plusieurs clés, SSH les propose toutes et un serveur strict répond Too many authentication failures. Fixez une clé par hôte et mettez fin au tâtonnement :

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

AddKeysToAgent — déverrouiller une clé protégée par phrase secrète une seule fois :

Host *
    AddKeysToAgent yes

Motifs et jokers — configurer tout un parc en un seul bloc :

Host *.staging.example.com
    User deploy
    IdentityFile ~/.ssh/staging_ed25519

Host 10.0.*
    ProxyJump bastion

Une configuration réaliste, de haut en bas

# Specific hosts first (first match wins)
Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

Host db1
    HostName 10.0.0.5
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump
    IdentityFile ~/.ssh/work_ed25519

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

# Broad defaults last
Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4
    AddKeysToAgent yes

Découpez-la à mesure qu’elle grandit : Include ~/.ssh/config.d/* en haut du fichier vous permet de garder un fichier par projet ou par client.

Deux pièges

  • « La première correspondance l’emporte » vous piège quand un bloc Host * placé en haut fixe une valeur que vous comptiez redéfinir plus bas — la redéfinition n’aura pas lieu, car la valeur antérieure a déjà gagné. Les valeurs par défaut vont en bas.
  • Les commentaires sont des # en début de ligne. Sur certaines options, un commentaire en fin de ligne après une valeur peut être interprété comme faisant partie de la valeur — gardez les commentaires sur leur propre ligne.

Quand le fichier de configuration ne suffit plus

ssh_config est excellent et tout le monde devrait en avoir un. Ses limites apparaissent quand l’installation dépasse ce qu’un fichier texte sait porter : vous le synchronisez à la main d’une machine à l’autre, vous partagez des versions expurgées avec vos collègues, vous essayez de retenir quelle phrase secrète va avec quelle clé, ou de voir d’un coup d’œil lequel de vos quarante hôtes est seulement en ligne.

C’est la jointure que comble Termalin. Il conserve les mêmes réglages par hôte — nom d’hôte, utilisateur, port, clé, hôte de rebond (bastion), keepalives — mais rattachés à l’hôte sous forme de données structurées que vous organisez en dossiers et en étiquettes, déverrouille vos clés une seule fois via un agent intégré, vérifie chaque serveur à la première connexion, et affiche l’état en direct de chaque hôte de la liste. Il importe vos sessions PuTTY existantes, et sa liste d’hôtes se synchronise entre vos machines, chiffrée de bout en bout. Le fichier passe à l’échelle jusqu’à un certain point ; un client qui garde l’état à votre place va au-delà.

Dans tous les cas, le principe tient : nommez un serveur une fois, et ne retapez plus jamais ses options en ligne de commande.


Termalin est un client SSH gratuit et multiplateforme qui gère pour vous les réglages par hôte, les clés et les hôtes de rebond — téléchargez-le, ou lisez comment il gère les clés en toute sécurité.

Essayez-le sur un hôte.

Termalin est un client SSH rapide pour vous — et pour vos agents.

Offre gratuite · 14 jours d’essai Pro · tarifs

Ajouter Termalin comme source préférée sur Google