Secure Pipes

~/.ssh/config

Сохранение повторяющихся параметров в конфигурации клиента.

Перед выполнением

Первый блок — содержимое файла, не команда: отредактируйте локальный ~/.ssh/config. Обычно применяется первое полученное значение; конкретные блоки Host ставьте перед общими Host *. Защитите файл, обычно командой chmod 600 ~/.ssh/config. Не храните в нём пароли или содержимое закрытых ключей. ServerAlive выявляет отсутствие ответа SSH-узла, а не все сбои приложений. ssh -G выводит действующую конфигурацию без подключения; вывод может раскрывать внутренние адреса и пути.

Примеры

Создать псевдоним lab с портом, ключом и проверкой активности SSH.

Host lab
    HostName server.example.com
    User alice
    Port 2222
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
    ServerAliveInterval 30
    ServerAliveCountMax 3

Подключиться по псевдониму или посмотреть его действующие настройки.

ssh lab
ssh -G lab

Параметры и примеры

Host patternЧасто

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

Пример
Host lab
    HostName server.example.com
HostName / User / PortЧасто

Установите фактический адрес сервера, имя входа и порт SSH для соответствующего хоста.

Пример
Host lab
    HostName server.example.com
    User alice
    Port 2222
IdentityFile / IdentitiesOnlyЧасто

Выберите закрытый ключ и, если для него установлено значение «Да», ограничьте предлагаемые идентификаторы настроенными.

Пример
Host lab
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
ProxyJumpЧасто

Подключитесь через один или несколько хостов перехода SSH.

Пример
Host lab
    ProxyJump alice@bastion.example.com
LocalForward

Настройте локального прослушивателя, перенаправленного в пункт назначения, достигнутый с SSH-сервера.

Пример
Host lab
    LocalForward 127.0.0.1:15432 db.internal.example.com:5432
RemoteForward

Настройте удаленный прослушиватель, пересылаемый в пункт назначения, доступный с локального компьютера; применяется политика сервера.

Пример
Host lab
    RemoteForward 127.0.0.1:18080 127.0.0.1:8080
DynamicForward

Настройте локальный прослушиватель SOCKS. Клиенты должны быть настроены отдельно.

Пример
Host lab
    DynamicForward 127.0.0.1:1080
ExitOnForwardFailure

Откажитесь от SSH-соединения, если запрошенные первоначальные прослушиватели пересылки не могут быть установлены.

Пример
Host lab
    ExitOnForwardFailure yes
ServerAliveInterval / ServerAliveCountMaxЧасто

Настройте одноранговые проверки на уровне SSH и количество оставшихся без ответа проверок перед отключением.

Пример
Host lab
    ServerAliveInterval 30
    ServerAliveCountMax 3
ConnectTimeout

Установите таймаут соединения в секундах.

Пример
Host lab
    ConnectTimeout 10
ForwardAgent

Пересылка агента управления. Скомпрометированный удаленный хост может запросить подписи; включать только для доверенных хостов.

Пример
Host lab
    ForwardAgent no
Include

Включите дополнительные файлы конфигурации SSH; Порядок влияет на то, какие значения выбираются.

Пример
Include ~/.ssh/config.d/*.conf

Официальные источники

Проверено 27 октября 2026 г.