Repository navigation
fr 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 est un module KernelSU / APatch / Magisk qui exécute exactement un démon SSH Dropbear, piloté entièrement par la configuration. Rien du serveur SSH n'est codé en dur pour un appareil précis ; tout ce qui est spécifique est de la configuration à l'exécution ou un secret.
-
module/common/vddropbear.sh, la bibliothèque centrale : charger la configuration (avec des valeurs par défaut intégrées et sûres), résoudre le magasin de secrets, garantir une host key, construire le vecteur d'arguments de Dropbear et gérer une unique instance du démon (start / stop / status / restart). -
module/service.sh: point d'entrée au démarrage. Respecte la politique de démarrage BFU/AFU ; en mode AFU, il attend que le stockage chiffré par identifiants se déverrouille sans bloquer le démarrage. -
module/action.sh, le bouton Action du gestionnaire : (re)lancer le démon. Il ne lit jamais stdin et détache le démon dans sa propre session, de sorte que le gestionnaire ne se fige pas. -
module/common/vddb-webui.sh+module/webroot/index.html: le backend et la page de la WebUI. -
patches/: de petits correctifs auditables appliqués à Dropbear upstream au moment de la compilation. -
scripts/build.sh,scripts/build-bundles.sh,.github/workflows/build.yml: la compilation.
vddb_start charge la configuration, arrête toute instance en cours, garantit l'existence d'une host key,
puis lance un unique démon. Le binaire est livré sous le nom vddropbear, de sorte que son nom de
processus correspond exactement à pgrep -x (le mksh d'Android n'a pas exec -a). Il est lancé avec
setsid pour se détacher du groupe de processus de l'appelant : c'est ce qui empêche l'Action du
gestionnaire de se bloquer.
Les réglages ne sont pas secrets et résident dans un stockage chiffré par appareil
(/data/adb/vddropbear), lisible au démarrage. Les secrets (host key, authorized_keys, hachages de
mots de passe) résident par défaut dans un stockage chiffré par identifiants
(/data/misc_ce/0/vddropbear), qui ne se déverrouille qu'après authentification de l'utilisateur.
Activer START_IN_BFU déplace les secrets vers le stockage chiffré par appareil afin que le démon puisse
s'exécuter avant le premier déverrouillage, au prix de secrets lisibles plus tôt. Le module calcule quel
magasin utiliser à chaque étape du démarrage.
Le serveur SSH reste Dropbear upstream ; nos modifications se limitent à quelques correctifs relisibles (voir patches/README.md) :
- une bannière d'identité neutre, configurable à l'exécution ;
-
authorized_keyslu depuis un chemin fixé par l'environnement (afin que les clés vivent dans le magasin de secrets) ; - l'authentification par mot de passe contre un fichier de hachage PBKDF2 plutôt que la fonction
crypt()/shadow du système, qui manque à Android (voir BUILDING.md).
Une page statique dans la WebUI du gestionnaire (KernelSU / APatch / WebUI-X). Elle pilote
module/common/vddb-webui.sh via le pont ksu.exec : état, start/stop/restart, lecture/écriture de la
configuration, et gestion des clés et des comptes avec mot de passe. Toutes les données traversent le
pont encodées en base64, de sorte que le shell ne les interprète jamais ; les hachages de mots de passe
sont calculés dans le navigateur avec WebCrypto, si bien que le mot de passe en clair ne quitte jamais la
page.
Cette documentation a été générée avec Claude (Anthropic) et est maintenue par VD171. Les corrections et améliorations sont les bienvenues ; voir CONTRIBUTING.md.