Гайды

Почему SSH отключается сам (Broken pipe) — три причины и как починить

Иллюстрация: тонкий провод тянется от ноутбука к серверной стойке и провисает посередине; робот держит его за край

Ты зашёл на сервер, отвлёкся на десять минут, вернулся — терминал не реагирует. Жмёшь Enter, ничего. А через минуту появляется:

client_loop: send disconnect: Broken pipe

Или терминал просто висит намертво. Сначала спасём зависшее окно, а потом разберём три причины, на которые натыкается почти каждый. Начнём с самой частой.

Сначала: как закрыть зависший SSH

Ctrl+C тут не поможет: SSH честно передаёт его на сервер, а до сервера ничего не доходит. У SSH есть свой секретный выход. Нажми по очереди:

  1. Enter
  2. ~ (тильда)
  3. . (точка)

Соединение закроется сразу, и ты вернёшься в свой терминал. Это встроенная «аварийная кнопка» SSH. Срабатывает она только в начале строки — поэтому сначала Enter.

Причина 1. Роутер забыл про тихое соединение

Самая частая причина. Между тобой и сервером стоят роутеры и файрволы. Они запоминают каждое открытое соединение. Но если по нему долго ничего не идёт, они решают, что оно мёртвое, и вычёркивают его из памяти. Ты читаешь лог и молчишь — а соединение уже «забыто».

Как проверить. Обрыв бывает только после простоя. Пока ты печатаешь, всё стабильно. Отошёл на 5–15 минут — отвалилось.

Как починить. Попроси SSH самому подавать признаки жизни. Открой файл ~/.ssh/config на своём компьютере (если его нет — создай) и добавь:

Host *
    ServerAliveInterval 60
    ServerAliveCountMax 3

Теперь раз в 60 секунд клиент отправляет серверу короткое «ты тут?». Соединение не простаивает, и роутер его не забывает. А если сервер правда пропал, после трёх неотвеченных проверок SSH отключится сам. Ты увидишь понятное Timeout, server ... not responding вместо вечно висящего окна.

Почему это не включено сразу? В системе есть похожий механизм на уровне сети, но в Linux по умолчанию он срабатывает раз в два часа. Для домашнего роутера это слишком редко.

Причина 2. Ноутбук уснул или сменил сеть

Закрыл крышку, перешёл с Wi-Fi на мобильный интернет, включил VPN. У тебя поменялся адрес в сети — а SSH-соединение привязано к старому. Его не спасти никакими настройками: для сервера это был другой компьютер.

Как проверить. Обрыв совпадает со сном, переездом или переключением сети.

Как починить. Нужно не удержать соединение, а сделать так, чтобы его потеря ничего не ломала:

  • Работай на сервере внутри tmux. При обрыве твоя сессия остаётся жить на сервере, а после переподключения ты возвращаешься ровно туда же. Пошагово — в гайде как пользоваться tmux.
  • Для постоянных переездов есть mosh — замена ssh, которая переживает смену сети и сон. Ставится и на компьютер, и на сервер.

Важное следствие. Команда, запущенная прямо в SSH-окне, при обрыве обычно умирает вместе с ним. Долгую установку или скрипт запускай в tmux. А то, что должно работать всегда, — бот или сервер, — оформляй службой: как это сделать, мы рассказали в статье что такое демон.

Причина 3. Сервер выгоняет тебя сам

Реже, но обидно. Иногда отключает не сеть, а сервер — по своему правилу простоя. На серверах компаний и хостингов это бывает включено специально.

Как проверить. Если перед закрытием появилось сообщение

timed out waiting for input: auto-logout

— это оболочка на сервере. Её настраивает переменная TMOUT. Посмотреть: echo $TMOUT. Число в ответе — сколько секунд тишины она терпит. Если сообщения нет, а обрыв ровно через одно и то же время, загляни в настройки SSH-сервера: параметр ClientAliveInterval в файле /etc/ssh/sshd_config.

Как починить. На своём сервере можно убрать TMOUT из файлов настройки оболочки, где он задан, или увеличить значение. Как оболочка читает эти файлы при входе, мы разбирали в статье .bashrc или .bash_profile. На чужом сервере правило могли поставить специально — тогда спасает тот же tmux.

Как понять, какая причина у тебя

Подключись с подробным журналом:

ssh -v user@server

SSH будет печатать каждый свой шаг. В момент обрыва последние строки подскажут, кто закрыл соединение: сеть (Broken pipe, Connection reset), таймаут проверок (not responding) или сам сервер (Connection closed by remote host). Основы того, как SSH вообще подключается, — в статье что такое SSH.

Частые вопросы

ServerAliveInterval нужно настраивать на сервере?

Нет, это настройка клиента, то есть твоего компьютера. На сервере у неё есть зеркальная пара — ClientAliveInterval. Обычно хватает клиентской.

Помогут ли настройки, если у меня обрывается VS Code Remote?

Да. Расширение Remote-SSH использует тот же ~/.ssh/config, так что ServerAliveInterval работает и для него.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →