Repository navigation
sv 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 är en KernelSU- / APatch- / Magisk-modul som kör exakt en Dropbear SSH-daemon, helt styrd av konfiguration. Ingenting i SSH-servern är hårdkodat till en viss enhet; allt specifikt är körtidskonfiguration eller en hemlighet.
-
module/common/vddropbear.sh: kärnbiblioteket: läser in konfigurationen (med säkra inbyggda standardvärden), löser upp hemlighetslagret, säkerställer en värdnyckel, bygger Dropbears argumentvektor och hanterar en enda daemon-instans (start / stopp / status / omstart). -
module/service.sh: uppstartsingång. Följer BFU/AFU-startpolicyn; i AFU-läge väntar den på att det credential-encrypted lagret ska låsas upp utan att bromsa uppstarten. -
module/action.sh: hanterarens Action-knapp: (åter)starta daemonen. Den läser aldrig stdin och kopplar loss daemonen till sin egen session, så hanteraren hänger sig inte. -
module/common/vddb-webui.sh+module/webroot/index.html: WebUI:ns backend och sida. -
patches/: små, granskningsbara patchar som appliceras på upstream Dropbear vid byggtid. -
scripts/build.sh,scripts/build-bundles.sh,.github/workflows/build.yml: bygget.
vddb_start läser in konfigurationen, stoppar varje körande instans, säkerställer att en värdnyckel
finns och startar sedan en daemon. Binären levereras som vddropbear, så dess processnamn matchar
pgrep -x exakt (Androids mksh saknar exec -a). Den startas med setsid så att den kopplas loss
från anroparens processgrupp: det är det som gör att hanterarens Action inte blockerar.
Inställningar är inte hemliga och ligger på device-encrypted lagring (/data/adb/vddropbear), läsbar
vid uppstart. Hemligheter (värdnyckel, authorized_keys, lösenordshashar) hamnar som standard på
credential-encrypted lagring (/data/misc_ce/0/vddropbear), som bara låses upp efter att
användaren autentiserat sig. Att slå på START_IN_BFU flyttar hemligheterna till device-encrypted
lagring så att daemonen kan köra före första upplåsningen, till priset av att dessa hemligheter blir
läsbara tidigare. Modulen räknar ut vilket lager som ska användas i varje uppstartssteg.
SSH-servern förblir upstream Dropbear; våra ändringar är ett fåtal granskningsbara patchar (se patches/README.md):
- en neutral, körtidskonfigurerbar identitetsbanner;
-
authorized_keysläses från en sökväg satt via miljön (så att nycklar ligger i hemlighetslagret); - lösenordsautentisering mot en PBKDF2-hashfil i stället för systemets
crypt()/shadow, som Android saknar (se BUILDING.md).
En statisk sida i hanterarens WebUI (KernelSU / APatch / WebUI-X). Den driver
module/common/vddb-webui.sh genom ksu.exec-bryggan: status, start/stopp/omstart, läsning/skrivning
av konfiguration och hantering av nycklar och lösenordskonton. All data passerar bryggan
base64-kodad, så skalet tolkar den aldrig; lösenordshashar beräknas i webbläsaren med WebCrypto, så det
klartextlösenordet lämnar aldrig sidan.
Denna dokumentation genererades med Claude (Anthropic) och underhålls av VD171. Rättelser och förbättringar välkomnas; se CONTRIBUTING.md.