Skip to content

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


Architecture

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.

Les pièces

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

Cycle de vie du démon (instance unique)

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.

Le magasin de secrets (CE vs DE, BFU vs AFU)

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 jeu de correctifs

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_keys lu 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).

La WebUI

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.

Clone this wiki locally