termal.in

← Блог

Флаги SSH, которыми вы действительно будете пользоваться (практическая шпаргалка)

· обновлено 12 нояб. 2026 г. · Termalin Team sshcheat-sheetproductivitytutorial

Короткий ответ: флаги, к которым тянешься чаще всего: -p <port> (нестандартный порт), -i <key> (задать конкретный ключ), -L / -R / -D (локальный, удалённый и динамический проброс), -J <bastion> (прыжок через бастион), -N -f (увести туннель в фон без оболочки), -t (принудительно выделить TTY для sudo), -o Option=value (задать любую директиву ssh_config прямо в команде) и -vvv (разобраться с неудачным подключением). Всё, что вы передаёте дважды, место в ~/.ssh/config — тогда ssh web1 несёт это вообще без флагов.

ssh --help вываливает сорок флагов по алфавиту — самый бесполезный способ их выучить. К флагам вы тянетесь исходя из того, что хотите сделать: подключиться под другим пользователем, пробросить порт, перепрыгнуть через бастион, разобраться с отказом, — так что вот тот же набор, разложенный по задачам, с пометкой, какие пора перестать печатать и перенести в ваш ssh_config (на английском).

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

Основы подключения

Флаги, которые отвечают на вопрос «кто, куда и с каким ключом».

  • -p <port> — подключиться к нестандартному порту. ssh -p 2222 user@host. (Строчная -p; прописная -P — это флаг порта у scp, на чём все спотыкаются хоть раз.)
  • -l <user> — пользователь для входа, альтернатива префиксу user@. ssh -l deploy host равнозначно ssh deploy@host; -l встречается в скриптах и старой документации.
  • -i <identity> — указать на конкретный приватный ключ. ssh -i ~/.ssh/work_ed25519 user@host. Самый полезный флаг, когда аутентификация падает: он навязывает точный ключ, а не оставляет агенту гадать.
  • -F <configfile> — использовать другой файл конфигурации. ssh -F ./project.sshconfig web1 или -F /dev/null, чтобы проигнорировать ваш личный конфиг и проверить без единой настройки.
  • -v / -vv / -vvv — подробность вывода, и тот самый флаг, что раскрывает большинство загадок. Один -v показывает перепробованные методы аутентификации и предложенные ключи; -vvv показывает всё рукопожатие целиком. Когда что-то падает, запустите снова с -vvv, прежде чем строить теории, — чтение этого трейса — отдельное умение.

Запасной выход -o

Вот флаг, который стоит понять досконально, потому что он вбирает в себя десятки других. -o задаёт любую опцию ssh_config прямо в командной строке. Всё, что вы могли бы написать в ~/.ssh/config внутри блока Host, можно передать как -o Option=value — не короткий список избранных опций, а весь словарь конфига, доступный для одного соединения.

Несколько тех, что встречаются постоянно:

ssh -o IdentitiesOnly=yes -i ~/.ssh/right_key user@host   # offer only this key
ssh -o StrictHostKeyChecking=accept-new user@host          # trust new hosts, still catch changes
ssh -o ServerAliveInterval=30 user@host                    # keepalive for a flaky link
ssh -o ProxyJump=bastion.example.com db.internal           # hop through a bastion inline

-o IdentitiesOnly=yes — это лекарство от Too many authentication failures, когда ваш агент предлагает шесть ключей, а строгий сервер обрывает вас после пятого. -o StrictHostKeyChecking=accept-new — разумная золотая середина: автоматически довериться хосту, которого вы прежде не видели, но всё же поднять крик, если ключ известного хоста изменится.

Суть: отдельный флаг на каждое поведение не нужен. Знаете директиву конфига — знаете и флаг: это -o Directive=value. А как только вы передаёте по три-четыре каждый раз, переносите их в конфиг насовсем.

Проброс и туннели

