TunnelHunt

autossh: постоянный SSH-туннель, переподключение и systemd

5 мин чтения

Настройка autossh на Linux и macOS: переподключение SSH, постоянный адрес по ключу, автозапуск через systemd и проверка HTTP после сбоя.

autossh: постоянный SSH-туннель, переподключение и systemd

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

В этом руководстве локальное приложение слушает порт 3000, а TunnelHunt выдаёт для него публичный HTTPS-адрес. Для обычного VPS параметры SSH будут другими: не переносите специальный порт 80 из примера TunnelHunt на произвольный сервер.

Сначала проверьте обычное соединение

curl -i http://127.0.0.1:3000/
ssh -p 2222 -o ExitOnForwardFailure=yes -R 80:127.0.0.1:3000 tunnelhunt.ru

Запустить тестовый туннель — В кабинете добавьте публичный SSH-ключ для Free, затем выполните команду выше.

Откройте выданную HTTPS-ссылку. При первом подключении проверьте ключ сервера и завершите необходимый интерактивный вход. После успешной проверки остановите SSH через Ctrl+C.

Если обычный SSH не подключается, autossh только повторит ту же ошибку. Проверьте ключ, порт, сеть и лимит активных туннелей.

Установка autossh

На macOS с Homebrew:

brew install autossh

На Debian или Ubuntu:

sudo apt update
sudo apt install autossh

Проверьте, что утилита доступна: autossh -V. Для других систем используйте пакет вашего дистрибутива или исходники autossh.

Команда с автоматическим восстановлением

autossh -M 0 -p 2222 \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -o ExitOnForwardFailure=yes \
  -R 80:127.0.0.1:3000 tunnelhunt.ru

-M 0 отключает отдельный мониторинговый порт autossh. Состояние соединения проверяет сам SSH: при отсутствии входящих данных ServerAliveInterval=30 задаёт интервал проверки, а ServerAliveCountMax=3 ограничивает число пропущенных ответов. Неотвечающий сервер обычно будет обнаружен примерно за 90 секунд, после чего autossh сможет запустить новое соединение.

ExitOnForwardFailure=yes завершает SSH при отказе создать проброс. Эта опция не проверяет, что HTTP-приложение на порту 3000 исправно отвечает. Параметры подробно описаны в руководстве OpenSSH.

Восстановление соединения и постоянный адрес — разные задачи

Случайный субдомен может измениться при переподключении. Для вебхуков зарезервируйте свободное имя на Pro, добавьте публичный SSH-ключ в кабинет и привяжите его в настройках этого туннеля. Затем подключайтесь соответствующим приватным ключом. Например, если он сохранён как ~/.ssh/tunnelhunt_ed25519:

autossh -M 0 -p 2222 \
  -i ~/.ssh/tunnelhunt_ed25519 -o IdentitiesOnly=yes \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -o ExitOnForwardFailure=yes \
  -R 80:127.0.0.1:3000 tunnelhunt.ru

Замените путь на свой ключ. IdentitiesOnly=yes ограничивает набор предлагаемых ключей; при нескольких ключах это помогает подключиться нужной учётной записью. Сервер выбирает свободный резерв, привязанный к принятому ключу. Имя поддомена в -R его не выбирает: в команде остаётся 80:127.0.0.1:3000. Проверьте выданный URL до регистрации вебхука и после переподключения. Для предсказуемого выбора используйте отдельный ключ для каждого резервируемого адреса и завершите прежнюю сессию, занимающую его.

Резервирование имени сохраняет возможность использовать тот же адрес. Доступность приложения по-прежнему зависит от локального процесса, сети и работающего туннеля.

Автозапуск на Linux через systemd

Сначала проверьте подключение под тем пользователем, от которого будет работать служба. Его SSH-ключ и запись сервера в known_hosts должны быть готовы. Служба не сможет спросить пароль ключа в интерактивном терминале; продумайте способ аутентификации для этого окружения.

Создайте /etc/systemd/system/tunnelhunt.service:

[Unit]
Description=TunnelHunt reverse SSH tunnel
Wants=network-online.target
After=network-online.target

[Service]
Type=simple
User=your_user
Environment=AUTOSSH_GATETIME=0
ExecStart=/usr/bin/autossh -M 0 -p 2222 -i /home/your_user/.ssh/tunnelhunt_ed25519 -o IdentitiesOnly=yes -o BatchMode=yes -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -o ExitOnForwardFailure=yes -R 80:127.0.0.1:3000 tunnelhunt.ru
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Замените your_user, абсолютный путь к его приватному ключу и /usr/bin/autossh, если command -v autossh показывает другой путь. Служба должна читать тот же ключ, который вы проверили вручную и привязали к зарезервированному адресу. AUTOSSH_GATETIME=0 разрешает повторные попытки, даже если первоначальное соединение завершилось быстро. BatchMode=yes позволяет получить ошибку в журнале вместо ожидания пароля.

