Repository navigation
zh 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 为你已 root 的设备提供一个私有的 SSH 服务器。本指南带你从安装走到一个可用的连接,包括文件传输和 首次解锁前(BFU)模式。
登录默认就是一个完整的 root shell。 请优先使用密钥而非密码,只绑定到你信任的网络,并且没有理由 就绝不把端口暴露到开放的互联网。
在 KernelSU、APatch 或 Magisk 管理器中刷入模块的 zip(或在 shell 中用
ksud module install / apd module install),然后打开模块的 WebUI。
在 WebUI 的 Authorized keys 下,粘贴你的公钥(ssh-ed25519 AAAA... you@host)并按 Add key。密钥是默认
方式,也是最安全的进入途径。
如果你还没有密钥,可在你的电脑上生成一个:
ssh-keygen -t ed25519 -C "you@host"
cat ~/.ssh/id_ed25519.pub # paste this into the WebUI密码登录默认关闭(登录默认就是 root,所以更推荐密钥)。要启用它,请在设置中打开 Password login,然后在 Password accounts 下为登录用户设置一个密码。哈希会在你的浏览器中用 PBKDF2 计算;密码本身从不离开页面。
在 Settings 下,设置 Port 并选择各个绑定。默认情况下 VD Dropbear 只在 loopback 上监听;要从你的 LAN 或 VPN 访问它,请启用你想要的接口。除非你了解其中的暴露风险,否则请避免 Listen on all interfaces。
按 Save & restart 以应用,如果它尚未运行则按 Start。
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 和 rsync 均已随附打包,因此 SFTP、sshfs、GUI 客户端和备份都能通过同一个连接工作。
若要完全不经过网络、获得更快更稳定的传输,可用 **USB 网络共享(USB tethering)**通过数据线连接守护进程,无需 ADB 或 USB 调试:
- 插上数据线,然后在手机上打开 USB 网络共享(设置 -> 网络 -> 热点与网络共享)。
- 手机会加入一个仅限 USB 的小型网络,通常是
192.168.42.129。 - 在上面的第 4 步中,把该地址加到指定绑定(
LISTEN_ADDRESSES)里,并让所有接口保持关闭,这样守护进程只通过数据线响应。
然后连接 USB 地址,而不是无线地址:
ssh -p 2222 root@192.168.42.129
scp -P 2222 file root@192.168.42.129:/sdcard/如果 192.168.42.129 不是你设备上的地址,用 ip addr 查看手机的 USB 接口。
默认情况下,守护进程只在你解锁设备一次之后(AFU)才启动,因为它的 secret 存放在 credential-encrypted 存储 上。如果你需要在首次解锁之前使用 SSH(例如在重启后远程解锁一台设备)请打开 Start before first unlock (BFU)。于是这些 secret 会移到 device-encrypted 存储上,在解锁前即可读取:这是一个 有意的、有文档记录的权衡。参见 README 中的安全模型。
- WebUI: Start / Stop / Restart,以及实时状态(运行中、PID、端口、模式、host key 指纹)。
- 管理器 Action 按钮:(重新)启动守护进程。
- 它也会在启动时自动运行(除非你将其禁用)。
-
它无法启动。 检查
/data/adb/vddropbear/state/daemon.log。确认 Enabled 已开启,并且 host key 能够被 生成。 -
密钥被拒绝。 确认公钥那一行与你的客户端所提供的完全一致,并且你用于登录的用户名是系统能够解析的(通常是
root)。 - 无法从另一台机器连接。 你多半仍然只绑定到了 loopback,请启用你需要的接口并重启。
-
SFTP/scp 失败但 shell 正常。 确认随附的
sftp-server已为你的 ABI 发布;WebUI 状态会显示检测到的 ABI。
本文档由 Claude (Anthropic) 生成,并由 VD171 维护。欢迎修正和改进;请参阅 CONTRIBUTING.md。