Флаги для прокладки портов. Мысленная модель — какая сторона открывает порт — разобрана отдельно в статье проброс портов в SSH; здесь — краткая сводка по флагам.

  • -L <local>:<host>:<port> — локальный проброс. Открывает порт на вашей машине, который туннелируется к точке назначения, доступной с сервера. ssh -L 5432:localhost:5432 db.example.com приносит удалённую базу данных на ваш 127.0.0.1:5432.
  • -R <remote>:<host>:<port> — удалённый проброс. Открывает порт на сервере, который туннелируется обратно на вашу сторону, — приём обратного туннеля, чтобы дотянуться до машины за NAT.
  • -D <port> — динамический проброс. SOCKS-прокси на вашей машине; точка назначения выбирается для каждого соединения. ssh -D 1080 jump.example.com, затем направьте браузер на 127.0.0.1:1080.
  • -N — не запускать удалённую команду. Сочетайте с любым пробросом, когда нужен только туннель и никакой оболочки.
  • -f — увести ssh в фон после подключения. Сочетайте с -N для туннеля по принципу «запустил и забыл»: ssh -fN -L 5432:localhost:5432 db.example.com.
  • -g — разрешить другим машинам в вашей локальной сети пользоваться локальным пробросом (-L/-D), а не только 127.0.0.1. Небольшое открытие наружу — вы открываете туннель всей своей сети, так что применяйте это осознанно.

Jump host и агент

Как дотянуться до следующего прыжка — и флаг, с которым стоит быть осторожным.

  • -J <jumphost> — ProxyJump. Туннелирует через бастион и проходит аутентификацию из конца в конец, с вашего ноутбука до цели. ssh -J bastion.example.com db.internal. Бастион лишь перегоняет зашифрованные байты; ваш ключ на него не попадает — правильный способ пройти через шлюз. Полный разбор: ProxyJump: доступ к серверам за бастионом.
  • -A — проброс агента. Открывает на удалённом хосте сокет, который проксирует запросы на подпись обратно вашему локальному агенту, так что процесс там может аутентифицироваться от вашего имени на следующем сервере. Удобно и рискованнее, чем кажется: любой, у кого на этом хосте есть root, может одолжить вашу личность, пока сессия открыта. Используйте -J, чтобы «дотянуться до следующего прыжка», а -A приберегите для хостов, которым полностью доверяете, — причины в статье проброс агента: удобно и опасно (на английском).

Разница между ними: -J приводит вашу оболочку к хосту за бастионом, никому не одалживая ваши ключи; -A одалживает живое использование ваших ключей той машине, к которой вы подключились. Это не одно и то же.

Управление сессией

Маленькие флаги, которые устраняют конкретные неудобства.

  • -t — принудительно выделить псевдотерминал. Нужен для удалённой команды, которая ждёт интерактивного TTY: ssh -t host 'sudo systemctl status nginx' даёт настоящий терминал для запроса sudo и цветного вывода. Удвойте (-tt), чтобы выделить его, когда локального TTY нет.
  • -q — тихий режим. Подавляет предупреждения и баннеры; полезно в скриптах, где нужен только собственный вывод команды.
  • -C — запросить сжатие. Настоящий выигрыш на медленных каналах с высокой задержкой; ничтожный или слегка отрицательный эффект в быстрой локальной сети.
  • -o BatchMode=yes — никогда ничего не спрашивать. Если для аутентификации понадобился бы пароль или парольная фраза, сразу завершиться с ошибкой, а не зависать. Именно это делает SSH безопасным внутри cron и CI — застрявший запрос в автоматическом скрипте висит вечно.

Какой порт использует SSH?

По умолчанию SSH использует TCP-порт 22 — именно его подразумевают ssh, scp, sftp и git поверх SSH, пока вы не укажете иное. Чтобы дотянуться до сервера, слушающего в другом месте, передайте порт через -p:

ssh -p 2222 user@host

Чтобы сменить порт, который слушает сервер, задайте Port в /etc/ssh/sshd_config и перезапустите sshd — а потом откройте новый порт и в файрволе хоста, и в облачной security-группе, прежде чем выходить: сменить порт SSH, не разрешив новый, — самый быстрый способ запереть себя снаружи. (Уход с 22-го приглушает случайные сканеры; сам по себе это не настоящая защита.) Задайте его один раз для каждого хоста в вашем ssh_config (на английском) как Port 2222 — и -p больше печатать не придётся.

Как выполнить команду по SSH без оболочки

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

ssh user@host 'df -h /'
ssh user@host 'systemctl is-active nginx'

