Skip to content

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


Architektura

VD Dropbear je modul pro KernelSU / APatch / Magisk, který spouští přesně jeden démon Dropbear SSH, řízený výhradně konfigurací. Na serveru SSH není nic napevno svázáno s jedním zařízením; vše specifické je buď běhová konfigurace, nebo tajemství.

Součásti

  • module/common/vddropbear.sh, základní knihovna: načte konfiguraci (s bezpečnými vestavěnými výchozími hodnotami), určí úložiště tajemství, zajistí hostitelský klíč, sestaví vektor argumentů Dropbearu a spravuje jedinou instanci démona (start / stop / stav / restart).
  • module/service.sh: vstupní bod při startu. Respektuje politiku spuštění BFU/AFU; v režimu AFU čeká na odemčení úložiště šifrovaného přihlašovacími údaji, aniž by blokoval start.
  • module/action.sh, tlačítko Action ve správci: (znovu)spustí démona. Nikdy nečte stdin a odpojí démona do vlastní relace, takže se správce nezasekne.
  • module/common/vddb-webui.sh + module/webroot/index.html: backend WebUI a jeho stránka.
  • patches/: malé, auditovatelné záplaty aplikované na upstreamový Dropbear při sestavení.
  • scripts/build.sh, scripts/build-bundles.sh, .github/workflows/build.yml: sestavení.

Životní cyklus démona (jediná instance)

vddb_start načte konfiguraci, zastaví případnou běžící instanci, zajistí existenci hostitelského klíče a poté spustí jednoho démona. Binárka se dodává jako vddropbear, takže název jejího procesu přesně odpovídá pgrep -x (Android mksh nemá exec -a). Spouští se přes setsid, aby se odpojila od skupiny procesů volajícího: právě to brání tomu, aby se tlačítko Action ve správci zablokovalo.

Úložiště tajemství (CE vs DE, BFU vs AFU)

Nastavení nejsou tajná a leží na úložišti šifrovaném zařízením (/data/adb/vddropbear), čitelném při startu. Tajemství (hostitelský klíč, authorized_keys, otisky hesel) jsou ve výchozím nastavení na úložišti šifrovaném přihlašovacími údaji (/data/misc_ce/0/vddropbear), které se odemkne až po ověření uživatele. Zapnutí START_IN_BFU přesune tajemství na úložiště šifrované zařízením, aby mohl démon běžet před prvním odemčením, za cenu toho, že jsou tato tajemství čitelná dříve. Modul při každé fázi startu určí, které úložiště použít.

Sada záplat

Server SSH zůstává upstreamovým Dropbearem; naše změny jsou jen několik přezkoumatelných záplat (viz patches/README.md):

  • neutrální banner identity konfigurovatelný za běhu;
  • authorized_keys čtené z cesty nastavené prostředím (aby klíče ležely v úložišti tajemství);
  • ověřování heslem proti souboru otisků PBKDF2 místo systémového crypt()/shadow, který Androidu chybí (viz BUILDING.md).

WebUI

Statická stránka ve WebUI správce (KernelSU / APatch / WebUI-X). Řídí module/common/vddb-webui.sh přes most ksu.exec: stav, start/stop/restart, čtení/zápis konfigurace a správu klíčů a účtů s heslem. Všechna data procházejí mostem zakódovaná v base64, takže je shell nikdy neinterpretuje; otisky hesel se počítají v prohlížeči pomocí WebCrypto, takže heslo v čitelné podobě nikdy stránku neopustí.


Tato dokumentace byla vytvořena pomocí Claude (Anthropic) a spravuje ji VD171. Opravy a vylepšení jsou vítány; viz CONTRIBUTING.md.

Clone this wiki locally