更新升级

系统设置 → 系统更新统一管理 MSM 本体、MosDNS、Clash 和 Sing-Box 更新。页面会显示当前版本、最新版本、检查时间、更新进度与错误，并提供稳定版 / 测试版发布记录。

系统更新：MSM 更新设置、更新前备份、组件版本和版本历史

组件卡片面向用户显示 Clash；部分较旧的说明文字可能仍显示内核技术标识。

检查和执行更新只对管理员开放。更新会影响 DNS 或代理连接，先选择网络使用较少的时间窗口。

更新前准备

到备份恢复创建手动备份并下载到其他设备
在更新页启用 MSM 更新前自动备份 和 组件更新前自动备份
记录当前 MSM、MosDNS、Clash / Sing-Box 版本与活动代理方案
确认磁盘空间、外网下载和系统时间正常
保留终端或宿主机访问方式，避免 Web 重启期间失去唯一恢复入口

更新前自动备份默认最多保留 5 份，超过后删除最旧记录。它是快速回滚点，不替代离机备份。

更新 MSM 本体

MSM 卡片提供以下流程：

点击 检查更新
阅读目标版本与更新说明
有更新时点击下载；下载中可取消
下载完成后点击 安装并重启
等待服务重新上线并重新登录
检查当前版本、系统诊断和托管服务

更新状态可能依次经历检查、下载、安装、已安装和重启。操作进行中不要重复提交、手工替换二进制或同时重启服务。

安装前 MSM 会校验下载文件哈希，并使用 --version 对候选二进制做可执行性与版本预检。只有候选文件通过检查后才替换当前程序；替换或重启失败时会保留回滚路径，不会把 HTML 错误页、截断文件或错误架构产物直接安装为 MSM。

更新设置

更新通道：稳定版只接收正式版本；测试版接收预发布版本
自动检查：按设定间隔获取版本信息
检查间隔：12 小时、24 小时、3 天、7 天，或 1–168 小时自定义值
自动下载：发现版本后预先下载，不等同于自动安装
更新通知：有新版本时提示用户

从稳定版切到测试版前先阅读 Beta 发布记录；切回稳定版不等于自动降级当前二进制。

更新组件

组件区域只显示当前部署可管理的 MosDNS、Clash 和 Sing-Box。每张卡片支持：

查看当前与最新版本
检查更新、执行更新或强制重装当前版本
查看阶段进度和失败信息
配置自动检查、检查间隔与自动更新
展开更新说明

组件更新通常会经历备份、下载、应用、恢复 / 收尾和重启。不要在阶段进度未结束时切换代理方案或手工启停同一组件。

MosDNS 升级方式

模式	行为	适用场景
增量升级（默认）	更新组件；仅当 MSM 中存在已保存的 MosDNS 关键设置时，升级后才自动回写这些设置	日常升级
全量升级	使用新模板重建 MosDNS 配置，仅保留运行数据库；不会回写 MSM 已保存的自定义设置，并会清理已有存储	需要跟随新模板重建
重置升级	放弃现有改动，完整使用新模板	配置已经损坏且明确接受重置

增量模式并不保证保存所有手工编辑内容。使用原始配置或大量自定义规则时，先下载备份并查看版本说明。

Clash 升级方式

模式	行为	适用场景
不升级配置	只替换当前方案匹配的 Clash 内核，保持 `config.yaml` 不变	有大量自定义规则、分组或 DNS 配置
全量升级	使用最新模板刷新配置，同时保留用户自有订阅、自定义节点和关键运行端口	基本沿用 MSM 默认模板

Clash Meta（稳定版 / Alpha）和 Clash Smart 属于不同核心选择。组件更新只应使用与当前方案匹配的家族；跨方案变更必须从 代理服务 → 概览 执行安全切换，不能靠更新页面或手工替换二进制完成。

Sing-Box 更新

MSM 使用 reF1nd Sing-Box 核心。Sing-Box 采用固定哈希校验的完整核心替换，没有模板升级模式选择。不要用 SagerNet 官方二进制覆盖当前核心，否则控制接口和配置能力可能不匹配。

Docker 部署

如果 MSM 由镜像部署，Web 页面会拒绝 MSM 本体二进制自更新，并提示修改镜像版本后重建容器。这是为了避免只改容器可写层、下次重建又回到旧版本。使用原 Compose 文件：

bash

docker compose pull
docker compose up -d
docker compose logs --tail=100 msm

命令中的服务名以你的 Compose 文件为准。重建前确认 MSM 数据、配置、组件目录和备份目录都挂载在持久化卷中。组件数据已正确持久化时，可以继续在 Web 页面管理 MosDNS、Clash 和 Sing-Box 更新。

Web 更新不可用时

使用最初安装 MSM 的同一种官方安装方式重新运行升级流程
从项目发布页选择与操作系统、架构和代理核心家族匹配的产物
校验下载来源与校验信息
停止服务前创建完整备份并记录当前二进制位置
不照搬文档中的历史版本文件名；发布资产命名会变化

不要从 MSM Wiki 仓库的 Release 猜测主程序产物，也不要把网上第三方构建直接覆盖到生产实例。

更新后验证

刷新 系统更新，确认 MSM 与组件版本
打开进程管理，确认 MosDNS 和活动代理核心状态
运行系统诊断，检查依赖、端口、磁盘和权限
在 DNS 日志确认查询进入 MosDNS
在代理节点、连接和日志中验证真实流量
测试 A / AAAA、FakeIP 和主路由静态路由
按需检查域名发布、Cloudflare、私网和 Docker 节点

更新失败

先记录页面显示的失败阶段和错误，不要连续重复更新：

检查磁盘、网络、架构和目标版本
查看 MSM 与对应组件日志
若处于恢复阶段，等待任务结束后再操作
使用更新前备份做选择性恢复
仍无法恢复时，按原部署方式重新安装同版本，再导入已验证备份

更新升级 ​

更新前准备 ​

更新 MSM 本体 ​

更新设置 ​

更新组件 ​

MosDNS 升级方式 ​

Clash 升级方式 ​

Sing-Box 更新 ​

Docker 部署 ​

Web 更新不可用时 ​

更新后验证 ​

更新失败 ​

下一步 ​