sudo systemctl daemon-reload
sudo systemctl enable --now tunnelhunt.service
systemctl status tunnelhunt.service
journalctl -u tunnelhunt.service -n 50 --no-pager

active (running) означает, что процесс службы работает. Дополнительно проверьте публичный HTTP-адрес. Запуск вашего приложения настройте отдельно.

Как проверить восстановление

В тестовом окружении с работающим приложением кратковременно отключите сеть, затем верните подключение. Дождитесь обнаружения сбоя и новой SSH-сессии. Проверьте журнал службы и повторите запрос к публичному URL.

Используйте отдельную тестовую сессию: проверка разрывает доступ и может вызвать повторную доставку вебхуков. Убедитесь, что повтор одного события не создаёт повторную операцию в приложении.

Запишите публичный адрес до теста и после восстановления выполните два запроса:

curl --fail-with-body --max-time 10 http://127.0.0.1:3000/
curl --fail-with-body --max-time 15 https://YOUR-SUBDOMAIN.tunnelhunt.ru/

Первый запрос выполняется на машине приложения, второй — лучше с другого устройства. Оба должны вернуть ожидаемое содержимое, а не только статус. Если локально всё работает, а старый публичный адрес нет, проверьте новое имя в журнале SSH: при случайном поддомене после переподключения нужно изменить URL у отправителя. Для зарезервированного имени проверьте тот же ключ и отсутствие старой активной сессии. Сам по себе PID autossh не подтверждает доставку запросов.

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

Частые проблемы

Симптом Возможная причина и действие
Permission denied (publickey) У пользователя службы нет нужного ключа; проверьте вход вручную от его имени
Host key verification failed Нет проверенной записи в known_hosts или ключ сервера изменился; выясните причину, не отключайте проверку
remote port forwarding failed Имя недоступно, старая сессия ещё активна или достигнут лимит
Служба работает, но ссылка отвечает ошибкой Проверьте локальное приложение через curl
После сна ноутбука сайт недоступен Во время сна autossh не выполняется; для непрерывной работы нужен включённый хост

Остановить и отключить автозапуск:

sudo systemctl disable --now tunnelhunt.service

Для настройки самого приложения используйте инструкцию публичного доступа к localhost, а для анализа входящих событий — руководство по повтору вебхуков.

Сохраните адрес после восстановления SSH

Сначала проверьте обычный туннель на Free. Для повторных подключений зарезервируйте имя на Pro, привяжите SSH-ключ и проверьте публичный HTTP-ответ после сбоя.

Первый запуск: добавьте публичный SSH-ключ, запустите локальное приложение и команду SSH из статьи, затем откройте выданный HTTPS-адрес. Если ответа нет, пройдите проверку localhost и туннеля.

Free: 1 ГБ трафика в месяц, 1 туннель, сессия до 4 часов. Pro: 199 ₽/месяц, 50 ГБ, до 5 туннелей и резервирование поддомена. Компьютер, приложение и SSH-соединение должны работать; постоянный адрес сохраняет имя, а не доступность выключенного сервера.

Готовы запустить свой первый туннель?

Начните использовать TunnelHunt бесплатно уже сегодня и откройте доступ к локальному серверу всего одной командой.

Зарегистрироваться бесплатно →

По теме

Как открыть localhost в интернете: публичный HTTPS через SSH

Как запустить localhost и открыть сайт в интернете через SSH

11 сентября 2026 г.

Запуск сайта на localhost:3000, проверка в браузере и с телефона, публичный HTTPS через SSH. Пример на Python, настройка Docker и Vite, диагностика ошибок.

Читать далее →
Альтернатива ngrok: TunnelHunt, SSH и публичный доступ к localhost

Аналоги ngrok для localhost: TunnelHunt и Cloudflare Tunnel

30 мая 2025 г.

Сравниваем ngrok, Cloudflare Tunnel и TunnelHunt для локального сайта, вебхуков, постоянного адреса и TCP. Команды запуска и ограничения.

Читать далее →
Почему для туннелей достаточно одного лишь SSH

Почему для туннелей достаточно одного лишь SSH

21 мая 2025 г.

Многие сервисы для туннелирования требуют установки специальных клиентов. Мы в TunnelHunt считаем, что это излишне, и вот почему.

Читать далее →
Автоматическое исправление правок клиента через TunnelHunt Review Mode и MCP

От голосовой правки заказчика до коммита: авто-фикс вёрстки с Review Mode и Claude Code / Cursor

6 ноября 2026 г.

Пошаговый конвейер для разработчиков и студий: как принимать визуальные пины и голосовые заметки от клиента на localhost и автоматически исправлять React/Vue компоненты через MCP-сервер TunnelHunt.

Читать далее →