Skip to content
usmanecPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SSH Tunnel

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/.

Быстрый старт

  1. На сервере заведите пользователя, который умеет только пробрасывать порты (без оболочки и SFTP):
    curl -fsSLO https://raw.githubusercontent.com/usmanec/sshtunnel/main/server/sshtunnel-user.sh
    sudo bash sshtunnel-user.sh
    Скрипт спросит способ входа (ключ, пароль или оба), при желании ограничит адреса и выведет данные для приложения. Подробнее — docs/SERVER.md.
  2. Добавьте сервер: Servers → Add Server, укажите адрес, пользователя и пароль или ключ. Нажмите Test Connection.
  3. Выберите приложения: Apps → отметьте нужные (по умолчанию в тоннель идут только они).
  4. На главном экране нажмите большую кнопку подключения и подтвердите системный запрос.

Android TV

  • Стрелки — перемещение, 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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages