Skip to content

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


Guida utente

VD Dropbear dà al tuo dispositivo con root un server SSH privato. Questa guida ti porta dall'installazione a una connessione funzionante, incluso il trasferimento di file e la modalità before-first-unlock (BFU).

Un accesso è per impostazione predefinita una shell root completa. Preferisci le chiavi alle password, fai il bind solo su reti di cui ti fidi e non esporre mai la porta all'Internet aperto senza un motivo.

1. Installazione

Flasha lo zip del modulo nel manager KernelSU, APatch o Magisk (oppure da una shell con ksud module install / apd module install), poi apri la WebUI del modulo.

2. Aggiungi una chiave (consigliato)

Nella WebUI, sotto Authorized keys, incolla la tua chiave pubblica (ssh-ed25519 AAAA... you@host) e premi Add key. Le chiavi sono il default e il modo più sicuro per entrare.

Per generare una chiave sul tuo computer, se non ne hai una:

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

3. Oppure imposta una password

L'accesso con password è disattivato per impostazione predefinita (un accesso è root per impostazione predefinita, quindi le chiavi sono da preferire). Per abilitarlo, attiva Password login nelle impostazioni, poi sotto Password accounts imposta una password per l'utente di accesso. L'hash viene calcolato nel tuo browser con PBKDF2; la password stessa non lascia mai la pagina.

4. Scegli una porta e dove ascoltare

Sotto Settings, imposta la Port e scegli i bind. Per impostazione predefinita VD Dropbear ascolta solo su loopback; per raggiungerlo dalla tua LAN o da una VPN, abilita le interfacce che vuoi. Evita Listen on all interfaces a meno che tu non comprenda l'esposizione.

Premi Save & restart per applicare, poi Start se non è già in esecuzione.

5. Connetti

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 e rsync sono inclusi, così SFTP, sshfs, i client GUI e i backup funzionano tutti sulla stessa connessione.

Connettersi via USB (senza wifi, senza ADB)

Per trasferimenti più veloci e stabili, senza alcuna rete di mezzo, raggiungi il daemon tramite il cavo USB usando il tethering USB, senza ADB né debug USB:

  1. Collega il cavo, poi sul telefono attiva il tethering USB (Impostazioni -> Rete -> Hotspot e tethering).
  2. Il telefono entra in una piccola rete solo-USB, di solito a 192.168.42.129.
  3. Al passo 4 qui sopra, aggiungi quell'indirizzo ai bind specifici (LISTEN_ADDRESSES) e lascia tutte le interfacce disattivato, così il daemon risponde solo tramite il cavo.

Poi connettiti all'indirizzo USB invece che a quello wireless:

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

Se 192.168.42.129 non è l'indirizzo sul tuo dispositivo, controlla l'interfaccia USB del telefono con ip addr.

6. Prima del primo sblocco (BFU)

Per impostazione predefinita il daemon si avvia solo dopo che hai sbloccato il dispositivo una volta (AFU), perché i suoi secret risiedono sullo storage credential-encrypted. Se hai bisogno di SSH prima del primo sblocco (per esempio per sbloccare un dispositivo da remoto dopo un riavvio), attiva Start before first unlock (BFU). I secret passano allora allo storage device-encrypted, che è leggibile prima dello sblocco: un compromesso deliberato e documentato. Vedi Security model nel README.

7. Controllare il daemon

  • WebUI: Start / Stop / Restart, e stato in tempo reale (in esecuzione, PID, porta, modalità, fingerprint della host key).
  • Pulsante Action del manager: (ri)avvia il daemon.
  • Si avvia anche automaticamente all'avvio (a meno che tu non lo disabiliti).

Risoluzione dei problemi

  • Non si avvia. Controlla /data/adb/vddropbear/state/daemon.log. Assicurati che Enabled sia attivo e che sia stato possibile generare una host key.
  • Chiave rifiutata. Verifica che la riga della chiave pubblica sia esattamente quella che il tuo client offre, e che il nome utente con cui accedi sia uno che il sistema riconosce (di solito root).
  • Non riesco a connettermi da un'altra macchina. Probabilmente sei ancora in bind solo su loopback: abilita l'interfaccia che ti serve e riavvia.
  • SFTP/scp fallisce ma la shell funziona. Assicurati che il sftp-server incluso sia stato distribuito per la tua ABI; lo stato della WebUI mostra l'ABI rilevata.

Questa documentazione è stata generata con Claude (Anthropic) ed è gestita da VD171. Correzioni e miglioramenti sono benvenuti; vedi CONTRIBUTING.md.

Clone this wiki locally