Repository navigation
fr USER GUIDE
Languages: English | العربية | Čeština | Deutsch | Español | فارسی | Français | हिन्दी | Bahasa Indonesia | Italiano | 日本語 | 한국어 | Nederlands | Polski | Português | Русский | Svenska | ไทย | Türkçe | Українська | Tiếng Việt | 中文
VD Dropbear donne à votre appareil rooté un serveur SSH privé. Ce guide vous mène de l'installation à une connexion fonctionnelle, y compris le transfert de fichiers et le mode avant le premier déverrouillage (BFU).
Une connexion est par défaut un shell root complet. Préférez les clés aux mots de passe, faites le bind uniquement sur des réseaux de confiance, et n'exposez jamais le port à l'Internet ouvert sans raison.
Flashez le zip du module dans le gestionnaire KernelSU, APatch ou Magisk (ou depuis un shell
avec ksud module install / apd module install), puis ouvrez la WebUI du module.
Dans la WebUI, sous Authorized keys, collez votre clé publique (ssh-ed25519 AAAA... you@host) et
appuyez sur Add key. Les clés sont la valeur par défaut et la façon la plus sûre d'entrer.
Pour générer une clé sur votre ordinateur, si vous n'en avez pas :
ssh-keygen -t ed25519 -C "you@host"
cat ~/.ssh/id_ed25519.pub # paste this into the WebUILa connexion par mot de passe est désactivée par défaut (une connexion est root par défaut, donc les clés sont préférées). Pour l'activer, activez Password login dans les réglages, puis sous Password accounts définissez un mot de passe pour l'utilisateur de connexion. Le hachage est calculé dans votre navigateur avec PBKDF2 ; le mot de passe lui-même ne quitte jamais la page.
Sous Settings, définissez le Port et choisissez les binds. Par défaut, VD Dropbear écoute uniquement sur loopback ; pour l'atteindre depuis votre LAN ou un VPN, activez les interfaces voulues. Évitez Listen on all interfaces sauf si vous comprenez l'exposition que cela implique.
Appuyez sur Save & restart pour appliquer, puis sur Start s'il n'est pas déjà en marche.
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 et rsync sont inclus, donc SFTP, sshfs, les clients graphiques et les
sauvegardes fonctionnent tous sur la même connexion.
Pour des transferts plus rapides et plus stables, sans aucun réseau, atteignez le démon par le câble USB avec le partage de connexion USB, sans ADB ni débogage USB :
- Branchez le câble, puis sur le téléphone activez le partage de connexion USB (Paramètres -> Réseau -> Point d'accès et partage de connexion).
- Le téléphone rejoint un petit réseau USB uniquement, en général à
192.168.42.129. - À l'étape 4 ci-dessus, ajoutez cette adresse aux binds spécifiques (
LISTEN_ADDRESSES) et laissez toutes les interfaces désactivé, pour que le démon ne réponde que par le câble.
Connectez-vous ensuite à l'adresse USB plutôt qu'à l'adresse sans fil :
ssh -p 2222 root@192.168.42.129
scp -P 2222 file root@192.168.42.129:/sdcard/Si 192.168.42.129 n'est pas l'adresse sur votre appareil, vérifiez l'interface USB du téléphone avec ip addr.
Par défaut, le démon démarre uniquement après que vous avez déverrouillé l'appareil une fois (AFU), car ses secrets résident sur un stockage chiffré par identifiants. Si vous avez besoin de SSH avant le premier déverrouillage (par exemple pour déverrouiller un appareil à distance après un redémarrage), activez Start before first unlock (BFU). Les secrets passent alors sur un stockage chiffré par appareil, lisible avant le déverrouillage : un compromis délibéré et documenté. Voir Modèle de sécurité dans le README.
- WebUI : Start / Stop / Restart, et état en direct (en marche, PID, port, mode, empreinte de la host key).
- Bouton Action du gestionnaire : (re)lance le démon.
- Il démarre aussi automatiquement au boot (sauf si vous le désactivez).
-
Il ne démarre pas. Vérifiez
/data/adb/vddropbear/state/daemon.log. Assurez-vous que Enabled est activé et qu'une host key a pu être générée. -
Clé rejetée. Confirmez que la ligne de la clé publique est exactement celle que propose votre
client, et que le nom d'utilisateur avec lequel vous vous connectez est un compte que le système résout (généralement
root). - Impossible de se connecter depuis une autre machine. Vous êtes probablement encore en bind uniquement sur loopback : activez l'interface voulue et redémarrez.
-
SFTP/scp échoue mais le shell fonctionne. Assurez-vous que le
sftp-serverinclus a été livré pour votre ABI ; l'état de la WebUI montre l'ABI détectée.
Cette documentation a été générée avec Claude (Anthropic) et est maintenue par VD171. Les corrections et améliorations sont les bienvenues ; voir CONTRIBUTING.md.