Skip to content

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


Architektur

VD Dropbear ist ein Modul für KernelSU / APatch / Magisk, das genau einen Dropbear-SSH-Daemon betreibt, vollständig durch Konfiguration gesteuert. Nichts am SSH-Server ist fest auf ein Gerät verdrahtet; alles Spezifische ist Laufzeitkonfiguration oder ein Geheimnis.

Bestandteile

  • module/common/vddropbear.sh, die Kernbibliothek: Konfiguration laden (mit sicheren eingebauten Standardwerten), den Geheimnisspeicher auflösen, einen Host-Schlüssel sicherstellen, den Argumentvektor für Dropbear bauen und eine einzelne Daemon-Instanz verwalten (Start / Stopp / Status / Neustart).
  • module/service.sh: Einstiegspunkt beim Booten. Befolgt die BFU/AFU-Startrichtlinie; im AFU-Modus wartet er darauf, dass der mit Zugangsdaten verschlüsselte Speicher entsperrt wird, ohne den Bootvorgang aufzuhalten.
  • module/action.sh, die Action-Schaltfläche des Managers: den Daemon (neu) starten. Er liest nie stdin und löst den Daemon in eine eigene Sitzung ab, sodass der Manager nicht hängen bleibt.
  • module/common/vddb-webui.sh + module/webroot/index.html: das WebUI-Backend und die Seite.
  • patches/: kleine, prüfbare Patches, die zur Buildzeit auf das Upstream-Dropbear angewendet werden.
  • scripts/build.sh, scripts/build-bundles.sh, .github/workflows/build.yml: der Build.

Daemon-Lebenszyklus (eine einzige Instanz)

vddb_start lädt die Konfiguration, stoppt jede laufende Instanz, stellt sicher, dass ein Host-Schlüssel existiert, und startet dann einen Daemon. Die Binärdatei wird als vddropbear ausgeliefert, sodass ihr Prozessname genau zu pgrep -x passt (Androids mksh kennt kein exec -a). Sie wird mit setsid gestartet, damit sie sich von der Prozessgruppe des Aufrufers löst: genau das verhindert, dass die Action des Managers blockiert.

Der Geheimnisspeicher (CE vs. DE, BFU vs. AFU)

Einstellungen sind nicht geheim und liegen auf gerätverschlüsseltem Speicher (/data/adb/vddropbear), der beim Booten lesbar ist. Geheimnisse (Host-Schlüssel, authorized_keys, Passwort-Hashes) liegen standardmäßig auf mit Zugangsdaten verschlüsseltem Speicher (/data/misc_ce/0/vddropbear), der erst nach der Authentifizierung des Nutzers entsperrt wird. Das Einschalten von START_IN_BFU verschiebt die Geheimnisse auf gerätverschlüsselten Speicher, damit der Daemon vor der ersten Entsperrung laufen kann, um den Preis, dass diese Geheimnisse früher lesbar sind. Das Modul berechnet bei jeder Boot-Phase, welcher Speicher zu verwenden ist.

Der Patch-Satz

Der SSH-Server bleibt Upstream-Dropbear; unsere Änderungen sind einige wenige überprüfbare Patches (siehe patches/README.md):

  • ein neutraler, zur Laufzeit konfigurierbarer Identitäts-Banner;
  • authorized_keys wird aus einem per Umgebung gesetzten Pfad gelesen (damit die Schlüssel im Geheimnisspeicher liegen);
  • Passwort-Authentifizierung gegen eine PBKDF2-Hash-Datei statt gegen das systemeigene crypt()/shadow, das Android fehlt (siehe BUILDING.md).

Die WebUI

Eine statische Seite in der WebUI des Managers (KernelSU / APatch / WebUI-X). Sie steuert module/common/vddb-webui.sh über die ksu.exec-Brücke: Status, Start/Stopp/Neustart, Konfiguration lesen/schreiben sowie Verwaltung von Schlüsseln und Passwortkonten. Alle Daten überqueren die Brücke base64-codiert, sodass die Shell sie nie interpretiert; Passwort-Hashes werden im Browser mit WebCrypto berechnet, sodass das Klartext-Passwort die Seite nie verlässt.


Diese Dokumentation wurde mit Claude (Anthropic) erstellt und wird von VD171 gepflegt. Korrekturen und Verbesserungen sind willkommen; siehe CONTRIBUTING.md.

Clone this wiki locally