Provision
—— XP

SSH на каждый день: конфиг и отладка входа

теория~6 минут+120 XP

Через неделю работы с несколькими серверами история терминала превращается в свалку строк вида ssh -i ~/.ssh/id_work -p 2222 deploy@203.0.113.15. Какой ключ к какому серверу, на каком порту ждёт SSH, под каким пользователем заходить — запомнить это невозможно, а ошибиться легко.

Порядок наводит ~/.ssh/config — файл настроек клиента SSH на твоей машине. В нём каждый сервер описывается один раз: адрес, пользователь, порт, ключ, — а дальше подключаешься коротким именем, как звонишь по имени из контактов, не набирая номер. Тот же конфиг читают scp, rsync, Git и Ansible, так что одна запись работает сразу везде. Заодно в уроке разберём две вещи, которые встречаются каждую неделю: громкое предупреждение о смене ключа сервера и отказ во входе.

Шаг 1. Описать сервер в конфиге

Файл ~/.ssh/config по умолчанию не существует, его создают руками в любом редакторе.

своя машина · ~/.ssh/config
Host stand
    HostName 192.168.1.50
    User anton

Host — короткое имя, которое ты придумал сам. HostName — настоящий адрес. User — под кем входить: без этой строки клиент возьмёт имя пользователя на твоей машине, а на сервере его может не быть.

своя машина
ssh stand
anton@stand:~$

Трёх строк хватает для работы. Когда ключей у тебя станет несколько, к ним добавляют ещё две:

своя машина · ~/.ssh/config, в блок stand
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

IdentityFile — какой ключ предлагать. IdentitiesOnly yes — предлагать только его. Без этой строки клиент сначала перебирает все ключи, которые держит в памяти ssh-agent (о нём ниже), и сервер может оборвать соединение после шести неудачных попыток с ошибкой Too many authentication failures. Одна IdentityFile без IdentitiesOnly от этого не спасает: ключи из агента всё равно идут первыми.

Одно слово вместо адреса. Работает и для копирования: scp файл stand:/tmp/.

Ещё две строки, которые часто добавляют в тот же блок:

своя машина · ~/.ssh/config
    Port 2222                    # если sshd слушает не 22-й
    ServerAliveInterval 60       # не рвать сессию при простое

ServerAliveInterval 60 раз в минуту шлёт серверу пустой пакет, и сессия не отваливается, пока ты читаешь документацию.

Если на ключе стоит passphrase, вводить её при каждом входе утомительно. Для этого есть ssh-agent — программа, которая держит расшифрованный ключ в памяти до конца сеанса. На Mac и в Ubuntu с рабочим столом он уже запущен, ключ ему отдают одной командой, и passphrase спросят один раз:

своя машина
ssh-add ~/.ssh/id_ed25519
Identity added: /home/anton/.ssh/id_ed25519 (anton@laptop)

Если вместо этого Could not open a connection to your authentication agent, агент в этом терминале не запущен — тогда просто вводи passphrase при входе, для учёбы этого хватает.

Теперь о том, что конфиг спасти не может: о самом сервере, который вдруг «поменялся».

known_hosts: как клиент узнаёт сервер

При первом подключении SSH спрашивает, доверяешь ли ты этому серверу, и запоминает его ключ в файле ~/.ssh/known_hosts.

ubuntu@stand:~$
The authenticity of host '192.168.1.50' can't be established.
ED25519 key fingerprint is SHA256:Xq3v...kP0.
Are you sure you want to continue connecting (yes/no)? yes

Это как узнавание голоса по телефону: первый раз веришь на слово, дальше голос запомнен. При каждом следующем входе клиент сверяет ключ, и если он другой — выдаёт предупреждение на пол-экрана.

ubuntu@stand:~$
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Причины две: сервер переустановили (обычно) или кто-то встал между тобой и сервером (редко, но именно ради этого случая предупреждение такое громкое). Сначала выясни у коллег, пересоздавали ли машину, и только потом удаляй старую запись.

своя машина
ssh-keygen -R 192.168.1.50      # -R — удалить запись о хосте
# Host 192.168.1.50 found: line 3
/home/anton/.ssh/known_hosts updated.

Следующий вход снова спросит «доверяешь?», и новый ключ запомнится.

Предупреждение о смене ключа хотя бы объясняет себя громко, а отказ во входе обычно выглядит как сухое Permission denied (publickey), по которому причину не угадать.

Шаг 2. Почему не пускает: ssh -v

Флаг -v (verbose, «подробно») включает рассказ клиента о каждом шаге входа. Вывод длинный, поэтому оставляем только важные строки фильтром grep, о котором подробно — в уроке после практики. Слово exit в конце — команда, которую SSH выполнит на сервере вместо открытия сессии: без него клиент войдёт и будет молча ждать твоих команд, а grep — его вывода, и экран покажется зависшим.

своя машина
ssh -v stand exit 2>&1 | grep -i auth
debug1: Authentications that can continue: publickey,password
debug1: Offering public key: /home/anton/.ssh/id_ed25519
debug1: Authentication succeeded (publickey).

2>&1 нужен потому, что подробный рассказ SSH пишет в поток ошибок, а grep читает только обычный вывод. Флаг -i у grep — искать без учёта регистра.

Как читать строки:

  • Authentications that can continue — что сервер готов принять. Нет publickey — вход по ключу на сервере выключен.
  • Offering public key — клиент предложил ключ. Нет такой строки — проверь IdentityFile.
  • Authentication succeeded (publickey) — всё хорошо.
  • Permission denied (publickey) — ключ предложен, но не подошёл: его нет в authorized_keys или каталог ~/.ssh на сервере доступен на запись посторонним.

Есть у SSH и другие умения, которые пригодятся позже: зайти на закрытый сервер через промежуточный (ProxyJump, его ещё называют бастионом) и пробросить порт, чтобы открыть у себя базу, которая слушает только сервер (ssh -L 5432:localhost:5432 stand). Сейчас достаточно знать, что такое есть; вернёмся к этому в разделе про базы данных.

Словарь урока

~/.ssh/config
Файл настроек клиента: короткое имя сервера, адрес, пользователь, порт и ключ.
known_hosts
Файл на твоей машине с запомненными ключами серверов. Несовпадение даёт громкое предупреждение.
ssh -v
Подробный режим клиента: показывает, какой ключ предложен и что ответил сервер.
бастион
Промежуточный сервер, через который ходят на машины во внутренней сети. В конфиге — ProxyJump. ↩ к тексту

Что спросят на собеседовании

  • Что делать с предупреждением о смене ключа хоста?
    Выяснить причину: если сервер действительно пересоздавали — удалить старую запись ssh-keygen -R и подключиться заново. Если не пересоздавали — не подключаться, это может быть перехват.
  • Как понять, почему не пускает по ключу?
    ssh -v: видно, какие методы принимает сервер, какой ключ предложен и ответ. Дальше — права и authorized_keys на сервере, журнал sshd.
  • Как зайти на сервер без внешнего адреса?
    Через бастион: ProxyJump в конфиге или флаг -J. Ключи остаются на клиенте и на бастион не копируются.

Что дальше

В практике ты сделаешь всё это на своём стенде: ключ, права, запись в конфиге и проверку, что вход идёт именно по ключу.

Проверь себя+120 XPдве попытки
1
~/.ssh/config
Что даёт блок Host stand в файле ~/.ssh/config?
2
known_hosts
SSH пишет «REMOTE HOST IDENTIFICATION HAS CHANGED». Что это значит?
3
Отладка входа
Не пускает по ключу. Что запускают первым делом?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.