Android / Android TV приложение для работы и тестирования мобильных приложений внутри сети предприятия. Трафик выбранных приложений заворачивается в стандартный SSH-проброс портов — тот же, что даёт команда
ssh -D 1080 user@gateway.corp.exampleНа сервере ничего дополнительно ставить не нужно: подойдёт любой OpenSSH с разрешённым
AllowTcpForwarding.
- Открыть внутренние сервисы предприятия (стенды, API, админки) из мобильного приложения так, как будто телефон или ТВ-приставка находится в корпоративной сети.
- Проверить поведение приложения через конкретный шлюз, не перенастраивая Wi-Fi и не трогая остальные приложения на устройстве.
- Дать доступ к SOCKS5-пробросу (
127.0.0.1:<порт>) приложениям, которые умеют работать с прокси.
- Выбор приложений: в тоннель идут только выбранные приложения, или наоборот — все, кроме выбранных.
- Локальная сеть напрямую: опционально домашние/офисные адреса (10/8, 172.16/12, 192.168/16, мультикаст) остаются доступными без тоннеля.
- DNS через тоннель: имена резолвятся на стороне шлюза, как при
ssh -Dс удалённым резолвом. - Без утечек: пока SSH переподключается, выбранные приложения получают отказ соединения, а не идут в обход.
- Несколько серверов: профили с паролем или ключом (RSA, ECDSA, Ed25519), проверка подключения перед сохранением.
- Android TV: всё управляется пультом, автозапуск после включения приставки.
- Внешний IP, страна и город на главном экране: при подключённом тоннеле — выходной адрес шлюза.
- Статистика скорости и трафика, журнал событий.
- Обновление из релизов GitHub прямо в настройках (с проверкой подписи APK).
- Интерфейс на русском и английском (по языку устройства).
выбранное приложение ─► системный тоннель ─► локальный SOCKS5 127.0.0.1:<порт> ─► SSH direct-tcpip ─► шлюз ─► цель
- TCP-соединения приложения завершаются на устройстве и передаются через SOCKS5 в SSH-каналы
direct-tcpip— ровно то, что делаетssh -D. - DNS-запросы (UDP 53) отправляются как DNS-over-TCP через тот же проброс.
- Остальной UDP (QUIC и т. п.) сразу отклоняется, приложения переходят на TCP.
- IPv6 для выбранных приложений отключён, весь трафик идёт по IPv4 через шлюз.
Подробности — в docs/.
- На сервере заведите пользователя, который умеет только пробрасывать порты (без оболочки и SFTP):
Скрипт спросит способ входа (ключ, пароль или оба), при желании ограничит адреса и выведет данные для приложения. Подробнее — docs/SERVER.md.
curl -fsSLO https://raw.githubusercontent.com/usmanec/sshtunnel/main/server/sshtunnel-user.sh sudo bash sshtunnel-user.sh
- Добавьте сервер: Servers → Add Server, укажите адрес, пользователя и пароль или ключ. Нажмите Test Connection.
- Выберите приложения: Apps → отметьте нужные (по умолчанию в тоннель идут только они).
- На главном экране нажмите большую кнопку подключения и подтвердите системный запрос.
- Стрелки — перемещение, OK — выбор/переключение, Назад — на главный экран.
- Если на приставке нет системного окна подтверждения, разрешение выдаётся один раз через ADB:
adb shell appops set top.rootu.ssh.tunnel ACTIVATE_VPN allow - Для подключения после включения приставки включите Settings → Auto-Start on Boot.
Нужны JDK 17+ и Android SDK (compileSdk 36). Проект открывается в Android Studio.
gradle :app:assembleDebug # отладочная сборка
gradle :app:testDebugUnitTest # юнит-тесты
gradle :app:assembleRelease # релиз (R8 включён)Без Android SDK (например, в облачной песочнице) код можно проверить через tools/sandbox-check.
- AGENTS.md — памятка для разработчиков и AI-агентов.
- docs/ARCHITECTURE.md — устройство приложения.
- docs/NETWORKING.md — путь трафика, TCP-стек, DNS, управление потоком SSH.
- docs/SETTINGS.md — настройки и где они хранятся.
- docs/TV_UI.md — правила UI для управления пультом.
- docs/SERVER.md — подготовка сервера и скрипт пользователя для тоннеля.
- docs/RELEASES.md — версии, выпуск релиза, обновление внутри приложения.
- docs/TESTING.md — тесты и проверка без Android SDK.