Как ssh читает этот файл
Порядок источников: параметры командной строки, потом ~/.ssh/config, потом общий /etc/ssh/ssh_config.
Внутри файла ssh идёт сверху вниз по блокам Host, подходящим к имени, и для каждого параметра
берёт первое значение. Поэтому:
- блоки конкретных серверов — наверху;
Host *с общими настройками — последним, иначе он перекроет всё ниже;- одно имя может попасть в несколько блоков:
web1подходит и кHost web1, и кHost *.
Что получилось для конкретного имени, показывает ssh -G: он разбирает файл и печатает итог, никуда
не подключаясь.
Файл — ~/.ssh/config, на Windows — C:\Users\<имя>\.ssh\config. Тильда в путях работает и там.
Файл по блокам
Имена серверов и адреса — условные: web1, web2, db1, backup1, адреса — из диапазонов для документации.
Include ~/.ssh/config.d/*Подключаем файлы из каталога: так конфиг рабочих серверов живёт отдельным файлом, и его можно держать в другом репозитории или не показывать. Include должен стоять до первого Host — внутри блока он действует только для этого блока.
по умолчанию ничего не подключается
Host web1
HostName 203.0.113.10
User example-user
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yesКороткое имя вместо адреса, пользователя и ключа. IdentitiesOnly yes — предлагать серверу только этот ключ, а не все из агента подряд: иначе при пяти ключах в агенте сервер с MaxAuthTries 3 порвёт соединение раньше, чем дойдёт до нужного («sshd_config»).
по умолчанию:User имя на компьютереPort 22IdentitiesOnly no
Host web2 db1 backup1
HostName %h.example.org
User example-user
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yesНесколько имён в одной строке — общие настройки для группы серверов. Адрес у каждого свой, поэтому HostName — в отдельных блоках выше или в config.d. %h — имя, которое написали в команде.
Host github-infra
HostName github.com
User git
IdentityFile ~/.ssh/github_infra
IdentitiesOnly yesПсевдоним для GitHub с отдельным ключом: deploy key открывает один репозиторий («Конфиги серверов в git», «Каждый ключ и токен — на один доступ»). В git адрес пишем через псевдоним: git@github-infra:example-user/infra-web1.git. Пользователь у GitHub всегда git.
Host db-internal
HostName 10.0.0.5
User example-user
ProxyJump web1Сервер без внешнего адреса — через первый. ProxyJump открывает соединение до web1, а через него — до 10.0.0.5; ключ остаётся на компьютере, на промежуточный сервер он не попадает. В командной строке то же — ssh -J web1 [email protected].
по умолчанию напрямую
Host *
ServerAliveInterval 30
ServerAliveCountMax 3Раз в 30 секунд клиент шлёт серверу пустой пакет; три пропущенных ответа подряд — соединение закрыто. Так NAT домашнего роутера не забывает тихую сессию, а мёртвая не висит минутами.
по умолчанию:ServerAliveInterval 0 — не слатьServerAliveCountMax 3
AddKeysToAgent yesКлюч с паролем при первом использовании попадает в агент, и пароль больше не спрашивается до конца сеанса агента («ssh-agent»). Нужен работающий агент: на Windows — служба ssh-agent.
по умолчанию no
StrictHostKeyChecking askНеизвестный сервер — вопрос yes/no с отпечатком; изменившийся ключ — отказ. accept-new молча принимает только новые серверы, на смену ключа всё равно ругается — подходит для скриптов, которые ходят на свежие машины. В клиенте Ubuntu общий конфиг ещё и хэширует имена в known_hosts (HashKnownHosts yes): файл не выдаёт список серверов, но и читать его глазами нельзя.
по умолчанию:StrictHostKeyChecking askHashKnownHosts no (в Ubuntu — yes)
Host web1 web2 db1 backup1
ControlMaster auto
ControlPath ~/.ssh/cm/%C
ControlPersist 10mОбщее соединение: первое ssh web1 держит канал, следующие ssh, scp, git идут по нему без нового входа — вторая сессия открывается мгновенно. Только Linux и macOS. Каталог ~/.ssh/cm создаём заранее, права 700.
по умолчанию no
ForwardAgent yesПересылку агента не включаем ни для Host *, ни для своих серверов: root на сервере может подписывать агентом что угодно, пока сессия открыта. Для прыжка через сервер есть ProxyJump («ssh-agent»).
по умолчанию no
Подстановки в значениях
| Код | Что подставляется |
|---|---|
%h |
имя хоста после замены HostName; в строке HostName — имя из команды |
%n |
имя ровно как написали в команде |
%r |
пользователь на сервере |
%p |
порт |
%C |
хэш от %l%h%p%r — короткое имя для сокета ControlPath |
%d |
домашний каталог на компьютере |
Если не работает
Настройка из блока хоста не действует
- Причина
- Выше в файле стоит
Host *или другой подходящий блок с той же настройкой — а действует первое значение. - Делаем
ssh -G web1 | grep -i <настройка>покажет итог. Блоки конкретных хостов — вверх,Host *— в самый конец.
Bad owner or permissions on /home/me/.ssh/config
- Причина
- Файл доступен на запись группе или остальным.
- Делаем
chmod 600 ~/.ssh/config.
На Windows с ControlMaster соединение не устанавливается
- Причина
- OpenSSH для Windows не умеет общее соединение через Unix-сокет: с любым
ControlPathssh падает —getsockname failed: Not a socket, затемRead from remote host …: Unknown error. - Делаем
- Блок
ControlMasterдержим только в конфиге Linux и macOS или подMatch exec, который на Windows не срабатывает.
git clone git@github-infra:… — Could not resolve hostname github-infra
- Причина
- Git запускает
ssh, который читает другой конфиг: например, Git for Windows со своимssh.exeи другимHOME. - Делаем
- Указываем git, какой
sshбрать:git config --global core.sshCommand C:/Windows/System32/OpenSSH/ssh.exe, и проверяемssh -G github-infra.
Через ProxyJump — channel 0: open failed: administratively prohibited
- Причина
- На промежуточном сервере
AllowTcpForwarding no, а прыжок идёт через проброс. - Делаем
- Разрешаем проброс на нём:
AllowTcpForwarding yes, или хотя быMatch User example-userс этой строкой.
Как проверить
ssh -G разбирает файл для имени и печатает итог, не подключаясь. Для web1 из файла выше:
ssh -G web1 | grep -E '^(hostname|user|port|identityfile|identitiesonly|serveraliveinterval) '
# user example-user
# hostname 203.0.113.10
# port 22
# identitiesonly yes
# serveraliveinterval 30
# identityfile ~/.ssh/id_ed25519
Прыжок через сервер — какой путь выберет ssh:
ssh -G db-internal | grep -i '^proxyjump'
# proxyjump web1
Псевдоним для git:
ssh -T github-infra
# Hi example-user/infra-web1! You've successfully authenticated, but GitHub does not provide shell access.