Это основа скриптов и cron: одно соединение, одна команда, код завершения, который можно проверить. Берите команду в кавычки, чтобы ваша локальная оболочка не раскрыла её первой. Здесь важны два флага:

  • -t выделяет TTY для команды, которой он нужен, — ssh -t user@host 'sudo systemctl restart nginx' даёт sudo настоящий интерактивный запрос.
  • -o BatchMode=yes (или -n) не даёт ему ждать ввода, так что автоматическая задача быстро падает, а не виснет на запросе.

Как выйти из SSH-сессии

Введите exit или нажмите Ctrl-D, чтобы закрыть оболочку и разорвать соединение. Оба способа отправляют удалённой оболочке конец файла, она завершает ваш сеанс и возвращает вас к локальному приглашению:

exit        # or press Ctrl-D

Когда сессия замерла — канал умер, и терминал игнорирует всё, даже Ctrl-C, — exit не поможет, потому что ничто из набранного вами не доходит до дальнего конца. Воспользуйтесь вместо этого собственной управляющей последовательностью SSH: нажмите Enter, затем наберите ~. (тильда, затем точка). Это велит вашему локальному ssh немедленно разорвать соединение, как бы ни заклинило удалённую сторону. Управляющий символ ~ считывается только сразу после перевода строки — поэтому сначала вы нажимаете Enter.

Компактный справочник

ФлагЧто делаетЭквивалент в ssh_config
-p 2222Нестандартный портPort 2222
-l user / user@Пользователь для входаUser user
-i ~/.ssh/keyКонкретный ключIdentityFile ~/.ssh/key
-F fileДругой файл конфигурации— (это и есть конфиг)
-v … -vvvПодробный вывод / отладкаLogLevel DEBUG3
-o Opt=valЛюбая опция конфига прямо в строке(сама опция)
-L a:host:bЛокальный пробросLocalForward a host:b
-R a:host:bУдалённый пробросRemoteForward a host:b
-D 1080Динамический (SOCKS) пробросDynamicForward 1080
-NБез удалённой командыRequestTTY no (+ без команды)
-fВ фон после подключения— (только разово)
-gОткрыть проброс вашей локальной сетиGatewayPorts yes
-J hostПрыжок через бастионProxyJump host
-AПробросить агентаForwardAgent yes
-tПринудительно выделить TTYRequestTTY force
-qТихоLogLevel QUIET
-CСжатиеCompression yes
-o BatchMode=yesНикогда не спрашиватьBatchMode yes

Правый столбец всё и выдаёт. Почти у каждого флага есть эквивалент в конфиге, и в этом весь рабочий процесс: используйте флаг один раз, чтобы убедиться, что соединение работает, а затем перенесите те, что будете повторять, в ~/.ssh/config — чтобы ssh web1 нёс их все вообще без флагов. Флаги, у которых эквивалента в конфиге нет, — -f, -F, уровни отладки — и есть по-настоящему разовые.

Где клиент хранит это состояние за вас

И флаги, и конфиг живут в ваших dot-файлах, на каждой машине своих, и в масштабе это больно: настройки переносятся между ноутбуками вручную, туннели перезапускаются после каждого сна, и никак не увидеть, какой из сорока хостов жив. Termalin держит те же факты, что нёс бы флаг, — порт, пользователь, ключ, jump host, keepalive, сохранённые локальные/удалённые/динамические пробросы — привязанными к хосту как структурированные данные, разложенными по папкам и тегам, синхронизированными между вашими машинами со сквозным шифрованием. Он проверяет каждый сервер при первом подключении, показывает живой статус по каждому хосту и запускает туннели вместе с соединением, а не по перенабранной команде. Флаги учат вас тому, что происходит; клиент избавляет вас от их перенабора каждое утро.


Termalin — бесплатный кроссплатформенный SSH-клиент, который хранит настройки, ключи и туннели для каждого хоста за вас — скачайте его или прочитайте, как он безопасно обращается с вашими ключами.

Попробуйте на одном хосте.

Termalin — быстрый SSH-клиент для вас и ваших агентов.

Бесплатный тариф · 14 дней Pro бесплатно · цены

Добавьте Termalin в предпочитаемые источники в Google