Skip to content

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


用户指南

VD Dropbear 为你已 root 的设备提供一个私有的 SSH 服务器。本指南带你从安装走到一个可用的连接,包括文件传输和 首次解锁前(BFU)模式。

登录默认就是一个完整的 root shell。 请优先使用密钥而非密码,只绑定到你信任的网络,并且没有理由 就绝不把端口暴露到开放的互联网。

1. 安装

在 KernelSU、APatch 或 Magisk 管理器中刷入模块的 zip(或在 shell 中用 ksud module install / apd module install),然后打开模块的 WebUI。

2. 添加一个密钥(推荐)

在 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

3. 或者设置一个密码

密码登录默认关闭(登录默认就是 root,所以更推荐密钥)。要启用它,请在设置中打开 Password login,然后在 Password accounts 下为登录用户设置一个密码。哈希会在你的浏览器中用 PBKDF2 计算;密码本身从不离开页面。

4. 选择端口以及在哪里监听

在 Settings 下,设置 Port 并选择各个绑定。默认情况下 VD Dropbear 只在 loopback 上监听;要从你的 LAN 或 VPN 访问它,请启用你想要的接口。除非你了解其中的暴露风险,否则请避免 Listen on all interfaces。

按 Save & restart 以应用,如果它尚未运行则按 Start。

5. 连接

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 连接(无需 wifi,无需 ADB)

若要完全不经过网络、获得更快更稳定的传输,可用 **USB 网络共享(USB tethering)**通过数据线连接守护进程,无需 ADB 或 USB 调试:

  1. 插上数据线,然后在手机上打开 USB 网络共享(设置 -> 网络 -> 热点与网络共享)。
  2. 手机会加入一个仅限 USB 的小型网络,通常是 192.168.42.129。
  3. 在上面的第 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 接口。

6. 首次解锁前(BFU)

默认情况下,守护进程只在你解锁设备一次之后(AFU)才启动,因为它的 secret 存放在 credential-encrypted 存储 上。如果你需要在首次解锁之前使用 SSH(例如在重启后远程解锁一台设备)请打开 Start before first unlock (BFU)。于是这些 secret 会移到 device-encrypted 存储上,在解锁前即可读取:这是一个 有意的、有文档记录的权衡。参见 README 中的安全模型。

7. 控制守护进程

  • 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。

Clone this wiki locally