Android-приложение для настройки и обслуживания Яндекс Станций: хотспот с собственным DNS, встроенный ADB, профильные операции на колонке и панель управления.
Текущая версия: 1.0.21 · applicationId ab.root · Android 12L+ (API 32) · ARM64.
| Модуль | Назначение |
|---|---|
domain/ |
Чистая модель сессии, переходы, политика доступа и проверки |
bridge/ |
DFRoot, hostapd/TetheringShell, DNS-прокси, Shizuku, TUN/SOCKS, JNI |
station/ |
ADB-транспорт, профили моделей, YAM v2, SSH, Zsh, Wi-Fi, терминал |
backend/ |
Python-backend: DNS/HTTP/HTTPS, OTA, обратная связь, ручной режим |
app/ |
Compose-интерфейс, foreground-сервис, хранилище, обновления |
- выбор точной модели и отдельная инструкция сброса; профили Лайт/Мини/Миди/Станция 1/Станция 2/Макс/Стрит;
- временный root телефона через DFRoot/KernelSU или Shizuku на Android 13+;
- хотспот 2,4 ГГц, DNS UDP/TCP через выбранный backend, проверки точки, DNS, HTTP и обратной связи;
- встроенный ADB: поиск, повторное подключение, версия/UID/MAC, профильные шаги;
- блокировка OTA (включая
yandex-noupdate.sh), отдельные сценарии Станции 1 и Макс; - YAM v2 (
nyakokitsu/yam0.2.3): CLI, профили платформ, реестрofficial, пакеты; - SSH/Dropbear, Zsh, Entware/YSE, apkg, fastfetch — только по кнопке с подтверждением;
- терминал PTY, домашний Wi-Fi, смена пароля точки доступа;
- ручной режим прошивки: ZIP с телефона, шаблон base/станция, библиотека, проверка подписи;
- журнал и ZIP-диагностика без секретов, обновление приложения с докачкой.
Нужны JDK 17 и Android SDK 35.
JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home \
ANDROID_HOME=$HOME/Library/Android/sdk \
./gradlew :app:assembleRelease :app:testReleaseUnitTest :app:lintRelease \
:bridge:lintRelease :station:lintRelease :station:testReleaseUnitTest :domain:testAPK: app/build/outputs/apk/release/app-release.apk.
Release подписывается тем же ключом, что опубликованные сборки: без него обновление
поверх установленного приложения невозможно.
Kotlin проверяется ktlint, Java — Spotless (google-java-format, стиль AOSP),
Python-бэкенд — ruff; всё через Gradle, кроме ruff. Общие настройки стиля — в
.editorconfig, конфиг ruff — в pyproject.toml
(длина строки 88). Kotlin использует лимит 120; @Composable-функции исключены из
правила именования. Spotless переносит длинные строковые литералы Java (как и ручное
разбиение строк в Kotlin). Из форматирования исключены: вендорный DFRoot
(bridge/src/main/java/df/root/) — хранится без изменений от upstream; и
ComponentRemoval.java — ручная сборка shell-команд, где перенос строк
google-java-format ломает литералы рядом с text block.
./gradlew ktlintCheck # проверить Kotlin
./gradlew ktlintFormat # отформатировать Kotlin
./gradlew spotlessCheck # проверить Java
./gradlew spotlessApply # отформатировать Java
ruff check backend # проверить Python
ruff format backend # отформатировать PythonЛокальные проверки до коммита — через pre-commit
(.pre-commit-config.yaml): ruff автоформатирует
изменённый Python, а Kotlin и Java — через сам Gradle (ktlintFormat и
spotlessApply, единый источник правды с CI; запускаются по проекту при изменении
.kt/.java), плюс базовые проверки (финальный перевод строки, пробелы, конфликты
слияния). Установка:
pip install pre-commit && pre-commit install
pre-commit run --all-files # прогнать по всему репозиторию разовоТе же проверки и unit-тесты гоняются в CI (GitHub Actions,
.github/workflows/ci.yml) на push в main и в PR.
Исходники сервера — в backend/: Python, DNS/HTTP/HTTPS, выдача OTA,
ручной режим и обратная связь через DNS TXT. Основа — lite-kit (MIT) с локальными
доработками AliceBridge. Приложение не расшифровывает HTTPS колонки; DNS клиентов
хотспота направляется на выбранный сервер (78.24.223.83 по умолчанию), адрес
меняется в настройках. Сертификаты и образы прошивок в репозиторий не входят —
см. backend/README.md.
Встроенная проверка читает AliceBridge-update.json, проверяет размер, SHA-256,
имя/версию пакета и подпись. Загрузка поддерживает докачку и не обрывается по общему
таймеру.
Служба на колонке описана в AGENT.md. Её исходники и релизы распространяются отдельно; приложение устанавливает подписанные бинарники с сервера.
- Совместимость root/ADB/OTA зависит от модели, прошивки и ядра; матрица проверок ведётся отдельно. Наличие профиля не означает подтверждённый проход.
- Макс и полный проход Станции 1 остаются экспериментальными.
- YAM v2 не поддерживает старые Lua-плагины: они перенесены в проект Luna.
- Приложение не получает root колонки автоматически и не перепрошивает boot без отдельного подтверждённого сценария.
Приложение использует и/или содержит код, бинарники и данные перечисленных проектов.
Полные тексты лицензий, где они есть, лежат в station/src/main/assets/licenses/,
station/src/main/assets/terminal/*-LICENSE и в upstream-репозиториях.
| Проект | Что используется | Версия / commit | Лицензия |
|---|---|---|---|
| lite-kit | Сетевой контракт backend: DNS/OTA, служебные домены, обратная связь, шаблоны запросов; на нём основана серверная часть и проверенные сетевые адаптеры | upstream 168144a79f5cbad700ee6dea4e223c37bf4cbe1c, локальная база 19d3e0dae947007037a2b94c8139001d8f929770 |
MIT |
| DFRoot | Временный root телефона, native runner и библиотеки libdfroot/libbootstrap |
49e992ef3c9f7ec03c8efea6e3cf552f7ec6a347 |
GPL-2.0 |
| VPN Hotspot | Схема TetheringManager и обратимых правил хотспота | 6e3d4a4f9db4f72d0d4a422350b5234cddb52c48 |
Apache-2.0 |
| Android ADB (AOSP) | Встроенный adb client/server, libadb.so; подготовка tools/prepare_adb.py |
platform-tools из Android SDK | Apache-2.0 |
| Shizuku | API 13.1.5, UserService и сетевой режим без root | API 13.1.5, upstream b844bc491f1790c72328e1a8e5b2349f8978f0ea |
MIT |
| HEV socks5 tunnel | hev-socks5-tunnel-2.19.3.aar, TUN/SOCKS-транспорт |
2.19.3 |
MIT (core), BSD (lwIP) |
| YAM | Пакетный менеджер станции, CLI yam, профили платформ, реестр |
yam-v0.2.3 |
Файл лицензии в upstream отсутствует; бинарники взяты из официального релиза |
| yapkg | Каталог/формат .yap и пакеты прежнего YAM |
по релизу yapkg | Файл лицензии в upstream отсутствует |
| yandex-station-extended | YSE 0.4.0, yandex-noupdate.sh, скрипты и документация |
00806fe5ef81eba39c72cc7c9e0fba8b14bd9c06 |
CC BY 4.0 |
| quasar-unlock | Справочные manifest/platform-шаблоны и последовательности запросов | 17354b153a36a96bf99f59f1c156cc3564b904ea |
MIT |
| apkg | Бинарник и каталог apkg; проект initialfox | по релизу initialfox | Файл лицензии в upstream отсутствует |
| Entware | Пакетный менеджер, curl, CA-бандл и ARM64/ARMv7-пакеты внутри APK | bundled | GPL-2.0 (проект); каждый пакет сохраняет свою лицензию |
| Dropbear SSH | Бинарники Dropbear/Dropbearkey для SSH | 2022.82 |
MIT-подобная лицензия Dropbear |
| Zsh | Бинарники и конфигурация Zsh | bundled ARM64/ARMv7 | MIT-подобная лицензия Zsh |
| fastfetch | Бинарник и оформление fastfetch | bundled | MIT |
| xterm.js | Терминал в WebView, addon-fit |
bundled | MIT |
| KernelSU | Внешний менеджер root, совместимость (код не включается) | внешняя установка | GPL-2.0 |
| AndroidX / Compose / Kotlin / coroutines | UI и рантайм приложения | Gradle-зависимости | Apache-2.0 |
| JUnit, org.json | Только unit-тесты | test-only | EPL-1.0 / JSON License |
Отдельно: lite-kit — MIT-проект krevetkqqq. Backend и протокол обратной связи
AliceBridge выросли из него; исходники серверной части находятся в backend/
вместе с локальными изменениями (формат статуса, ручной режим, конкурентный DNS,
проверки).
Собственный код AliceBridge распространяется по LICENSE. Если компонент не имеет файла лицензии upstream (YAM, yapkg, apkg), это указано явно; такие бинарники не перелицензируются, а используются в том виде, в котором опубликованы авторами.
- INTIAILFOX — автор и основной разработчик проекта.