下面说明哪些功能可以日常使用,哪些需要先开启实验开关。无论使用哪类功能,仍需单独测试自己的恢复方案。
核心(Core)
跳转到“核心(Core)”| 能力 | 当前边界 |
|---|---|
| USB 发现与配对 | 首次配对通过 USB 连接,在设备上按提示输入锁屏密码,或解锁后接受 Trust(信任);无需持续保持解锁或亮屏。 |
| 手动 USB 备份 | 建议先用 USB 完成首次备份。保持设备连接,并核实备份确实完成。 |
| 定时备份 | 使用每设备的时间窗、间隔、电量和充电条件;跳过的任务会等下次调度检查。 |
| 只读查看 | 备份信息、文件清单和 CSV 查看不会修改备份;大型备份可能需要数分钟。 |
| 本地 Web UI 与单管理员认证 | 没有遥测或远程前端资源。认证仅面向单管理员,不能让公网暴露变得安全。 |
| 可选通知 | Telegram、SMTP、企业微信、Bark 和 Webhook 只在管理员配置后发送,但不保证每条都能送达;通知失败不会使备份失败。 |
| Wi-Fi 备份 | 必须先通过 USB 成功配对,保留有效 lockdown 记录,网络可达,且设备支持相应的无线通信。长传输可能因休眠或重新连接失败,失败时改用 USB 重试。 |
| 开启/关闭备份加密 | 需要有效主密钥(默认自动保存为 /configs/secret_key,或高级配置的原密钥)、在线设备和备份密码;在手机上按提示输入锁屏密码或完成授权即可。必须在应用外另存设备密码和主密钥。 |
| 修改备份密码 | 需要旧密码、新密码和在线设备。丢失备份密码可能导致加密备份无法使用。 |
Core 能力仍需在你的设备和网络上验证。更换设备或升级设备系统后,都应先在非关键设备上完成备份,再启用定时任务;加密备份能否读取、设备能否恢复需要分别验证。
实验(Experimental,默认关闭)
跳转到“实验(Experimental,默认关闭)”| 能力 | 默认门禁 | 风险 |
|---|---|---|
| 整机恢复 | 每设备 restore_enabled=false |
会修改设备数据;还需要 CSRF 防护和多重明确确认,目前不能作为已验证的日常恢复方案。 |
| 本地解包 | IOSBK_ENABLE_EXPERIMENTAL_OPERATIONS=false |
只支持具有明文 SQLite Manifest.db 的完整未加密备份;会生成第二份文件并占用大量磁盘空间。 |
| 删除本地备份 | IOSBK_ENABLE_EXPERIMENTAL_OPERATIONS=false |
输入设备名确认后,不可逆地删除该设备的本地备份。 |
全局实验开关只严格接受 true。为 false 时,解包/删除控件不会显示,对应 API 会在访问备份状态或文件系统前返回 403。开启开关不会绕过 CSRF、输入校验、并发保护和确认步骤。
在重要数据上启用恢复、解包或删除前,必须先做隔离测试,备份当前 /backups、/configs、/var/lib/lockdown,并准备回滚方案。