Repository navigation
nl 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 is een KernelSU / APatch / Magisk-module die precies één Dropbear SSH-daemon draait, volledig aangestuurd door configuratie. Niets aan de SSH-server is hardcoded op één toestel; alles wat specifiek is, is runtimeconfiguratie of een geheim.
-
module/common/vddropbear.sh: de kernbibliotheek: config laden (met veilige ingebouwde standaardwaarden), de geheimenopslag bepalen, een hostsleutel verzekeren, de Dropbear-argumentvector opbouwen, en één enkele daemon-instantie beheren (start / stop / status / restart). -
module/service.sh: opstartingang. Respecteert het BFU/AFU-startbeleid; in AFU-modus wacht die op het ontgrendelen van credential-encrypted opslag zonder het opstarten op te houden. -
module/action.sh: de Action-knop van de manager: de daemon (opnieuw) starten. Die leest nooit stdin en maakt de daemon los in zijn eigen sessie, zodat de manager niet blijft hangen. -
module/common/vddb-webui.sh+module/webroot/index.html: de WebUI-backend en de pagina. -
patches/: kleine, controleerbare patches die bij het bouwen op upstream Dropbear worden toegepast. -
scripts/build.sh,scripts/build-bundles.sh,.github/workflows/build.yml: de build.
vddb_start laadt de config, stopt een eventueel draaiende instantie, verzekert dat er een hostsleutel bestaat, en start dan één daemon. De binary wordt geleverd als vddropbear, zodat de procesnaam precies overeenkomt met pgrep -x (Android mksh heeft geen exec -a). Die wordt gestart met setsid, zodat die loskomt van de procesgroep van de aanroeper: dat is wat de Action van de manager niet laat blokkeren.
Instellingen zijn niet geheim en staan op device-encrypted opslag (/data/adb/vddropbear), leesbaar bij het opstarten. Geheimen (hostsleutel, authorized_keys, wachtwoordhashes) staan standaard op credential-encrypted opslag (/data/misc_ce/0/vddropbear), die pas ontgrendelt nadat de gebruiker zich heeft geauthenticeerd. Door START_IN_BFU aan te zetten verplaatsen de geheimen naar device-encrypted opslag, zodat de daemon kan draaien vóór de eerste ontgrendeling, ten koste van het feit dat die geheimen eerder leesbaar zijn. De module berekent bij elke opstartfase welke opslag te gebruiken.
De SSH-server blijft upstream Dropbear; onze wijzigingen zijn een paar controleerbare patches (zie patches/README.md):
- een neutrale, tijdens runtime configureerbare identiteitsbanner;
-
authorized_keysdie wordt gelezen vanuit een via de omgeving ingesteld pad (zodat sleutels in de geheimenopslag staan); - wachtwoordauthenticatie tegen een PBKDF2-hashbestand in plaats van de systeem-
crypt()/shadow, die Android niet heeft (zie BUILDING.md).
Een statische pagina in de WebUI van de manager (KernelSU / APatch / WebUI-X). Die stuurt module/common/vddb-webui.sh aan via de ksu.exec-brug: status, start/stop/restart, config lezen/schrijven, en beheer van sleutels en wachtwoordaccounts. Alle data gaat base64-gecodeerd over de brug, zodat de shell die nooit interpreteert; wachtwoordhashes worden in de browser berekend met WebCrypto, zodat het wachtwoord in platte tekst de pagina nooit verlaat.
Deze documentatie is gegenereerd met Claude (Anthropic) en wordt onderhouden door VD171. Correcties en verbeteringen zijn welkom; zie CONTRIBUTING.md.