Skip to content

ru ARCHITECTURE

github-actions[bot] edited this page Nov 17, 2026 · 5 revisions

Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文


Архитектура

VD Dropbear является модулем KernelSU / APatch / Magisk, который запускает ровно один SSH-демон Dropbear, полностью управляемый конфигурацией. Ничто в SSH-сервере не зашито жёстко под одно устройство; всё специфичное является конфигурацией времени выполнения или секретом.

Составные части

  • module/common/vddropbear.sh: основная библиотека: загрузка конфигурации (с безопасными встроенными значениями по умолчанию), определение хранилища секретов, обеспечение наличия ключа хоста, построение вектора аргументов Dropbear и управление единственным экземпляром демона (start / stop / status / restart).
  • module/service.sh: точка входа при загрузке. Соблюдает политику запуска BFU/AFU; в режиме AFU ожидает разблокировки хранилища, зашифрованного учётными данными, не задерживая загрузку.
  • module/action.sh: кнопка Action менеджера: (пере)запуск демона. Она никогда не читает stdin и отделяет демон в отдельную сессию, поэтому менеджер не зависает.
  • module/common/vddb-webui.sh + module/webroot/index.html: бэкенд и страница WebUI.
  • patches/: небольшие, поддающиеся аудиту патчи, применяемые к апстрим-Dropbear при сборке.
  • scripts/build.sh, scripts/build-bundles.sh, .github/workflows/build.yml: сборка.

Жизненный цикл демона (единственный экземпляр)

vddb_start загружает конфигурацию, останавливает любой работающий экземпляр, обеспечивает наличие ключа хоста, а затем порождает один демон. Бинарник поставляется как vddropbear, поэтому имя его процесса в точности совпадает с pgrep -x (в андроидном mksh нет exec -a). Он запускается через setsid, благодаря чему отделяется от группы процессов вызывающего: именно это не даёт кнопке Action менеджера блокироваться.

Хранилище секретов (CE против DE, BFU против AFU)

Настройки не являются секретом и находятся в хранилище, зашифрованном на уровне устройства (/data/adb/vddropbear), читаемом при загрузке. Секреты (ключ хоста, authorized_keys, хеши паролей) по умолчанию попадают в хранилище, зашифрованное учётными данными (/data/misc_ce/0/vddropbear), которое разблокируется только после аутентификации пользователя. Включение START_IN_BFU переносит секреты в хранилище, зашифрованное на уровне устройства, чтобы демон мог работать до первой разблокировки, ценой того, что эти секреты становятся читаемыми раньше. Модуль на каждом этапе загрузки вычисляет, какое хранилище использовать.

Набор патчей

SSH-сервер остаётся апстрим-Dropbear; наши изменения представляют собой несколько поддающихся проверке патчей (см. patches/README.md):

  • нейтральный, настраиваемый во время выполнения баннер идентификации;
  • authorized_keys, читаемые из пути, заданного в окружении (чтобы ключи находились в хранилище секретов);
  • аутентификация по паролю по файлу с хешем PBKDF2 вместо системного crypt()/shadow, которого в Android нет (см. BUILDING.md).

WebUI

Статическая страница в WebUI менеджера (KernelSU / APatch / WebUI-X). Она управляет module/common/vddb-webui.sh через мост ksu.exec: статус, start/stop/restart, чтение/запись конфигурации и управление ключами и парольными учётными записями. Все данные проходят через мост в кодировке base64, поэтому шелл их никогда не интерпретирует; хеши паролей вычисляются в браузере с помощью WebCrypto, поэтому пароль в открытом виде никогда не покидает страницу.


Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.

Clone this wiki locally