Настройка sshd_config: ключевые директивы, готовые примеры и проверка синтаксиса через sshd -t | AdminWiki

Настройка sshd_config: ключевые директивы, готовые примеры и проверка синтаксиса через sshd -t

11 ноября 2026 10 мин. чтения

Зачем трогать sshd_config и как не потерять доступ

Демон sshd читает /etc/ssh/sshd_config при старте и при каждом reload. Файл определяет, на каком порту слушать, какие методы аутентификации разрешены, каким пользователям вход открыт и сколько попыток даётся на одно соединение. Правка этого файла — самый быстрый способ убрать вход root по паролю и сузить поверхность атаки на сервер.

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

Безопасный порядок правки: бэкап, проверка, reload

  1. Сохраните копию с датой в имени: cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak.$(date +%F-%H%M). Одна команда отката потом занимает пару секунд.
  2. Внесите правку в /etc/ssh/sshd_config.
  3. Проверьте синтаксис: sshd -t. Команда ничего не применяет, только парсит конфиг и проверяет ключи хоста. При ошибке вывод указывает файл и номер строки. Ненулевой код возврата — стоп, дальше не идём.
  4. Посмотрите, что реально применится: sshd -T. Это дамп эффективной конфигурации после обработки Include, дефолтов и Match-блоков.
  5. Откройте вторую сессию, не закрывая первую: ssh -v user@host. Убедитесь, что вход по ключу работает и порт слушается.
  6. Примените изменения: systemctl reload sshd на RHEL-семействе или systemctl reload ssh на Debian/Ubuntu (имя юнита отличается). Reload отправляет SIGHUP: демон перечитывает конфиг, уже установленные соединения при этом не рвутся.

Разница между reload и restart в аварийной ситуации решающая. systemctl restart sshd убивает все активные сессии, включая вашу, и если новый конфиг нерабочий, вернуться вы сможете только через консоль провайдера (KVM/IPMI) или физический доступ. Reload такой шаг не требует.

Правило, которое стоит закрепить в привычке: текущая сессия остаётся открытой до тех пор, пока новая не подтвердила вход. Консоль хостинга держите под рукой на первом применении.

Include и sshd_config.d: где реально применяется настройка

Для большинства директив OpenSSH использует первое встреченное значение и игнорирует последующие. Это правило зафиксировано в man-странице sshd_config: «Unless noted otherwise, for each keyword, the first obtained value will be used» (man sshd_config, Ubuntu). Поэтому строка Include /etc/ssh/sshd_config.d/*.conf в начале файла означает, что значения из drop-in файлов перебивают всё, что написано ниже. На Debian и Ubuntu такой Include присутствует по умолчанию — директивы Include размещены в начале конфигурационных файлов ssh и sshd, а дубликаты игнорируются именно из-за правила первого значения (обсуждение на Server Fault). На других дистрибутивах, включая RHEL 9, наличие Include и порядок подключения файлов проверяйте на конкретной машине через sshd -T и сам файл конфигурации.

Типичный сценарий: вы правите PasswordAuthentication в основном файле, а 50-cloud-init.conf или файл от provisioning-системы выставляет своё значение и побеждает. Глазами по файлу это не отлаживается. Отлаживается через sshd -T: он показывает итоговые значения, а не намерения. Полезно помнить и обратное: директивы, определённые до любого Include, имеют приоритет над подключаемым файлом, а включённый файл перебивает значения, заданные ниже строки Include (разбор на Baeldung).

Второй источник неожиданного поведения — блоки Match. Директивы внутри Match применяются только при совпадении условий (User, Group, Address, LocalPort). Увидеть, что применится для конкретного клиента, помогает sshd -T -C user=deploy,host=10.0.0.5,addr=203.0.113.10.

Ключевые директивы sshd_config: таблица с рекомендуемыми значениями

ДирективаРекомендуемое значениеЧто делаетНа что влияет
Port22 или нестандартный, например 2222Порт, который слушает sshdСовместимость: нестандартный порт усложняет подключение и автоматизацию, защиту не заменяет
PermitRootLoginprohibit-passwordРазрешает root только по ключу, без пароляБезопасность: закрывает самый частый вектор перебора
PasswordAuthenticationnoЗапрещает вход по паролюБезопасность: отключайте только после проверки ключа
PubkeyAuthenticationyesРазрешает аутентификацию по открытому ключуСовместимость: базовый метод для CI/CD и Ansible
AllowUsersсписок вида deploy adminБелый список логинов, остальным отказБезопасность: резко сужает поверхность атаки
MaxAuthTries3Число попыток аутентификации на соединениеБезопасность: режет перебор, но требует проверки с агентами ключей
ClientAliveInterval300Интервал отправки keepalive-запросов клиентуСтабильность: отсекает зависшие сессии
ClientAliveCountMax2Сколько unanswered keepalive допускается до разрываСтабильность: сессия умирает примерно через 10 минут молчания

Значения по умолчанию различаются между версиями OpenSSH и дистрибутивами. PermitRootLogin, например, по умолчанию равен prohibit-password начиная с OpenSSH 7.0 (релиз от 2015-08-11): в этом режиме запрещены все интерактивные методы аутентификации, разрешены только public-key, hostbased и GSSAPI (release notes OpenSSH 7.0). Значение MaxAuthTries по умолчанию сверяйте с man sshd_config и sshd -T на конкретной машине, а не полагайтесь на память.

PermitRootLogin и PasswordAuthentication: отключаем вход root и пароли

Два самых результативных изменения в sshd_config. PermitRootLogin принимает четыре значения: yes (root по паролю и ключу), prohibit-password (root только по ключу или другому непарольному методу), forced-commands-only (root только с принудительной командой) и no (вход root запрещён полностью, административные задачи идут через sudo).

Готовые строки для типового продакшена:

  • PermitRootLogin prohibit-password — компромисс, если root-ключ уже используется в автоматизации.
  • PermitRootLogin no — предпочтительный вариант: вход под личным пользователем, повышение прав через sudo.
  • PubkeyAuthentication yes — оставьте включённым, это основной метод.
  • PasswordAuthentication no — отключает парольный вход.
  • KbdInteractiveAuthentication no — обязательно проверьте эту директиву: KbdInteractiveAuthentication допускает вход через keyboard-interactive, который по умолчанию опирается на пароль, и эта директива заменяет ChallengeResponseAuthentication. При UsePAM yes и KbdInteractiveAuthentication yes парольный вход может проходить даже при PasswordAuthentication no, поэтому отключайте оба механизма (Baeldung: Successful SSH Login With PasswordAuthentication no).

Проверка эффективных значений: sshd -T | grep -E 'permitrootlogin|passwordauthentication|kbdinteractiveauthentication|usepam|pubkeyauthentication'. Если KbdInteractiveAuthentication остался yes, выключите и его.

Настройка аутентификации по ключам до отключения пароля

Последовательность важнее скорости. Сначала рабочий ключ, потом запрет паролей. Отключение PasswordAuthentication без проверенного ключа означает потерю доступа при следующем подключении.

  1. Сгенерируйте ключ на клиенте: ssh-keygen -t ed25519 -C "deploy@laptop". Ed25519 короче RSA-2048 при сопоставимой стойкости и поддерживается всеми актуальными версиями OpenSSH.
  2. Скопируйте публичную часть: ssh-copy-id -i ~/.ssh/id_ed25519.pub user@host. Результат — строка в /home/user/.ssh/authorized_keys.
  3. Выставьте права: chmod 700 ~/.ssh и chmod 600 ~/.ssh/authorized_keys, владелец — сам пользователь. При слишком открытых правах sshd молча игнорирует ключ.
  4. На RHEL-семействе проверьте SELinux-контекст: restorecon -R -v /home/user/.ssh. Неверный контекст даёт тот же эффект, что и права.
  5. Проверьте вход отдельно по ключу: ssh -o PreferredAuthentications=publickey -v user@host. В выводе должна быть строка Accepted publickey.
  6. Только теперь ставьте PasswordAuthentication no и применяйте конфиг через reload.

Если root-ключ нужен (например, для провижининга), PermitRootLogin no его заблокирует: ключ не сработает, нужен prohibit-password. Полный цикл работы с учётными записями, ключами, ограничениями по IP и sudoers разобран в материале управление пользователями и доступом на сервере.

Защита SSH от брутфорса: MaxAuthTries, AllowUsers, ClientAliveInterval

MaxAuthTries 3 ограничивает число попыток аутентификации в рамках одного TCP-соединения. После третьей неудачи sshd рвёт соединение и пишет в лог Maximum authentication attempts exceeded. Перебор становится дороже: атакующему нужно открывать новое соединение на каждые три попытки.

Осторожность нужна в средах с ssh-agent, где клиент может предлагать несколько ключей подряд. Если у вас в агенте пять ключей и три из них не подходят к серверу, вы упрётесь в лимит до того, как дойдёте до рабочего ключа. В таком случае ставьте 4-6 или настройте IdentitiesOnly yes на клиенте.

AllowUsers deploy admin или AllowGroups ssh-users задаёт белый список. Всё, что не перечислено, получает отказ на этапе аутентификации, независимо от существования учётной записи и корректности пароля. Для сервера с десятком системных учёток это самое дешёвое сокращение поверхности атаки. Не забывайте, что AllowUsers чувствителен к шаблонам вида user@10.0.0.*, и проверяйте результат через sshd -T.

ClientAliveInterval 300 вместе с ClientAliveCountMax 2 отключает сессию, которая молчит примерно 10 минут. Это освобождает ресурсы от зависших ssh-туннелей и обрывает соединения, брошенные после потери сети. Для интерактивной работы значение 300 секунд комфортно, для долгих операций без вывода используйте ServerAliveInterval на клиенте или запускайте задачи через tmux.

Port 2222 и любой другой нестандартный порт снижают объём шума от автоматических сканеров в логах. Защитой это не является: полноценный скан находит sshd на любом порту за минуты. Основной эффект дают ключи, запрет паролей и белые списки. fail2ban стоит рассматривать как дополнение, которое банит по логам, а не как замену этим настройкам.

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

Проверка синтаксиса и результата: sshd -t, sshd -T, логи

sshd -t — обязательный шаг перед любым применением. Команда проверяет синтаксис, существование файлов ключей хоста и читаемость Include-файлов. Exit code 0 означает, что конфиг валиден; сообщение вида /etc/ssh/sshd_config line 42: Bad configuration option указывает точное место ошибки. Запускать нужно от root, иначе часть проверок (права на ключи) даст ложные срабатывания.

sshd -T показывает эффективную конфигурацию: то, что демон применит на самом деле, со всеми дефолтами. Для проверки Match-блоков используйте sshd -T -C user=deploy,host=web1,addr=203.0.113.10; без -C часть условных директив в дамп не попадёт. Быстрый срез по важному: sshd -T | grep -E '^(port|permitrootlogin|passwordauthentication|pubkeyauthentication|maxauthtries|allowusers|clientalive)'.

После reload смотрите журнал: journalctl -u sshd -n 50 --no-pager на systemd-дистрибутивах, /var/log/auth.log на Debian и Ubuntu без journald. Ищите строки Server listening on 0.0.0.0 port 22 и Accepted publickey for user. Сокет проверяется через ss -tlnp | grep sshd: он должен слушать ожидаемый порт и адрес.

Отдельный случай — дистрибутивы с systemd socket activation. На Ubuntu 26.04 SSH по умолчанию использует socket activation: при активном ssh.socket порт открывает сам сокет до запуска демона, и директива Port в sshd_config игнорируется (LinuxConfig: How to Change SSH Port on Ubuntu 26.04). Проверьте systemctl status ssh.socket; если сокет активен, порт меняют через drop-in override для ssh.socket, а не через sshd_config. На других дистрибутивах поведение socket activation проверяйте отдельно.

Чек-лист перед закрытием старой сессии:

  • Бэкап конфига с датой существует и путь к нему записан.
  • sshd -t завершился без ошибок и предупреждений.
  • sshd -T показывает нужные значения для всех релевантных Match-условий.
  • Новая сессия входит по ключу, старый вход по паролю отклоняется, как и планировалось.
  • journalctl -u sshd не содержит ошибок после reload.
  • Старая сессия всё ещё открыта: она закрывается последней.

Расширенный вариант этой проверки, включая пользователей, sudo и сетевые службы, есть в чек-листе аудита безопасности Linux-сервера.

Типичные возражения: «сломает прод», «небезопасно», «устарело»

«Сломает прод». Ломает не правка, а применение без проверки. Сценарий с нулевым простоем выглядит так: бэкап с датой, sshd -t, вторая тестовая сессия, reload вместо restart. Откат — это cp /etc/ssh/sshd_config.bak.2026-11-11-1200 /etc/ssh/sshd_config и повторный reload. Если конфиг раскатывается через Ansible, cloud-init или скрипт, откат делается тем же механизмом; про хранение секретов и проверку таких скриптов есть отдельный материал о безопасности скриптов администрирования.

«Небезопасно». Рекомендуемый набор проверяется одной командой: PermitRootLogin prohibit-password или no, PasswordAuthentication no, KbdInteractiveAuthentication no, MaxAuthTries 3, AllowUsers с явным списком. Любое из этих значений подтверждается выводом sshd -T, а не доверием к статье. Ограничение по ключам и белым спискам снимает самые массовые атаки: перебор паролей и вход под сервисными учётками.

«Устарело». Директивы Port, PermitRootLogin, PasswordAuthentication, PubkeyAuthentication, AllowUsers, MaxAuthTries, ClientAliveInterval присутствуют и в OpenSSH 8.x, и в 9.x. Меняются имена отдельных параметров и дефолты: KbdInteractiveAuthentication заменяет ChallengeResponseAuthentication, а PubkeyAcceptedKeyTypes переименован в PubkeyAcceptedAlgorithms в OpenSSH 8.5 (релиз от 2021-03-03, release notes OpenSSH 8.5). Поэтому конфиг с чужого сервера переносите по одной директиве, проверяя man sshd_config и sshd -T на целевой версии.

Финальная последовательность применения на рабочем сервере:

  1. Сделайте бэкап конфига с датой в имени.
  2. Проверьте, откуда берутся значения: Include, sshd_config.d, Match-блоки.
  3. Внесите директивы и прогоните sshd -t до чистого exit code.
  4. Сверьте итог через sshd -T, при необходимости с -C для нужного пользователя и адреса.
  5. Проверьте вход в новой сессии по ключу, не закрывая текущую.
  6. Выполните reload и просмотрите journalctl -u sshd.
  7. Закройте старую сессию только после успешного входа во вторую.

Такой порядок превращает правку sshd_config из рискованной операции в рутину на две минуты: конфиг проверен, значения подтверждены, доступ не потерян.

Поделиться: