Поиск
Справочник

Файл ~/.ssh/config: короткие имена для нескольких серверов

Файл ~/.ssh/config на вашем компьютере хранит адрес, пользователя, порт и ключ для каждого сервера. Вместо длинной команды с адресом, портом и ключом хватает ssh myvps.

≈ 5 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Откройте файл config на своём компьютере. Mac и Linux: nano ~/.ssh/config (файла нет — nano его создаст). Windows: файл C:\Users\ВашеИмя\.ssh\config, как его создать, рассказано в статье как подключиться по SSH.
  2. Впишите блоки, как в примере ниже: по одному Host на сервер, общие строки — в Host * в самом конце файла. Сохраните.
  3. Mac и Linux: закройте файл от чужих: chmod 600 ~/.ssh/config. Если файл может менять кто-то кроме вас, ssh откажется его читать с ошибкой Bad owner or permissions.
  4. Проверьте, что понял ssh: ssh -G myvps | grep -E '^(hostname|user|port) '. В Windows (PowerShell): ssh -G myvps | Select-String '^(hostname|user|port) '.
  5. Подключитесь: 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 vps1myvps и 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

Подробнее о командах — scp и rsync.

Как проверить

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 myvpsssh не нашёл блок Host myvpsсверьте имя после Host и путь к файлу, затем ssh -G
Too many authentication failuresssh перебирает все ключи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 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше