Skip to content

sv 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 | 中文


Arkitektur

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.

Delar

  • 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.

Daemonens livscykel (en instans)

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.

Hemlighetslagret (CE kontra DE, BFU kontra AFU)

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.

Patchuppsättningen

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_keys lä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).

WebUI:n

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.

Clone this wiki locally