跳转到内容
EN

适用版本 v1.5.4

功能状态

查看 Markdown 来源

下面说明哪些功能可以日常使用,哪些需要先开启实验开关。无论使用哪类功能,仍需单独测试自己的恢复方案。

能力 当前边界
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,并准备回滚方案。