Файл ~/.ssh/config: короткие имена для нескольких серверов
Файл ~/.ssh/config на вашем компьютере хранит адрес, пользователя, порт и ключ для каждого сервера. Вместо длинной команды с адресом, портом и ключом хватает ssh myvps.
Содержание 9
Что сделать прямо сейчас
- Откройте файл config на своём компьютере. Mac и Linux:
nano ~/.ssh/config(файла нет — nano его создаст). Windows: файлC:\Users\ВашеИмя\.ssh\config, как его создать, рассказано в статье как подключиться по SSH. - Впишите блоки, как в примере ниже: по одному Host на сервер, общие строки — в
Host *в самом конце файла. Сохраните. - Mac и Linux: закройте файл от чужих:
chmod 600 ~/.ssh/config. Если файл может менять кто-то кроме вас, ssh откажется его читать с ошибкой Bad owner or permissions. - Проверьте, что понял ssh:
ssh -G myvps | grep -E '^(hostname|user|port) '. В Windows (PowerShell):ssh -G myvps | Select-String '^(hostname|user|port) '. - Подключитесь:
ssh myvps.
Host myvps
HostName 203.0.113.10
User ivan
Port 2222
IdentityFile ~/.ssh/id_ed25519
Host shop
HostName 198.51.100.20
User deploy
IdentityFile ~/.ssh/shop_ed25519
Host *
IdentitiesOnly yes
ServerAliveInterval 15Теперь ssh myvps войдёт на 203.0.113.10 под ivan через порт 2222, а ssh shop — на второй сервер со своим ключом. Строки из Host * действуют для обоих. Отступы нужны только для удобства чтения.
Как ssh выбирает значение
- ssh собирает настройки по порядку: ключи в самой команде, затем ваш ~/.ssh/config, затем общий /etc/ssh/ssh_config. Для каждой настройки берётся первое найденное значение.
- Поэтому блоки серверов ставьте в начало файла, а
Host *— в конец. ЕслиHost *со строкойUser rootстоит первым, root получат все серверы, иUser ivanниже уже ничего не поменяет. - Ключ в команде важнее файла:
ssh -p 22 myvpsпойдёт на порт 22, хотя в файле записан 2222. - Исключение — IdentityFile: несколько таких строк не перебивают друг друга, а добавляют ключи в список, который ssh попробует. Чтобы ssh не предлагал серверу лишние ключи из агента, нужна строка
IdentitiesOnly yes.
Шаблоны в Host
| Строка | Для каких имён |
|---|---|
Host myvps vps1 | myvps и vps1 — несколько имён через пробел |
Host *.example.com | все имена в домене: * — любые знаки |
Host web? | web1, web2, webA: ? — ровно один знак |
Host * !shop | все, кроме shop: ! — исключение |
Host сравнивается с именем, которое вы набрали в команде, а не с адресом из HostName. Для ssh 203.0.113.10 блок Host myvps не сработает.
Много серверов: Include
Блоки можно разнести по файлам — например, рабочие серверы отдельно от своих. Создайте папку mkdir -p ~/.ssh/config.d и в самом начале ~/.ssh/config напишите:
Include config.d/*Путь без / в начале ssh ищет в папке ~/.ssh. Строка Include должна стоять до первого Host: внутри блока Host файлы подключатся только для этого блока.
scp, rsync и sftp по короткому имени
Файл config читают все программы, которые ходят на сервер через ssh. Порт, пользователя и ключ они возьмут из файла:
scp site.zip myvps:/var/www/
rsync -av site/ myvps:/var/www/site/
sftp myvpsКак проверить
ssh -G имя никуда не подключается: она печатает, какие настройки ssh возьмёт для этого имени после всех блоков Host. Названия — маленькими буквами:
ssh -G myvps | grep -E '^(hostname|user|port) 'Ответ hostname myvps вместо адреса значит, что блок Host myvps не найден: опечатка в имени или файл лежит не там.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
/home/ivan/.ssh/config: line 7: Bad configuration option: hostnme и terminating, 1 bad configuration options | опечатка в названии строки | исправьте строку с этим номером |
Bad owner or permissions on /home/ivan/.ssh/config | файл могут менять другие | разбор ошибки |
Could not resolve hostname myvps | ssh не нашёл блок Host myvps | сверьте имя после Host и путь к файлу, затем ssh -G |
Too many authentication failures | ssh перебирает все ключи | IdentitiesOnly yes в блоке сервера, разбор ошибки |
| строка не действует | выше стоит Host * или другой подходящий блок с той же строкой | перенесите Host * в конец файла |
Источники
- man ssh_config — на английском: порядок чтения, первое значение, Host, шаблоны, Include, IdentityFile.
- man ssh — на английском: ключ -G печатает настройки для имени сервера.
- Исходный код OpenSSH 9.6: readconf.c — тексты Bad configuration option и Bad owner or permissions у команды ssh.
Сверено 23 октября 2026 года.
Что почитать дальше
- Как подключиться по SSHпервый файл config шаг за шагом.
- Смена порта SSHгде ещё указать новый порт.
- ClientAliveIntervalзачем нужен ServerAliveInterval.
- ssh-agentкак не вводить фразу от ключа.