适用版本 v1.5.4

操作手册

这套手册适合在家中自己部署和管理 iOS Backup 的用户，步骤已对照当前代码、界面和已有测试记录核对。普通 Linux 主机使用 Docker Compose，群晖另有安装指南；中英文包含相同的操作内容。第一次使用，建议从带截图的快速开始入手。

首次启用计划前，请在非关键设备上完成一次 USB 备份 ，并按完整设备备份预留空间 。目前还没有通过本手册完成真机恢复的成功记录。备份任务是否完成、文件清单能否读取、能否恢复到设备，需要分别检查。

选择你要完成的任务

任务	完成后应能确认
开始前确认环境与支持边界	判断 Linux/NAS、权限和功能成熟度是否适合自己
安装、登录与更换管理员密码	创建全新实例并检查版本和持久化目录
在群晖 DSM 部署	核对 Container Manager、Compose、USB 与目录权限
连接 USB 并完成首次备份	按手机提示输入密码或确认信任、配对、开始备份并确认备份结果
设置自动备份	设置时间窗、间隔、电量和充电条件并观察一次执行
启用并验证 Wi-Fi 备份	用电脑准备手机、与 NAS 配对、测试无线备份，失败时改用 USB
管理备份加密与密码	区分四类密码，处理已有加密备份和接管限制
查看备份信息和导出清单	理解 5000 项限制、CSV 与完整数据的区别
设置并验证通知	保存规则、检查测试送达、观察真实事件
管理设备和存储	移除设备、重新添加、检查空间和保留副本
恢复手机数据：总览与准备	先保护现有备份，查看 Finder / Apple Devices 的前提与待验证范围
备份、迁移和恢复部署实例	同时保护主密钥、配置、配对记录和备份集
升级与回滚	固定镜像版本，验证升级结果并保留回退路径
评估实验操作	了解解包、删除、整机恢复的启用条件、风险和已验证范围
按症状排错	根据页面和日志先做简单检查，再决定重试或求助
查配置、路径和生效方式	区分程序/Compose 默认值与设备设置
看懂状态、进度和错误	看懂任务阶段、无活动超时，判断备份是否完成
排查高级 Wi-Fi / NAT 问题	仅在 USB 对照后调查跨网段和空闲连接

日常查看

在实际 Compose 部署目录运行，若端口已改变，请替换 9000：

docker compose ps
curl -fsS http://127.0.0.1:9000/healthz
curl --user iosbackup http://127.0.0.1:9000/api/version
docker compose logs --tail=200 iosbackup

curl 会提示输入管理员密码。/healthz 只确认 HTTP 能响应，不能证明设备就绪、磁盘可写或备份可恢复。日志含可能的设备与网络信息，分享前脱敏；当前没有公开日志下载 API。

始终保留的访问与数据边界

容器使用特权模式与宿主机网络，需要 USB/udev 挂载。只在可信主机和受限局域网/VPN 部署，保持认证开启，不要暴露到公网。跨网络访问使用合适的 HTTPS 与访问控制。

长期保存 /backups、整个 /configs（包括默认 secret_key、密码与摘要）、/var/lib/lockdown，以及所有使用的 Compose 配置文件和外部凭据。管理员密码、主密钥、备份密码、配对记录与用户数据都不能放入公开 Issue。容器镜像不包含这些数据。Core、Experimental 的边界见功能状态。

文档和验证材料

贡献者开发指南与离线测试指南：复现软件检查；不等于设备兼容性或恢复保证。
支持范围、隐私、安全报告：普通问题先准备脱敏环境和日志；漏洞按私密渠道报告。