Skip to content

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


配置

设置存放在 /data/adb/vddropbear/config 中(首次启动时从 module/common/config.default 初始填充)。WebUI 会替你编辑这个文件;你也可以手动编辑它。它以 shell 方式被 source,因此请使用 KEY=value,= 两侧不留空格。设置 并非 secret,存放在 device-encrypted 存储中;secret(host keys、authorized keys、密码哈希)存放在 secret 存储中, 绝不在此处。

通过重启守护进程来应用更改(WebUI 的 Save & restart 会执行此操作)。

常规

Key Default Meaning
ENABLED 1 启动时运行守护进程。0 将其完全禁用。
START_IN_BFU 0 0:仅在首次解锁后启动(AFU);secret 保留在 credential-encrypted(CE)存储中。1:也在首次解锁前启动(BFU);secret 移到 device-encrypted(DE)存储中,解锁前即可读取。
PORT 2222 默认监听端口(各绑定的端口可在 LISTEN_ADDRESSES 中覆盖它)。

监听 / 绑定(可组合)

允许任意组合;所选的绑定会被合并。如果你把全部清空,VD Dropbear 会绑定 loopback,而不是每个接口。

Key Default Meaning
LISTEN_LOOPBACK 1 仅监听 127.0.0.1 / ::1。
LISTEN_ALL 0 在每个接口上监听(0.0.0.0 / ::);会暴露设备。
LISTEN_IPV4 1 包含 IPv4 绑定。
LISTEN_IPV6 1 包含 IPv6 绑定。
LISTEN_ADDRESSES "" 额外的特定绑定,以逗号分隔:addr(使用 PORT)或 addr:port,IPv4 或 IPv6。

通过 USB 的 SSH(无需 wifi,无需 ADB)。 打开手机的 USB 网络共享,在 LISTEN_ALL 关闭的情况下,把它的 USB 地址(通常是 192.168.42.129)加入 LISTEN_ADDRESSES。这样守护进程只能通过数据线访问,对于大文件传输通常比无线更快更稳定。

身份

Key Default Meaning
HIDE_IDENT 1 发送一个中性的 SSH 身份横幅,使扫描器无法指纹识别出确切的服务器/版本。
IDENT_STRING "" 自定义身份字符串。留空则使用中性的内置默认值。

认证

登录会以你用于认证的账户身份运行:默认为 root,也可以是权限更低的账户(shell、system)。密钥是默认方式;密码则需主动启用。

Key Default Meaning
PUBKEY_AUTH 1 允许公钥登录(读取 secret 存储中的 authorized keys)。
PASSWORD_AUTH 0 允许密码登录。关闭时,守护进程将在禁用密码认证的情况下启动。
MAX_AUTH_TRIES 3 每个连接的最大认证尝试次数。

会话 / 环境

Key Default Meaning
LOGIN_SHELL "" 会话使用的 shell。留空则使用账户默认值。
HOME_DIR "" 会话的 HOME。留空则使用模块目录。
EXTRA_ENV "" 额外环境变量,K=V;K2=V2。
IDLE_TIMEOUT 0 空闲 N 秒后断开连接。0 表示禁用。
KEEPALIVE 0 每 N 秒发送一次 keepalive。0 表示禁用。
RECEIVE_WINDOW "" Dropbear 接收窗口大小。留空则使用默认值。

转发(默认关闭)

Key Default Meaning
ALLOW_LOCAL_FORWARD 0 允许本地(-L)端口转发。
ALLOW_REMOTE_FORWARD 0 允许远程(-R)端口转发。
GATEWAY_PORTS 0 允许被转发的远程端口绑定到所有接口。

Host key

Key Default Meaning
HOSTKEY_TYPE ed25519 host key 类型:ed25519、rsa 或 ecdsa。首次启动时生成到 secret 存储中。

secret 存储

此处不作配置,由 START_IN_BFU 决定:

  • AFU(默认): /data/misc_ce/0/vddropbear/secret:credential-encrypted,仅在你解锁设备后才可用。
  • BFU: /data/adb/vddropbear/secret:device-encrypted,首次解锁前即可读取。

它保存 host key、authorized_keys 以及 passwd 哈希文件。密码哈希格式见 BUILDING.md。


本文档由 Claude (Anthropic) 生成,并由 VD171 维护。欢迎修正和改进;请参阅 CONTRIBUTING.md。

Clone this wiki locally