termal.in

← Блог

Файл ~/.ssh/config: перестаньте набирать одни и те же флаги SSH

· обновлено 12 нояб. 2026 г. · Termalin Team sshssh-configproductivitytutorial

Короткий ответ: создайте ~/.ssh/config (и выполните для него chmod 600), затем опишите каждый сервер блоком Host с HostName, User, Port и IdentityFile — теперь ssh web1 разворачивается в целую команду, и scp, sftp, rsync и git читают тот же алиас. Побеждает первое совпадение, поэтому конкретные хосты ставьте сверху, а широкие умолчания Host * — в самый низ. ProxyJump дотягивается до хоста за бастионом; ServerAliveInterval 30 не даёт простаивающим сессиям отваливаться; IdentitiesOnly yes закрепляет один ключ, чтобы строгий сервер вас не отрезал.

Если вы хоть раз набирали ssh -i ~/.ssh/work_ed25519 -p 2222 -o ServerAliveInterval=30 deploy@203.0.113.10 больше двух раз, вы уже окупили те десять минут, что уходят на знакомство с ssh_config. Это самый выгодный по отдаче файл во всей вашей настройке SSH: он превращает всю эту строку в ssh web1, и его автоматически читают ssh, инструменты передачи файлов scp/sftp/rsync, git и всё остальное, что вызывает SSH.

Вот практический обзор — директивы, которые действительно не зря занимают место, и ловушки, о которых стоит знать.

Где он лежит и как читается

Ваш личный конфиг — ~/.ssh/config (создайте его, если нет; chmod 600). Есть ещё системный /etc/ssh/ssh_config. Правила, на которых спотыкаются:

  • Побеждает первое совпадение, а не самое конкретное. SSH читает сверху вниз, и для каждого параметра используется первое встреченное значение. Конкретные хосты ставьте наверх, а широкие умолчания Host * — вниз.
  • Каждый параметр живёт внутри блока Host (шаблона), с отступом по договорённости (отступ не обязателен, но ваш будущий „я“ скажет спасибо за читаемый файл).

Строительный кирпичик: алиас хоста

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

Теперь ssh web1 разворачивается в полную команду. То же самое с scp file.tar web1:/srv/, sftp web1 и rsync -a ./dist/ web1:/var/www/. В алиасе весь смысл: назовите сервер один раз — и пользуйтесь этим именем везде.

Директивы, которые не зря занимают место

ProxyJump — доступ к серверам через бастион. Современная замена старому заклинанию ProxyCommand ... netcat:

Host db1
    HostName 10.0.0.5          # приватный адрес, доступный только с бастиона
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump

Теперь ssh db1 прозрачно прыгает через bastion к хосту без публичного адреса. Для более глубоких сетей связывайте их через запятую (ProxyJump a,b,c).

Keepalive — не дать простаивающим сессиям умирать. Лекарство от client_loop: send disconnect: Broken pipe, когда вы отвлеклись:

Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4

Пакет раз в 30 секунд не даёт NAT-роутерам и файрволам забыть про ваше соединение; четыре пропущенных ответа (две минуты) — и клиент сдаётся.

IdentitiesOnly — предлагать только нужный ключ. Если вы носите с собой несколько ключей, SSH предлагает их все, и строгий сервер отвечает Too many authentication failures. Закрепите по одному ключу на хост и прекратите перебор:

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

AddKeysToAgent — разблокировать защищённый парольной фразой ключ один раз:

Host *
    AddKeysToAgent yes

Шаблоны и подстановочные символы — настроить целый парк одним блоком:

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

Host 10.0.*
    ProxyJump bastion

Реалистичный конфиг, сверху вниз

# Сначала конкретные хосты (побеждает первое совпадение)
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

# Широкие умолчания — в конце
Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4
    AddKeysToAgent yes

Разбивайте его по мере роста: Include ~/.ssh/config.d/* в начале файла позволяет держать по одному файлу на проект или клиента.

Две ловушки

  • „Побеждает первое совпадение“ подставит вас, когда блок Host * где-то наверху задаёт значение, которое вы собирались переопределить ниже, — переопределения не будет, потому что раннее значение уже победило. Умолчания идут в самый низ.
  • Комментарии — это # в начале строки. Концевые комментарии после значения для некоторых параметров могут попасть в само значение — держите комментарии на отдельных строках.

Когда файла конфигурации уже мало

ssh_config прекрасен, и он должен быть у каждого. Его пределы проявляются, когда настройка перерастает текстовый файл: вы синхронизируете его между машинами вручную, делитесь с коллегами вычищенными версиями, вспоминаете, какая парольная фраза к какому ключу, или пытаетесь с одного взгляда понять, какой из сорока хостов вообще в сети.

Этот шов и закрывает Termalin. Он хранит те же настройки для каждого хоста — имя хоста, пользователь, порт, ключ, jump-хост, keepalive, — но привязанными к хосту как структурные данные, которые вы раскладываете по папкам и тегам; разблокирует ваши ключи один раз через встроенный агент; проверяет каждый сервер при первом подключении и показывает живой статус для каждого хоста в списке. Он импортирует ваши сессии из PuTTY, а список хостов синхронизируется между машинами со сквозным шифрованием. Файл масштабируется до какого-то предела; клиент, который хранит состояние за вас, идёт дальше.

Так или иначе, принцип один: назовите сервер один раз — и больше никогда не набирайте его флаги командной строки заново.


Termalin — бесплатный кроссплатформенный SSH-клиент, который ведёт настройки хостов, ключи и jump-хосты за вас, — скачайте его или почитайте, как он безопасно обращается с ключами.

Попробуйте на одном хосте.

Termalin — быстрый SSH-клиент для вас и ваших агентов.

Бесплатный тариф · 14 дней Pro бесплатно · цены

Добавьте Termalin в предпочитаемые источники в Google