Repository navigation
ru ARCHITECTURE
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
менеджера блокироваться.
Настройки не являются секретом и находятся в хранилище, зашифрованном на уровне устройства
(/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 менеджера (KernelSU / APatch / WebUI-X). Она управляет
module/common/vddb-webui.sh через мост ksu.exec: статус, start/stop/restart, чтение/запись
конфигурации и управление ключами и парольными учётными записями. Все данные проходят через мост в
кодировке base64, поэтому шелл их никогда не интерпретирует; хеши паролей вычисляются в браузере с
помощью WebCrypto, поэтому пароль в открытом виде никогда не покидает страницу.
Эта документация создана с помощью Claude (Anthropic) и поддерживается VD171. Исправления и улучшения приветствуются; см. CONTRIBUTING.md.