Repository navigation
uk 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, що запускає рівно один демон Dropbear SSH, керований цілком через конфігурацію. У SSH-сервері немає нічого жорстко прив'язаного до одного пристрою; усе специфічне є конфігурацією середовища виконання або секретом.
-
module/common/vddropbear.sh: основна бібліотека: завантаження конфігурації (з безпечними вбудованими значеннями за замовчуванням), визначення сховища секретів, забезпечення host key, побудова вектора аргументів Dropbear та керування єдиним екземпляром демона (start / stop / status / restart). -
module/service.sh: вхід під час завантаження. Дотримується політики запуску BFU/AFU; у режимі AFU чекає на розблокування credential-encrypted сховища, не затримуючи завантаження. -
module/action.sh: кнопка Action у менеджері: (пере)запуск демона. Вона ніколи не читає stdin і від'єднує демон у власну сесію, тож менеджер не зависає. -
module/common/vddb-webui.sh+module/webroot/index.html: бекенд і сторінка WebUI. -
patches/: невеликі, придатні для аудиту патчі, що застосовуються до upstream-версії Dropbear під час збирання. -
scripts/build.sh,scripts/build-bundles.sh,.github/workflows/build.yml: збирання.
vddb_start завантажує конфігурацію, зупиняє будь-який запущений екземпляр, переконується в наявності
host key, а потім породжує один демон. Бінарний файл постачається як vddropbear, тож його ім'я
процесу точно відповідає pgrep -x (в Android mksh немає exec -a). Його запускають із setsid,
тож він від'єднується від групи процесів ініціатора: саме це не дає Action менеджера блокуватися.
Налаштування не є секретними й зберігаються в device-encrypted сховищі (/data/adb/vddropbear),
доступному під час завантаження. Секрети (host key, authorized_keys, хеші паролів) за замовчуванням
зберігаються в credential-encrypted сховищі (/data/misc_ce/0/vddropbear), яке розблоковується
лише після автентифікації користувача. Увімкнення START_IN_BFU переносить секрети в device-encrypted
сховище, щоб демон міг працювати до першого розблокування, ціною того, що ці секрети стають доступними
раніше. Модуль обчислює, яке сховище використати, на кожному етапі завантаження.
SSH-сервер лишається upstream-версією 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.