Skip to content

it CONFIGURATION

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


Configurazione

Le impostazioni risiedono in /data/adb/vddropbear/config (inizializzate da module/common/config.default al primo avvio). La WebUI modifica questo file al posto tuo; puoi anche modificarlo a mano. Viene caricato come shell, quindi usa KEY=value senza spazi attorno a =. Le impostazioni non sono secret e risiedono sullo storage device-encrypted; i secret (host key, authorized keys, hash delle password) risiedono nel secret store, mai qui.

Applica le modifiche riavviando il daemon (il Save & restart della WebUI fa questo).

Generale

Key Default Significato
ENABLED 1 Avvia il daemon all'avvio. 0 lo disabilita del tutto.
START_IN_BFU 0 0: avvia solo dopo il primo sblocco (AFU); i secret restano sullo storage credential-encrypted (CE). 1: avvia anche prima del primo sblocco (BFU); i secret passano allo storage device-encrypted (DE), leggibili prima dello sblocco.
PORT 2222 Porta di ascolto predefinita (le porte per-bind possono sovrascriverla in LISTEN_ADDRESSES).

Ascolto / bind (componibili)

È ammessa qualsiasi combinazione; i bind selezionati vengono uniti. Se cancelli tutto, VD Dropbear fa il bind su loopback anziché su ogni interfaccia.

Key Default Significato
LISTEN_LOOPBACK 1 Ascolta solo su 127.0.0.1 / ::1.
LISTEN_ALL 0 Ascolta su ogni interfaccia (0.0.0.0 / ::); espone il dispositivo.
LISTEN_IPV4 1 Includi i bind IPv4.
LISTEN_IPV6 1 Includi i bind IPv6.
LISTEN_ADDRESSES "" Bind specifici aggiuntivi, separati da virgola: addr (usa PORT) o addr:port, IPv4 o IPv6.

SSH via USB (senza wifi, senza ADB). Attiva il tethering USB del telefono e aggiungi il suo indirizzo USB (di solito 192.168.42.129) a LISTEN_ADDRESSES, con LISTEN_ALL disattivato. Il daemon è così raggiungibile solo tramite il cavo, di norma più veloce e stabile del wireless per i trasferimenti grandi.

Identità

Key Default Significato
HIDE_IDENT 1 Invia un banner d'identità SSH neutro così che gli scanner non possano riconoscere server/versione esatti.
IDENT_STRING "" Una stringa d'identità personalizzata. Vuota usa il default neutro incorporato.

Autenticazione

Un accesso viene eseguito con l'account con cui ti autentichi: root per impostazione predefinita, oppure un account con privilegi inferiori (shell, system). Le chiavi sono il default; le password sono opzionali.

Key Default Significato
PUBKEY_AUTH 1 Consenti l'accesso con chiave pubblica (legge le authorized keys nel secret store).
PASSWORD_AUTH 0 Consenti l'accesso con password. Quando è disattivato, il daemon viene avviato con l'autenticazione password disabilitata.
MAX_AUTH_TRIES 3 Numero massimo di tentativi di autenticazione per connessione.

Sessione / environment

Key Default Significato
LOGIN_SHELL "" Shell per la sessione. Vuota usa il default dell'account.
HOME_DIR "" HOME per la sessione. Vuota usa la directory del modulo.
EXTRA_ENV "" Environment aggiuntivo, K=V;K2=V2.
IDLE_TIMEOUT 0 Disconnetti dopo N secondi di inattività. 0 disabilita.
KEEPALIVE 0 Invia un keepalive ogni N secondi. 0 disabilita.
RECEIVE_WINDOW "" Dimensione della receive window di Dropbear. Vuota usa il default.

Forwarding (disattivato per impostazione predefinita)

Key Default Significato
ALLOW_LOCAL_FORWARD 0 Consenti il port forwarding locale (-L).
ALLOW_REMOTE_FORWARD 0 Consenti il port forwarding remoto (-R).
GATEWAY_PORTS 0 Consenti alle porte remote inoltrate di fare il bind su tutte le interfacce.

Host key

Key Default Significato
HOSTKEY_TYPE ed25519 Tipo di host key: ed25519, rsa o ecdsa. Generata al primo avvio nel secret store.

Il secret store

Non configurato qui, risolto da START_IN_BFU:

  • AFU (default): /data/misc_ce/0/vddropbear/secret: credential-encrypted, disponibile solo dopo che sblocchi il dispositivo.
  • BFU: /data/adb/vddropbear/secret: device-encrypted, leggibile prima del primo sblocco.

Contiene la host key, authorized_keys e il file di hash passwd. Vedi BUILDING.md per il formato dell'hash delle password.


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

Clone this wiki locally