Skip to content

About

AliceBridge: настройка и обслуживание Яндекс Станций с Android

Topics

Resources

Stars

24 stars

Watchers

0 watching

Forks

Repository files navigation

AliceBridge 2

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/yam 0.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:test

APK: 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

Исходники сервера — в 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

Служба на колонке описана в 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), это указано явно; такие бинарники не перелицензируются, а используются в том виде, в котором опубликованы авторами.

Contributors

  • INTIAILFOX — автор и основной разработчик проекта.

About

AliceBridge: настройка и обслуживание Яндекс Станций с Android

Topics

Resources

Stars

24 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages