Skip to content

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


Gebruikershandleiding

VD Dropbear geeft je geroote toestel een private SSH-server. Deze handleiding neemt je mee van installatie tot een werkende verbinding, inclusief bestandsoverdracht en de before-first-unlock (BFU) modus.

Een login geeft standaard een volledige root-shell. Geef de voorkeur aan sleutels boven wachtwoorden, bind alleen aan netwerken die je vertrouwt, en stel de poort nooit zonder reden bloot aan het open internet.

1. Installeren

Flash de module-zip in de KernelSU-, APatch- of Magisk-manager (of vanuit een shell met ksud module install / apd module install), en open dan de WebUI van de module.

2. Een sleutel toevoegen (aanbevolen)

Plak in de WebUI, onder Authorized keys, je publieke sleutel (ssh-ed25519 AAAA... you@host) en druk op Add key. Sleutels zijn de standaard en de veiligste manier naar binnen.

Om op je computer een sleutel te genereren, als je er nog geen hebt:

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

3. Of stel een wachtwoord in

Wachtwoordlogin staat standaard uit (een login is standaard root, dus sleutels verdienen de voorkeur). Om het aan te zetten, zet Password login aan in de instellingen, en stel dan onder Password accounts een wachtwoord in voor de logingebruiker. De hash wordt in je browser berekend met PBKDF2; het wachtwoord zelf verlaat de pagina nooit.

4. Kies een poort en waar te luisteren

Stel onder Settings de Port in en kies de binds. Standaard luistert VD Dropbear alleen op loopback; om het vanaf je LAN of een VPN te bereiken, schakel de interfaces in die je wilt. Vermijd Listen on all interfaces tenzij je de blootstelling begrijpt.

Druk op Save & restart om toe te passen, en dan op Start als het nog niet draait.

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 en rsync zijn meegeleverd, zodat SFTP, sshfs, GUI-clients en back-ups allemaal over dezelfde verbinding werken.

Verbinden via USB (zonder wifi, zonder ADB)

Voor snellere, stabielere overdrachten zonder netwerk ertussen bereik je de daemon via de USB-kabel met USB-tethering, zonder ADB of USB-foutopsporing:

  1. Sluit de kabel aan en zet op de telefoon USB-tethering aan (Instellingen -> Netwerk -> Hotspot en tethering).
  2. De telefoon komt in een klein USB-only netwerk, meestal op 192.168.42.129.
  3. Voeg dat adres bij stap 4 hierboven toe aan de specifieke binds (LISTEN_ADDRESSES) en laat alle interfaces uit, zodat de daemon alleen via de kabel antwoordt.

Maak dan verbinding met het USB-adres in plaats van het draadloze:

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

Als 192.168.42.129 niet het adres op jouw apparaat is, bekijk dan de USB-interface van de telefoon met ip addr.

6. Before first unlock (BFU)

Standaard start de daemon pas nadat je het toestel één keer ontgrendelt (AFU), omdat de geheimen op credential-encrypted opslag staan. Als je SSH voor de eerste ontgrendeling nodig hebt (bijvoorbeeld om een toestel na een herstart op afstand te ontgrendelen) zet dan Start before first unlock (BFU) aan. De geheimen verhuizen dan naar device-encrypted opslag, die leesbaar is vóór ontgrendeling: een bewuste, gedocumenteerde afweging. Zie Security model in de README.

7. De daemon besturen

  • WebUI: Start / Stop / Restart, en live status (draait, PID, poort, modus, vingerafdruk van de hostsleutel).
  • Action-knop van de manager: (her)start de daemon.
  • Die start ook automatisch bij het opstarten (tenzij je het uitschakelt).

Problemen oplossen

  • Het start niet. Controleer /data/adb/vddropbear/state/daemon.log. Zorg dat Enabled aan staat en dat er een hostsleutel gegenereerd kon worden.
  • Sleutel geweigerd. Bevestig dat de regel met de publieke sleutel exact is zoals je client die aanbiedt, en dat de gebruikersnaam waarmee je inlogt er een is die het systeem herkent (meestal root).
  • Kan niet verbinden vanaf een andere machine. Je bent waarschijnlijk nog alleen aan loopback gebonden. Schakel de interface in die je nodig hebt en herstart.
  • SFTP/scp mislukt maar de shell werkt. Zorg dat de meegeleverde sftp-server voor jouw ABI is uitgeleverd; de WebUI-status toont de gedetecteerde ABI.

Deze documentatie is gegenereerd met Claude (Anthropic) en wordt onderhouden door VD171. Correcties en verbeteringen zijn welkom; zie CONTRIBUTING.md.

Clone this wiki locally