Wendor/teapod-stream
Wendor/teapod-stream has 558 GitHub stars and 46 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-17 04:00 UTC. Last push 2026-11-12.
Measured star growth
- in 24h
- 0
- in 7 days
- Collecting history
- in 15 days
- Collecting history
- in 1 month
- Collecting history
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
VPN-клиент для Android с поддержкой протокола Xray и интерфейсом TUN.
Developer ToolsREADME.md
OriginalTeapodStream
VPN-клиент для Android с поддержкой протокола Xray и интерфейсом TUN.
[!WARNING] Во избежание недопониманий, коротко о сути проекта и планах
Teapod Stream — это личный некоммерческий проект, главная цель которого — простота. Это не комбайн для гиков с сотней настроек, а просто удобный «человеческий» UI для VPN.
Развитие клиента происходит по мере необходимости: код допиливается, когда автор сам сталкивается с какими-то багами или нюансами.
- Приоритеты: проект на стадии набора базового функционала, поэтому минорные баги правятся в последнюю очередь.
- Releases: здесь лежат стабильные сборки, которые автор уже обкатал на себе.
- Pre-releases: активно разрабатываемые версии (всё может меняться и ломаться).

Возможности
- Протоколы: VLESS, VMess, Trojan, Shadowsocks, Hysteria2
- Транспорты: TCP, WebSocket, gRPC, H2, QUIC, xHTTP, HTTPUpgrade, SplitHTTP
- Шифрование: TLS, Reality (включая post-quantum ML-DSA-65)
- Shadowsocks prefix proxy — обход DPI для серверов с параметром
?prefix= - TUN-интерфейс — весь трафик устройства идёт через VPN
- Режим «только прокси» — запуск SOCKS5-прокси без поднятия TUN-туннеля
- Раздельное туннелирование — исключение или включение конкретных приложений
- Kill switch — блокировка трафика при обрыве VPN-соединения
- Авто-подключение при запуске приложения
- Авто-переподключение при смене сети (WiFi → LTE и обратно)
- Подписки — автоматическое обновление конфигураций по URL (включая self-signed TLS)
- Geo-маршрутизация — правила bypass/direct по geoip/geosite и доменным зонам
- QR-сканирование для быстрого добавления конфигураций
- Статистика трафика в реальном времени
Архитектура
Режим TUN (по умолчанию):
[Приложения] → [TUN-интерфейс] → [teapod-tun2socks] → [SOCKS5 127.0.0.1:port] → [xray-core] → [Сервер]
Режим «только прокси»:
[Приложение] → [SOCKS5 127.0.0.1:port] → [xray-core] → [Сервер]
- xray-core — ядро маршрутизации (XTLS/Xray-core)
- teapod-tun2socks — мост между TUN-интерфейсом и SOCKS5-прокси xray (AAR)
- Android VpnService — управление TUN-интерфейсом на уровне ОС
Настройки
Основные
| Параметр | По умолчанию | Описание |
|---|---|---|
| Автоподключение | выкл | Подключаться при запуске приложения |
| Kill switch | выкл | Блокировать трафик при разрыве VPN |
| Только прокси | выкл | SOCKS5 без VPN-туннеля (разрешения VPN не требуется) |
| Раздельное туннелирование | выкл | Включить/исключить конкретные приложения |
SOCKS5
| Параметр | По умолчанию | Описание |
|---|---|---|
| Случайный порт | вкл | Случайный SOCKS5-порт при каждом подключении |
| SOCKS5 порт | 10808 | Фиксированный порт (когда случайный выкл) |
| Случайные учётные данные | вкл | Генерировать логин/пароль при каждом подключении |
| Логин / Пароль | — | Фиксированные учётные данные (можно оставить пустыми) |
| UDP | вкл | Пропускать UDP-трафик через SOCKS |
DNS
| Параметр | По умолчанию | Описание |
|---|---|---|
| Режим DNS | Через VPN | Через VPN — резолв через xray DNS module; Локальный — системный резолвер напрямую |
| Блокировка QUIC | выкл | Запрещать UDP/443 для принудительного использования TCP |
Подписки
- Поддержка base64 и plain-text форматов
- Подписки с self-signed TLS-сертификатами: приложение показывает диалог с информацией о сертификате
- Авто-обновление по расписанию (настраиваемый интервал)
- HTTP User-Agent:
TeapodStream/<версия> (Android; XrayNG-compatible) Xray-core/<версия>
Сборка
# Скачать бинарные зависимости (teapod-core.aar + geodata)
./build.sh binaries
# Сборка и запуск на подключённом устройстве
./build.sh run # debug
./build.sh run-release # release
# Только сборка
./build.sh debug # debug APK
./build.sh release # release APK (split-per-ABI)
./build.sh aab # AAB для Google Play
./build.sh clean
Требования
- Flutter SDK (Dart SDK 3.11+)
- Android SDK
- Java 21+
Зависимости
Бинарные файлы загружаются автоматически при выполнении ./build.sh binaries:
- teapod-core (xray-core + teapod-tun2socks)
- geoip.dat / geosite.dat
Тестирование
Unit-тесты минимальны. Основная верификация — запуск на устройстве.
flutter test # запуск unit-тестов
flutter analyze
Поддерживаемые архитектуры
arm64-v8ax86_64armeabi-v7a
Лицензия
Проект использует open-source компоненты:
- Xray-core — MIT License
- teapod-tun2socks — MIT License