Как настроить ~/.ssh/config — короткие имена серверов вместо длинных команд

Ты третий раз за день набираешь ssh -i ~/.ssh/work_key -p 2222 [email protected]. И третий раз путаешь порт.
А можно набирать ssh prod. Всё остальное SSH возьмёт из одного текстового файла. Сейчас настроим его за пять минут.
И по дороге разберём ловушку, из-за которой у многих конфиг «не работает», хотя написан правильно.
Что это за файл
~/.ssh/config — это записная книжка SSH. Для каждого сервера ты один раз пишешь: адрес, имя пользователя, порт, ключ. Потом обращаешься к серверу по короткому имени.
Это обычный текстовый дотфайл в папке .ssh твоего домашнего каталога. Если ты ещё не знаком с SSH, сначала загляни в разбор что такое SSH.
Пошагово: настраиваем первый сервер
-
Создай файл и закрой его от чужих.
mkdir -p ~/.ssh touch ~/.ssh/config chmod 600 ~/.ssh/configchmod 600— читать и писать можешь только ты. SSH строг к правам на свои файлы, лучше сразу сделать правильно. -
Опиши сервер блоком
Host. Открой файл в любом редакторе и добавь:Host prod HostName 203.0.113.7 User deploy Port 2222 IdentityFile ~/.ssh/work_keyHost— короткое имя, которое ты придумал.HostName— настоящий адрес. Остальное — то, что раньше было флагами команды. Отступы не обязательны, но с ними читать проще. -
Проверь, что SSH понял тебя. Не подключайся сразу — сначала спроси SSH, что он собирается сделать:
ssh -G prod | grep -E '^(user|hostname|port) 'Флаг
-Gничего не подключает. Он просто печатает итоговые настройки для этого имени. Должно бытьuser deploy,hostname 203.0.113.7,port 2222. -
Подключись.
ssh prodКороткое имя работает и в других программах поверх SSH:
scp file.txt prod:~/,rsync,git clone prod:repo.git, удалённая разработка в редакторе. -
Добавь общие настройки для всех серверов. Например, «пинг», чтобы соединение не обрывалось само:
Host * ServerAliveInterval 30*— это «любой сервер». И вот тут начинается ловушка.
Главная ловушка: первое совпадение побеждает
Интуиция подсказывает: общие настройки — наверх, частные — ниже, частные их «перекроют». В CSS так и работает.
В SSH — наоборот. Для каждого параметра SSH берёт первое найденное значение и дальше его не меняет.
Я проверил на живом конфиге:
Host *
User root
Port 2200
Host prod
HostName 203.0.113.7
User deploy
Port 22
ssh -G prod выдаёт user root и port 2200. Блок Host * стоит выше и успел «занять» эти параметры. Строки User deploy и Port 22 просто проигнорированы. Без всяких предупреждений.
Правило: конкретные сервера — наверху, Host * — в самом конце файла. Тогда общий блок заполнит только то, что ты не указал для сервера явно.
Вторая мелкая ловушка: имена в Host чувствительны к регистру. Блок Host prod не сработает на ssh PROD — SSH решит, что PROD и есть адрес сервера.
Что ещё полезно положить в конфиг
IdentitiesOnly yes— пробовать только ключ изIdentityFile. Спасает, когда у тебя много ключей и сервер отвечает «Too many authentication failures»: SSH перебрал все и упёрся в лимит попыток.- Несколько имён на один блок.
Host prod production— оба имени ведут на один сервер. - Шаблоны.
Host *.staging.example.comприменит настройки ко всем серверам с таким окончанием. ProxyJump bastion— подключиться к серверу через промежуточный. Одна строка вместо отдельного входа на bastion.LocalForward 5432 localhost:5432— пробросить порт. База данных на сервере становится доступна у тебя наlocalhost:5432, пока открыт SSH. Не нужно открывать её всему интернету.
Что получится
После настройки у тебя:
ssh prodвместо команды на полстроки;- ни одного забытого порта или не того ключа;
- одинаковое поведение в терминале,
scp,gitи редакторе; - проверка
ssh -G имяза секунду, если что-то идёт не так.
Частые вопросы
Как сделать то же самое на Windows?
В Windows 10 и 11 встроен OpenSSH, и файл лежит в C:\Users\имя\.ssh\config. Формат тот же, команды ssh -G и ssh prod работают в PowerShell.
Можно ли разбить конфиг на несколько файлов?
Да, директивой Include, например Include ~/.ssh/config.d/*. Ставь её в начало файла: иначе подключённые блоки окажутся внутри последнего Host выше.
Нужно ли перезапускать что-то после правки?
Нет. SSH читает файл заново при каждом подключении — сохранил и сразу пользуешься.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





