Назад к обновлениям
New releaseAug 20, 2026

sshroute v0.2.11

Сетевой SSH-роутер — направляет соединения на разные IP-адреса/порты/ключи/шлюзы в зависимости от активной VPN-сети или сетевого подключения.

Поделиться

sshroute

CI Код OpenSpec Безопасность
CI
Release
OpenSpec Badge
Scorecard
Latest Release
codecov
Go Report Card
Go Reference
Specs
Requirements
Tasks
Open Changes
OpenSSF Scorecard
CII Best Practices
License: Apache 2.0

SSH-маршрутизатор с учётом сети. Определяет вашу активную сеть или VPN и автоматически выбирает нужный хост, порт, файл идентификации и jump-хост для каждого SSH-подключения — не затрагивая ~/.ssh/config.

Как это работает

Определите каждый логический хост один раз с профилем default и необязательными переопределениями для отдельных сетей. При каждом подключении sshroute определяет, в какой сети вы находитесь (VPN, офисная локальная сеть, пир WireGuard и т. д.), и разрешает правильные параметры SSH, прежде чем передать управление настоящему /usr/bin/ssh.

ssh myserver
  → sshroute detects: corp-vpn is active
  → resolves: 10.100.0.50:2222 via bastion.corp.internal
  → exec /usr/bin/ssh -p 2222 -i ~/.ssh/corp_key -J bastion.corp.internal 10.100.0.50

Зачем нужен sshroute?

Для владельцев домашних лабораторий

В вашей лаборатории наверняка есть как минимум две реальности: вы либо сидите дома в локальной сети, либо находитесь вдали и подключаетесь через WireGuard или другой VPN. Проблема в том, что ~/.ssh/config не знает, в какой из них вы находитесь, — поэтому вы заводите отдельные псевдонимы (server-lan, server-vpn), или jump-хост, который работает только в половине случаев, или просто запоминаете IP-адреса.

sshroute решает эту проблему, определяя вашу текущую сеть перед каждым подключением. Когда интерфейс WireGuard поднят и маршрут к пиру существует, он подключается напрямую к IP-адресу туннеля. Когда вы в локальной сети, он использует локальный адрес. Когда недоступно ни то, ни другое, он переключается на публичное имя хоста. Один псевдоним, три реальности, ноль ручных переключений.

Он также прозрачно перехватывает SSH — git push, rsync, scp автоматически проходят через него, как только вы настроите режим shadow. Никаких обёрток, никаких shell-функций, никаких раздумий.

Для корпоративных сред

В корпоративных сетях всё ещё хуже. У вас есть публичный интернет, возможно, VPN типа site-to-site, возможно, личный VPN с раздельным туннелированием, а внутри этого — разные jump-хосты в зависимости от того, к какой среде вы обращаетесь: dev, staging, prod, каждая со своим бастионом и ключом. Держать всё это в порядке в ~/.ssh/config означает либо один огромный конфиг, который ломается при каждом изменении инфраструктуры, либо скрипт, который каждый в команде поддерживает по-своему.

sshroute позволяет декларативно описать логику маршрутизации, хранить её в версионируемом YAML-файле и делиться ею со всей командой. Один и тот же конфиг работает у всех — нужная сеть определяется автоматически на основе того, какие интерфейсы или маршруты активны на каждой машине. Ключи, порты, пользователи и jump-хосты разрешаются без необходимости думать об этом.

Сравнение

Возможность~/.ssh/configТолько WireGuardTeleport / Boundarysshroute
Определяет вашу текущую сеть❌❌❌✅
Автоматически выбирает лучший путь❌❌❌✅
Переключается при сбое подключения❌❌✅✅
Автопереподключение + перемаршрутизация при обрыве❌⚠️ туннель роумится⚠️ через фиксированный прокси✅
Одна команда на хост, из любой локации❌⚠️ VPN должен быть поднят✅✅
Размер конфига для 10 хостов × 4 путей📄 ~600 строк📄 ~600 строк + конфиг VPN📄 конфиг на стороне сервера📄 ~60 строк
Мобильные устройства в роуминге⚠️ ручные псевдонимы⚠️ требуется VPN✅✅
Автоматическое построение цепочки jump-хостов⚠️ вручную -J➖ н/д✅✅
Работает с scp / rsync / git / Ansible✅✅⚠️ частично✅
Без установки на целевые серверы✅❌❌✅
Без сервера аутентификации или демона✅❌❌✅
Без клиентского агента✅❌❌✅
Открытый исходный код, полностью self-hosted✅✅⚠️ open-core✅

Teleport и Boundary — это другая категория: они добавляют поверх маршрутизации контроль доступа, журналы аудита и аутентификацию на основе сертификатов. Если вам нужно именно это, используйте их. sshroute — для случаев, когда вы хотите получить интеллектуальную маршрутизацию без операционных издержек на запуск центрального сервера аутентификации.

Установка

Загрузка бинарного файла

Скачайте последний релиз со страницы GitHub Releases. Бинарные файлы доступны для Linux, macOS и Android на архитектурах AMD64 и ARM64.

Установка через Go

go install github.com/thereisnotime/sshroute@latest

Android (Termux)

Скачайте tarball android_arm64 со страницы GitHub Releases, распакуйте его и поместите бинарный файл в ~/.local/bin:

Категории