Repository navigation
it 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 è un modulo KernelSU / APatch / Magisk che esegue esattamente un daemon SSH Dropbear, guidato interamente dalla configurazione. Nulla del server SSH è cablato a un singolo dispositivo; tutto ciò che è specifico è configurazione di runtime o un secret.
-
module/common/vddropbear.sh, la libreria centrale: carica la configurazione (con default incorporati sicuri), risolve il secret store, garantisce una host key, costruisce il vettore di argomenti di Dropbear e gestisce una singola istanza del daemon (start / stop / status / restart). -
module/service.sh: punto d'ingresso all'avvio. Rispetta la politica di avvio BFU/AFU; in modalità AFU attende che lo storage credential-encrypted si sblocchi senza bloccare l'avvio. -
module/action.sh, il pulsante Action del manager: (ri)avvia il daemon. Non legge mai lo stdin e distacca il daemon nella sua sessione, così il manager non si blocca. -
module/common/vddb-webui.sh+module/webroot/index.html: il backend e la pagina della WebUI. -
patches/: piccole patch verificabili applicate a Dropbear upstream in fase di build. -
scripts/build.sh,scripts/build-bundles.sh,.github/workflows/build.yml: la build.
vddb_start carica la configurazione, ferma ogni istanza in esecuzione, garantisce che esista una host
key, poi avvia un daemon. Il binario è distribuito come vddropbear, così il suo nome di processo
corrisponde esattamente a pgrep -x (il mksh di Android non ha exec -a). Viene avviato con setsid
così da distaccarsi dal gruppo di processi del chiamante: è questo che impedisce all'Action del manager
di bloccarsi.
Le impostazioni non sono secret e risiedono sullo storage device-encrypted (/data/adb/vddropbear),
leggibile all'avvio. I secret (host key, authorized_keys, hash delle password) risiedono per
impostazione predefinita sullo storage credential-encrypted (/data/misc_ce/0/vddropbear), che si
sblocca solo dopo l'autenticazione dell'utente. Attivare START_IN_BFU sposta i secret sullo storage
device-encrypted così che il daemon possa avviarsi prima del primo sblocco, al prezzo di rendere quei
secret leggibili prima. Il modulo calcola quale store usare a ogni fase dell'avvio.
Il server SSH resta Dropbear upstream; le nostre modifiche sono poche patch verificabili (vedi patches/README.md):
- un banner d'identità neutro, configurabile a runtime;
-
authorized_keysletto da un percorso impostato tramite environment (così le chiavi vivono nel secret store); - autenticazione con password contro un file di hash PBKDF2 anziché il
crypt()/shadow di sistema, che Android non ha (vedi BUILDING.md).
Una pagina statica nella WebUI del manager (KernelSU / APatch / WebUI-X). Guida
module/common/vddb-webui.sh attraverso il bridge ksu.exec: stato, start/stop/restart, lettura/scrittura
della configurazione e gestione di chiavi e account password. Tutti i dati attraversano il bridge
codificati in base64, così la shell non li interpreta mai; gli hash delle password sono calcolati nel
browser con WebCrypto, così la password in chiaro non lascia mai la pagina.
Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.