备份恢复
MSM 的备份中心位于 系统设置 → 备份恢复，用于选择性备份、下载、导入和恢复系统数据。备份与恢复当前在界面中标记为实验性功能；生产环境的重要变更仍应额外保留一份离机备份。
备份的版本快照可能显示实际内核技术标识
mihomo；文档中统一将该管理方案称为 Clash。
备份页面只对管理员开放。
页面结构
页面分为两个工作区：
- 备份模块：创建备份、配置自动备份、管理服务器端存储位置
- 恢复模块：导入备份、查看备份列表、下载、恢复或删除备份
每份记录会显示来源、备份类型、大小、SHA-256、是否加密、包含模块、MSM / MosDNS / Clash / Sing-Box 版本快照，以及最近恢复状态。
可以备份什么
| 模块 | 典型内容 |
|---|---|
| 系统 | 账号、API Token、用户偏好、许可证、更新与备份设置、系统文件 |
| DNS | DNS 系统数据、MosDNS 配置、运行数据、客户端和相关文件 |
| 代理 | 网络设置、Clash、Sing-Box、订阅和 GitHub 下载设置 |
| 组件 | 组件设置、MosDNS / Clash / Sing-Box 二进制及版本记录 |
| 日志 | 审计、配置历史和运行日志 |
创建对话框默认选择系统、DNS、代理和组件，不默认包含日志。展开 高级选择 可以精确选择细分内容，减少备份体积和恢复影响范围。
创建手动备份
- 点击 创建备份
- 填写名称和说明
- 选择存储位置
- 选择需要的模块；必要时展开高级选择
- 如需加密，启用加密并设置独立强密码
- 创建成功后，在恢复模块的列表中确认大小、模块和版本快照
- 点击下载，把重要备份复制到 MSM 主机之外
备份密码无法替你找回
加密备份在下载和恢复时都需要密码。请把密码保存在独立的密码管理器中；不要和备份文件放在同一共享目录，也不要出现在截图、工单或 Git 仓库。
自动备份
点击自动备份卡片的 配置，可以设置：
- 是否启用
- 间隔小时数
- 自动备份保留份数
- 要备份的模块与细分内容
自动备份只保留页面配置的数量。它适合提供短期回滚点，但不替代离机备份；磁盘损坏、主机丢失或存储目录误删时，同机自动备份可能一起丢失。
存储位置
管理存储用于添加 MSM 服务端可访问的目录，并选择活动存储。页面会显示目录是否存在、是否可写以及当前备份数量。
- 路径是 MSM 进程或容器内部看到的路径
- Docker 部署要先把宿主目录挂载进容器，再填写容器内路径
- 不要把不可写、临时文件系统或容量不足的目录设为活动存储
- 新建路径前确认父目录权限和磁盘位置
导入时可以选择备份要进入的存储；导入完成只是把文件登记到备份列表，不会立即覆盖当前系统。
导入备份
- 在 恢复模块 选择备份文件
- 选择目标存储
- 加密备份填写密码
- 点击导入
- 在列表中核对来源、哈希、模块和版本快照
- 确认无误后再决定是否恢复
不要导入来源不明的备份。备份可能包含账号、运行配置、组件文件和敏感外部服务设置，应按可执行管理材料对待。
恢复备份
恢复会触发 MSM 自动重启：系统先写入待恢复任务，重启后在启动早期应用所选内容。
- 在备份列表点击 恢复
- 对比备份版本与当前运行版本
- 选择要恢复的模块；展开高级选择可只恢复细分内容
- 加密备份输入密码
- 确认恢复并等待 MSM 自动重启
- 重新登录，查看页面顶部的最近恢复结果
- 检查进程、系统诊断、DNS、代理和外部模块
版本差异当前只作为确认信息展示，并不会自动阻止恢复。跨大版本、跨平台或跨部署方式恢复前，应先在测试实例验证。
选择性恢复的边界
只恢复选中的细分内容，未选择项会保持当前状态。但配置之间可能存在引用关系，例如代理订阅、组件版本和网络设置。恢复后必须验证完整业务链路，不能只看“恢复成功”。
更新前备份
系统设置 → 系统更新 可以分别启用 MSM 本体更新前备份和组件更新前备份。系统生成的记录会标记为对应的更新前类型，便于失败时定位恢复点。
建议在以下操作前同时创建一份手动备份并下载到其他设备：
- MSM 大版本更新
- MosDNS 配置迁移
- Clash / Sing-Box 核心切换或升级
- 恢复另一台主机的配置
- 修改 HTTPS、管理端口、网络与账号
恢复后的检查清单
- [ ] 能使用预期管理员账号登录
- [ ] 管理端口、HTTPS 和时区正确
- [ ] MosDNS 与活动代理核心状态正常
- [ ] FakeIP、主路由静态路由和透明代理仍一致
- [ ] 订阅、策略组与 DNS 规则可用
- [ ] 域名、Cloudflare、私网和 Docker 节点按需重连
- [ ] 系统诊断没有新增端口、权限或依赖错误