Secure Pipes

~/.ssh/config

Enregistrer les options récurrentes dans la configuration du client.

Avant de commencer

Le premier bloc est le contenu d’un fichier, pas une commande : modifiez ~/.ssh/config localement. La première valeur obtenue prévaut généralement ; placez les blocs Host précis avant les valeurs générales Host *. Protégez le fichier, typiquement avec chmod 600 ~/.ssh/config. N’y mettez ni mots de passe ni contenu de clés privées. ServerAlive détecte l’absence de réponse du pair SSH, pas toutes les pannes applicatives. ssh -G affiche la configuration effective sans connexion et peut révéler des adresses internes ou des chemins.

Exemples

Définir l’alias lab avec port, clé et maintien de connexion SSH.

Host lab
    HostName server.example.com
    User alice
    Port 2222
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
    ServerAliveInterval 30
    ServerAliveCountMax 3

Se connecter via l’alias ou consulter sa configuration effective.

ssh lab
ssh -G lab

Options et exemples

Host patternCourant

Démarrez un bloc correspondant à un alias SSH ou à un modèle d'hôte. Placer les blocs spécifiques avant les blocs généraux : la première valeur obtenue est utilisée.

Exemple
Host lab
    HostName server.example.com
HostName / User / PortCourant

Définissez l'adresse réelle du serveur, le nom de connexion et le port SSH pour l'hôte correspondant.

Exemple
Host lab
    HostName server.example.com
    User alice
    Port 2222
IdentityFile / IdentitiesOnlyCourant

Sélectionnez une clé privée et, lorsqu'elle est définie sur oui, limitez les identités proposées à celles configurées.

Exemple
Host lab
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
ProxyJumpCourant

Connectez-vous via un ou plusieurs hôtes de saut SSH.

Exemple
Host lab
    ProxyJump alice@bastion.example.com
LocalForward

Configurez un écouteur local transféré vers une destination atteinte depuis le serveur SSH.

Exemple
Host lab
    LocalForward 127.0.0.1:15432 db.internal.example.com:5432
RemoteForward

Configurez un écouteur distant transféré vers une destination atteinte depuis l'ordinateur local ; la politique du serveur s’applique.

Exemple
Host lab
    RemoteForward 127.0.0.1:18080 127.0.0.1:8080
DynamicForward

Configurez un écouteur SOCKS local. Les clients doivent être configurés séparément.

Exemple
Host lab
    DynamicForward 127.0.0.1:1080
ExitOnForwardFailure

Échec de la connexion SSH si les écouteurs de transfert initiaux demandés ne peuvent pas être établis.

Exemple
Host lab
    ExitOnForwardFailure yes
ServerAliveInterval / ServerAliveCountMaxCourant

Configurez les vérifications par les pairs au niveau SSH et le nombre de vérifications sans réponse avant de vous déconnecter.

Exemple
Host lab
    ServerAliveInterval 30
    ServerAliveCountMax 3
ConnectTimeout

Définissez le délai d'expiration de la connexion en secondes.

Exemple
Host lab
    ConnectTimeout 10
ForwardAgent

Transfert d'agent de contrôle. Un hôte distant compromis peut demander des signatures ; activer uniquement pour les hôtes de confiance.

Exemple
Host lab
    ForwardAgent no
Include

Incluez des fichiers de configuration SSH supplémentaires ; l’ordre affecte les valeurs sélectionnées.

Exemple
Include ~/.ssh/config.d/*.conf

Références officielles

Vérifié le 27 octobre 2026