Repository navigation
cs 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 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í.
-
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í.
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.
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.
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).
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.