Skip to content

de USER GUIDE

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


Benutzerhandbuch

VD Dropbear gibt deinem gerooteten Gerät einen privaten SSH-Server. Dieses Handbuch führt dich von der Installation bis zu einer funktionierenden Verbindung, einschließlich Dateiübertragung und des Modus vor der ersten Entsperrung (BFU).

Eine Anmeldung ist standardmäßig eine vollständige Root-Shell. Bevorzuge Schlüssel gegenüber Passwörtern, binde nur an Netzwerke, denen du vertraust, und gib den Port niemals ohne Grund ins offene Internet frei.

1. Installieren

Flashe das Modul-Zip im KernelSU-, APatch- oder Magisk-Manager (oder aus einer Shell mit ksud module install / apd module install) und öffne dann die WebUI des Moduls.

2. Einen Schlüssel hinzufügen (empfohlen)

Füge in der WebUI unter Authorized keys deinen öffentlichen Schlüssel ein (ssh-ed25519 AAAA... you@host) und drücke Add key. Schlüssel sind der Standard und der sicherste Weg hinein.

So erzeugst du auf deinem Computer einen Schlüssel, falls du keinen hast:

ssh-keygen -t ed25519 -C "you@host"
cat ~/.ssh/id_ed25519.pub     # paste this into the WebUI

3. Oder ein Passwort setzen

Die Passwortanmeldung ist standardmäßig aus (eine Anmeldung ist standardmäßig root, daher werden Schlüssel bevorzugt). Zum Aktivieren schalte in den Einstellungen Password login ein und setze dann unter Password accounts ein Passwort für den Anmeldebenutzer. Der Hash wird in deinem Browser mit PBKDF2 berechnet; das Passwort selbst verlässt die Seite nie.

4. Einen Port und das Lauschziel wählen

Setze unter Settings den Port und wähle die Bindungen. Standardmäßig lauscht VD Dropbear nur auf Loopback; um es aus deinem LAN oder einem VPN zu erreichen, aktiviere die gewünschten Schnittstellen. Vermeide Listen on all interfaces, es sei denn, du verstehst die damit verbundene Exponierung.

Drücke Save & restart zum Anwenden und dann Start, falls es nicht bereits läuft.

5. Verbinden

ssh -p 2222 root@<device-ip>
sftp -P 2222 root@<device-ip>
scp -P 2222 file root@<device-ip>:/sdcard/
rsync -e 'ssh -p 2222' -av ./dir/ root@<device-ip>:/sdcard/dir/

sftp-server, scp und rsync sind mitgeliefert, sodass SFTP, sshfs, GUI-Clients und Backups alle über dieselbe Verbindung funktionieren.

Über USB verbinden (ohne WLAN, ohne ADB)

Für schnellere, stabilere Übertragungen ganz ohne Netzwerk erreichst du den Daemon über das USB-Kabel per USB-Tethering, ohne ADB oder USB-Debugging:

  1. Kabel einstecken, dann am Telefon USB-Tethering einschalten (Einstellungen -> Netzwerk -> Hotspot und Tethering).
  2. Das Telefon ist dann in einem kleinen reinen USB-Netzwerk, meist unter 192.168.42.129.
  3. Füge diese Adresse in Schritt 4 oben bei den spezifischen Binds (LISTEN_ADDRESSES) hinzu und lass alle Schnittstellen aus, damit der Daemon nur über das Kabel antwortet.

Verbinde dich dann mit der USB-Adresse statt der drahtlosen:

ssh -p 2222 root@192.168.42.129
scp -P 2222 file root@192.168.42.129:/sdcard/

Falls 192.168.42.129 bei deinem Gerät nicht stimmt, prüfe die USB-Schnittstelle des Telefons mit ip addr.

6. Vor der ersten Entsperrung (BFU)

Standardmäßig startet der Daemon erst, nachdem du das Gerät einmal entsperrt hast (AFU), weil seine Geheimnisse auf mit Zugangsdaten verschlüsseltem Speicher liegen. Wenn du SSH vor der ersten Entsperrung brauchst (zum Beispiel, um ein Gerät nach einem Neustart aus der Ferne zu entsperren), schalte Start before first unlock (BFU) ein. Die Geheimnisse wandern dann auf gerätverschlüsselten Speicher, der vor der Entsperrung lesbar ist: ein bewusster, dokumentierter Kompromiss. Siehe Sicherheitsmodell in der README.

7. Den Daemon steuern

  • WebUI: Start / Stopp / Neustart und Live-Status (läuft, PID, Port, Modus, Host-Schlüssel-Fingerprint).
  • Action-Schaltfläche des Managers: startet den Daemon (neu).
  • Er startet außerdem automatisch beim Booten (sofern du ihn nicht deaktivierst).

Fehlerbehebung

  • Er startet nicht. Prüfe /data/adb/vddropbear/state/daemon.log. Stelle sicher, dass Enabled an ist und ein Host-Schlüssel erzeugt werden konnte.
  • Schlüssel abgelehnt. Vergewissere dich, dass die Zeile des öffentlichen Schlüssels genau so ist, wie dein Client sie anbietet, und dass der Benutzername, mit dem du dich anmeldest, einer ist, den das System auflöst (gewöhnlich root).
  • Keine Verbindung von einem anderen Rechner. Wahrscheinlich bist du noch nur an Loopback gebunden: aktiviere die benötigte Schnittstelle und starte neu.
  • SFTP/scp schlägt fehl, aber die Shell funktioniert. Stelle sicher, dass der mitgelieferte sftp-server für deine ABI ausgeliefert wurde; der WebUI-Status zeigt die erkannte ABI.

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

Clone this wiki locally