MSM Wiki

主题

📦 版本更新 ​

🚀 最新稳定版本 ​

稳定版 v2.1.7

下载此版本 安装指南
更新23 项
亮点5 条
源码提交日期2026-10-27 17:37:03 CST

🎉 本次亮点 ​

  1. 网页卸载先预览、再确认：新增当前实例的完全卸载流程，管理员确认清理范围后执行，并可查看完成、失败或状态未知的结果。

  2. 重置后减少旧状态回流：扩展服务端清理范围，同步浏览器标签页与图标库缓存，减少重新初始化后旧记录、旧设置再次出现的情况。

  3. DDNS 更适合双出口环境：默认采用国内 HTTPS 检测源，IPv4、IPv6 可分别绑定出口接口；检测结果冲突时阻止对应地址族更新。

  4. Clash 升级保留现有设置：调整配置升级合并方式，补齐模板默认项并保留已有配置，改善回家访问与自定义设置在升级时被覆盖的问题。

  5. WireGuard 安装与排障更清楚：补充运行依赖检查、APT 安装恢复处理及 UDP 端口映射提示，帮助定位“服务已运行但外网仍无法连接”的原因。

📋 完整更新 ​

🆕 新增功能 ​

  • 网页完全卸载：管理员可在设置中预览当前实例的清理范围，经密码、确认短语及最新预览指纹确认后执行。流程停止托管服务、清理 MSM 管理的网络设置并恢复系统 DNS，独立结果页显示完成、失败或状态未知。
  • 命令行完全卸载入口：新增 msm service uninstall --purge，用于执行完整清理流程。网页卸载对容器、包管理器托管及无法安全识别的安装返回不支持提示，不直接删除文件。

✨ 功能增强 ​

  • DDNS 检测源与出口分别配置：默认改用国内 HTTPS 检测源，增加全球检测源选项；任务编辑和网关向导可分别设置 IPv4、IPv6 出口接口，配置同步纳入备份。探测连接不再跨任务或地址族复用，接口不可用或绑定失败时停止对应地址族更新。
  • WireGuard 显示端口映射指引：连接设置和服务卡片展示当前监听端口，并提供路由器、Docker 与直连环境的配置提示；提醒通过外部网络的真实握手确认可达性，DDNS 本身不能绕过运营商级 NAT。
  • 系统重置默认删除组件程序：重置的默认选项改为删除组件二进制；取消勾选后，按保留规则留下组件程序。保留程序并不代表保留原配置或业务数据。
  • 中英文提示校正：修正网关回程、Clash、MosDNS、桌面服务管理等界面的中英文混杂、错误翻译和部分失败提示，让配置含义与操作结果更易理解。

🐛 问题修复 ​

  • MosDNS 客户端重复创建处理：创建操作增加串行处理；已有匹配记录或遇到唯一约束冲突时更新对应记录，前端同时阻止重复提交，减少重复点击或并发创建导致的失败。
  • 客户端地址校验与报错更准确：修正 IPv6 输入判断，补充服务端 IP、MAC 规范化及有效性校验；无效字段返回可识别的错误信息，创建失败时不再直接向用户暴露数据库内部错误。
  • DDNS 不再忽略较晚返回的冲突结果：取消取得早期多数结果后立即结束检测的行为，等待有超时限制的探测完成；成功结果冲突时阻止对应地址族更新，检测源不可用时不自动回退到国外来源。
  • Clash 配置升级保留自定义内容：配置升级改用 YAML 结构化合并，调整默认项补齐、现有设置保留及 Smart 策略组兼容处理，改善回家访问和自定义配置被模板覆盖的问题。
  • 重置清理补齐持久化记录：将图标来源、图标资源、策略同步记录，以及 Docker 任务和事件纳入清理范围，减少重新初始化后仍残留上一轮安装记录的情况。
  • 重置后隔离浏览器旧状态：通过重置代次同步本地存储和图标库缓存，并通知其他标签页刷新；图标库读写增加代次判断，减少旧页面恢复或写回已失效数据。
  • 重置同步清理运行中的配置：重新初始化应用配置与 GitHub 下载凭据存储，将更新渠道恢复为稳定版，并清理相关就绪状态，避免复用中的服务继续沿用上一轮安装状态。
  • 登录令牌使用当前运行配置：令牌生成、刷新、签名与解析改为读取当前配置；Cookie 时长及登录、刷新响应统一读取当前有效期，减少配置重置后仍沿用旧值或有效期不一致的情况。
  • WireGuard 工具缺失不再误阻塞清理：已保存的配置仍在、但相关工具已移除时，若可确认内核接口不存在，则按已停止处理，避免因此阻塞系统重置或清理。
  • WireGuard 依赖检查补齐实际要求：Linux 增加 readlink、stat、sort 的检测与能力探测，并完善 wireguard-go、coreutils 等软件包映射，减少依赖检查遗漏造成的后续运行失败。
  • WireGuard 安装可处理 APT 索引异常：依赖安装遇到特定索引缺失、安装候选不可用或下载失效错误时，尝试刷新索引后重试；无法识别发行版软件源时，提示手动刷新原生包索引后再试。
  • WireGuard 转发设置按需写入：IP 转发已经开启时不再重复写入系统参数；需要开启但写入失败时中止相关操作，避免在转发条件未满足时继续配置。
  • 旧版 systemd 的服务进程识别：主进程查询不再依赖较新 systemd 才支持的 --value 参数，改为解析带属性名的结果，改善旧系统上的服务控制兼容性。
  • 反激活不再静默跳过解绑确认：授权客户端未就绪时明确报错，不再直接视为可继续完成；本地手动反激活清理同时使授权证明令牌失效，避免残留旧证明状态。
  • FakeIP 默认提示保持一致：设置页与 Clash 编辑器统一引用默认地址段，修正旧占位提示；MosDNS 缓存策略说明同步标注当前及旧安装可能使用的 IPv6 FakeIP 段，此项不代表要求迁移现有地址段。

🛡️ 安全加固 ​

  • 破坏性操作确认重新核验账户：管理员密码核验同时检查当前角色、账户启用和锁定状态，避免仅凭登录时的身份信息确认操作。
  • 卸载与重置期间限制并发干扰：卸载待执行期间阻止新的初始化变更，前端切换至独立卸载页面并暂停普通轮询与设置持久化；运行缓存清理拒绝符号链接目录，仅处理符合命名规则的资源，收紧误删边界。

📌 升级提醒 ​

  • macOS 桌面卸载改为完全清理：桌面端的服务卸载现调用 --purge，不再仅移除系统服务注册。完全卸载不可撤销，需要保留的备份应提前移到配置目录之外。
  • 容器安装仍需宿主机清理：网页不会代删 Docker 容器、MSM 专用卷、绑定目录或启动编排；不支持网页卸载的安装应按界面提示在宿主机处理。
  • 双 WAN 需要匹配上级路由：DDNS 绑定本机 LAN 接口不能替上级路由器选择 WAN。应让检测域名或 MSM 流量经过回家访问所用出口，并按实际网络分别配置 IPv4、IPv6 接口。
📋 构建信息
  • 发布通道：stable（稳定版）
  • 源提交： fb9b5b3
  • 提交信息：合并 MSM 2.1.7 至 main / Merge MSM 2.1.7 into main
  • 提交作者：msm
  • 提交时间：2026-10-27 17:37:03 CST
  • 下载说明：同一发布页内提供各平台二进制、安装包、派网 APX 与 SHA256 校验清单

📚 历史版本 ​

下面仅列出最近几个版本的主要变更，完整变更记录以 GitHub Release 为准。

2.1.6 · 2026-10-25 11:57 · 稳定版
查看 GitHub Release

🎉 本次亮点

  • 跨服务配置同步可确认：MosDNS 与 Clash、Sing-Box 的 IPv6 和受管理域名名单变更可生成同步提议，接受前校验来源版本与有效期；用户可选择同步或保持两侧独立。
  • DNS 不再返回伪 IPv6：识别上游返回的 2001::1 占位 AAAA 结果，先丢弃并尝试其他解析链路，仍为占位地址时拒绝返回，减少错误 IPv6 进入连接流程。
  • 代理核心操作更可控：Clash 与 Sing-Box 的配置变更、控制器请求、重启和就绪检查按核心协调；并发达到限制或核心仍在预热时会明确拒绝操作。
  • 客户端目录聚合多地址：同一 MAC 当前关联的 IPv4、IPv6 会聚合为一个设备条目，名单匹配、移除和编辑可覆盖该设备的活动地址。
  • 运行时配置更能保留用户修改：Clash 活动配置中的可管理字段会同步回设置数据，启动恢复和自动协调不再仅凭旧设置覆盖现有地址池或提供商内容。
  • Sing-Box 安装增加版本一致性校验：除下载摘要外，还会核对归档内二进制版本与发布元数据；版本不匹配或缺少目标二进制时不会继续安装。

🎉 重磅功能

  • 用户确认式跨服务策略同步：新增同步提议的持久化、查询、接受和拒绝流程。MosDNS 名单及 IPv6 设置、代理侧受管理域名规则等变更可携带提议摘要；提议默认 10 分钟过期，接受时会检查仍待处理且来源版本未变化，降低旧配置覆盖新修改的风险。
  • 网络客户端策略自动绑定：网络库存按 MAC 关联当前 IPv4/IPv6 地址，MosDNS 客户端策略可将设备策略扩展到这些地址；地址轮换时更新派生绑定，同时保留用户明确配置的地址和 CIDR 条目。
  • 跨平台邻居信息纳入客户端目录：Linux 读取内核邻居缓存，支持的非 Linux 路径使用系统 ARP/NDP 回退信息；目录按当前扫描结果聚合设备，并过滤回环、组播、链路本地等不适合作为客户端标识的地址。

🆕 新增功能

  • 同步提议 API：提供 /api/v1/policy-sync/offers 相关查询、查看、接受和拒绝能力；服务端会校验提议状态、有效期及来源版本。
  • MosDNS 规则同步提示：白名单、灰名单、黑名单及相关名单写入操作可返回 sync_offer；同步写入可携带 suppress_sync:true，避免双向同步形成回环。
  • 代理域名规则同步：代理编辑器识别 DIRECT、代理和 REJECT/REJECT-DROP 等受管理域名规则，仅在受管理名单实际变化时生成提议，不将不支持的规则类型纳入同步。
  • 客户端多地址展示：MosDNS 客户端卡片和只读列表支持展示同一设备的多个活动地址，名单操作也会按这些地址进行匹配和移除。
  • 代理 Fake-IP 缓存清理：切换 Clash 或 Sing-Box 核心时，可根据当前活动配置请求对应核心清理 Fake-IP 缓存，减少切换后继续使用旧映射的情况。
  • Clash 活动配置变更同步：配置更新、切换、回滚、恢复等路径会通知应用层，使活动配置中的可管理字段能够回写设置数据。

✨ 功能增强

  • 重载与重启状态明确区分：配置应用接口会返回实际发生的是热加载还是重启，并补充相应状态字段；需要重启的操作会等待核心进入可用状态后再返回。
  • 代理控制器增加并发边界：Clash、Sing-Box 的控制器变更请求和延迟测试分别设置并发限制；达到上限时返回忙碌或请求过多，避免请求无序叠加。
  • 按核心协调部署操作：配置、版本、控制器、家庭访问及服务生命周期操作按 Clash 或 Sing-Box 分别加锁，降低核心切换、配置写入和状态检查之间的竞态。
  • 未就绪核心仍可停止：核心处于启动未完成状态时允许执行停止，并清除对应的就绪等待状态。
  • 提供商数据展示更稳健：前端过滤启动期间返回的不完整或格式错误的提供商节点；刷新失败但已有数据时保留现有列表，避免短暂异常清空页面。
  • Sing-Box 远程下载使用显式 HTTP 客户端：订阅、远程规则集和外部 UI 下载改用配置中的“全球直连”传输设置；旧配置中的 download_detour、User-Agent 及规则集传输字段会按新版结构兼容处理。
  • 网络接口选择规则分离：设置中的代理出口接口不再直接复用 Fake-IP 专用过滤规则，保留符合条件的隧道、macvlan 等接口，同时排除容器桥接和实际 veth 接口；默认选择优先考虑已启用且运行中的接口。
  • 失效网卡配置可尝试恢复：当保存的网卡已不存在时，设置更新会尝试从当前可用接口中恢复，并在失败补偿路径使用恢复后的接口。
  • 核心切换时协调缓存清理：切换代理核心前按运行状态处理 MosDNS 缓存，并尝试清理当前核心的 Fake-IP 缓存。
  • Fake-IP 缓存窗口调整为 60 秒：生成配置向客户端返回的 Fake-IP TTL，以及过期后的 stale 保留窗口均调整为 60 秒；核心切换或映射重建后，旧映射的复用时间更短。
  • MosDNS 配置状态同步更完整：配置文件上传、在线分流源、路由规则、配置切换、启动和回退等操作增加对应的数据库备份或同步处理；客户端名单区分基础地址与运行时派生地址。
  • MosDNS 运行时 API 增加等待上限：API 请求使用并发槽位，等待超过限制时返回“请求过多，请稍后重试”，避免请求持续堆积。
  • 网络扫描状态更新串行化：扫描与库存更新增加互斥控制，并按扫描批次维护地址状态，降低并发扫描相互覆盖结果的可能。
  • 设备厂商识别增加内置回退：Linux 和 Darwin 在系统厂商查询不可用时使用共享的内置厂商数据作为回退。
  • Clash 提供商节点解析更稳健：统一处理运行时返回的提供商节点数据，过滤缺少有效名称或格式不正确的条目，避免切换期间异常数据影响页面操作。

⚡ 性能优化

  • 策略同步优先读取邻居缓存：后台策略同步可直接读取已有 ARP/NDP 邻居信息，而不是每次都执行完整网段探测；完整扫描仍用于需要更丰富设备信息的场景。
  • 延迟探测避免无限并发：Clash 与 Sing-Box 的代理延迟测试使用独立并发槽位，超出容量时快速反馈，而不是继续叠加控制器请求。
  • MosDNS 请求采用有限并发：运行时 API 使用固定并发容量和最长等待时间，使高并发场景更早返回可处理的错误。

🐛 问题修复

  • 拒绝 2001::1 AAAA 占位地址：修复 MosDNS 将该地址当作有效 IPv6 返回、参与后续 IPv6 判断或写入无 IPv6 记忆池的问题；普通解析和刷新解析模板均加入相应保护。
  • 无 IPv6 状态仅处理 NXDOMAIN：相关 DNS 策略不再因其他响应类型而错误加入无 IPv6 记录。
  • 修复活动配置被旧设置覆盖：启动恢复、升级准备和 MosDNS 地址协调会保留现有配置中的地址池及运行时编辑内容；用户显式修改设置时仍可替换相应地址范围。
  • 修复客户端自定义字段更新范围：更新设备名称或描述时按归一化 MAC 匹配同一设备的多条地址记录，避免 IPv4/IPv6 变化后部分记录未更新。
  • 修复目录显示历史地址：客户端目录使用当前扫描结果和最新扫描窗口，避免旧扫描批次中的地址重新出现在当前设备列表。
  • 修复 IPv6 地址轮换后的策略残留：同一 MAC 的 IPv6 地址变化时，更新派生策略绑定，避免持续保留已失效的历史 IPv6。
  • 修复代理控制器操作竞态：配置切换、控制器写入、核心重启和就绪检查使用统一协调，减少读取旧活动配置后再应用变更的情况。
  • 修复服务启停未走核心服务路径：Clash 与 Sing-Box 的启动、停止和重启改为通过各自核心服务执行，使服务操作与核心状态处理保持一致。
  • 修复 MosDNS 运行文件与持久化状态不同步：配置变更、上传、切换、回退及规则操作补充相应的备份或同步路径，降低运行配置与数据库记录不一致的情况。
  • 修复部分平台 ARP/NDP 合并丢失地址：回退扫描按 IP 合并邻居记录，并保留同一 MAC 对应的多个地址。
  • 修复受管二进制路径识别边界：MosDNS 版本路径解析会校验符号链接解析结果是否仍位于受管安装目录内，目录外路径不会被当作有效版本。
  • 修复 Sing-Box 提供商切换期间页面异常：运行时返回不完整数据时不再直接触发节点处理异常，已有有效数据也不会因一次刷新失败而被清空。

🛡️ 安全加固

  • 校验 Sing-Box 归档内版本：安装时读取归档中的二进制版本，并与同一发布元数据提供的期望版本比较；缺少二进制或版本不匹配时拒绝继续安装。
  • 限制 Fake-IP 清理的控制器地址：清理 Clash 或 Sing-Box Fake-IP 缓存时校验控制器地址为受支持的本地地址，并使用活动配置中的控制器和认证信息。
  • 同步提议接受前校验来源状态：提议过期、已处理或来源配置发生变化时拒绝接受，避免基于旧提议应用配置。
  • 代理控制器写操作增加忙碌保护：并发写入达到限制或核心处于未就绪状态时拒绝本次操作，降低多个配置变更同时执行造成状态错乱的风险。

⚠️ 兼容性变更

  • 名单写入接口增加可选字段：MosDNS 名单写入接口支持 suppress_sync；不需要触发跨服务同步提示的内部写入方可携带该字段。
  • 写入接口可能返回同步提议：规则和名单写入接口除原有成功结果外，可能在 data.sync_offer 中返回提议；不使用同步能力的客户端可忽略该字段。
  • 代理配置响应区分重载与重启：相关接口增加 reloaded 等状态字段，调用方不应只依据旧的 restarted 字段判断实际生效方式。
  • 自动协调不再隐式迁移旧 Fake-IP IPv6 地址池：启动恢复和自动模板协调会保留现有地址池；需要更换地址池时，应通过设置中的显式地址配置完成。
  • Sing-Box 旧下载字段会被转换：旧版 download_detour 等字段会在兼容处理时转换为 http_client.detour，新生成和保存的配置采用新版结构。

📌 升级提醒

  • 检查自定义 API 客户端的响应解析：如果客户端严格校验规则、名单或代理配置接口的响应结构，需要允许 sync_offer、reloaded 等新增字段。
  • 同步提议需在有效期内确认：提议默认有效 10 分钟；来源配置发生变化后，原提议不能继续接受。
  • 关注 Sing-Box 安装校验结果：下载内容需同时满足摘要校验和归档内版本匹配，否则安装流程会拒绝激活该归档。
2.1.5 · 2026-10-25 03:11 · 稳定版
查看 GitHub Release

🎉 本次亮点

  • MosDNS 与代理配置可选同步：修改 IPv6 设置或可映射的域名名单后生成同步提议，用户可确认同步到目标服务，也可只保留当前服务的修改。
  • 核心切换减少旧缓存干扰：切换 Clash 或 Sing-Box 前处理仍可访问的旧核心缓存，并将 Fake-IP 的客户端 TTL 与陈旧复用窗口调整为 60 秒。
  • 核心操作增加并发与就绪边界：控制器请求、代理测速和 MosDNS API 都有并发上限与等待窗口；核心尚未完成启动检查时，相关变更会返回明确状态。
  • Sing-Box 安装核对归档内版本：在摘要校验之外，安装前检查归档内实际二进制版本是否符合发布元数据，版本不一致时拒绝继续安装。
  • 客户端目录按设备聚合地址：同一 MAC 的当前 IPv4/IPv6 地址合并展示，并过滤历史扫描地址及不适合作为客户端目标的特殊地址。

🎉 重磅功能

  • 可确认、可追踪的跨服务同步提议：新增持久化提议及查看、接受、拒绝接口，记录来源、目标、范围、载荷、版本和处理状态；提议默认 10 分钟过期，接受时检查待处理状态和来源版本。
  • 代理域名规则衔接 MosDNS 名单：Clash 或 Sing-Box 编辑器可将可表达为 DIRECT、REJECT 或代理策略的域名规则整理为 MosDNS 同步提议；IP、进程、端口、规则集以及不支持的正则和通配符规则不会被静默转换。

🆕 新增功能

  • 同步提议接口与权限边界：新增 /api/v1/policy-sync/offers，支持创建、查询、接受和拒绝；查看提议需要 viewer 角色，创建、接受和拒绝需要 operator 角色。
  • 同步确认交互：MosDNS 规则、block_ipv6 开关以及代理配置中的相关 IPv6 或域名名单变化可触发确认交互；同步写入支持 suppress_sync，避免双向同步形成回环。
  • 多地址客户端信息：客户端响应增加同一设备的地址集合，目录卡片和只读列表可同时显示当前活动的 IPv4 与 IPv6 地址。
  • Linux OUI 解析回退：系统缺少可用的 systemd-hwdb 厂商数据时，网络扫描改用内置只读 OUI 数据表；Darwin 与 Linux 共用该解析数据格式。
  • 核心 Fake-IP 清理能力：核心切换流程可从本地 Clash 或 Sing-Box 控制器读取配置并调用 Fake-IP 清理接口，控制器地址需满足本地回环 HTTP/HTTPS 限制。

✨ 功能增强

  • 核心重启增加就绪门控：Clash、Sing-Box 重启后若控制器或数据面仍在预热，会记录待就绪状态并阻止新的配置、控制器及相关变更；就绪探测成功或核心明确停止后清除该状态，停止操作仍可执行。
  • 通用服务入口复用核心生命周期：通用启动、停止和重启接口改为调用 Clash、Sing-Box 对应的服务对象，与专用入口共享生命周期控制，减少不同入口同时管理同一核心的情况。
  • 涉及重启的操作统一等待就绪结果：配置编辑、版本或配置切换、规则、代理组、Provider、家庭访问等操作，以及失败后的回滚，均通过统一的重启后就绪流程处理。
  • Sing-Box 外部请求使用托管直连选择器：控制器 UI、订阅 Provider 和远程规则集的请求改用 http_client.detour，指向配置中的“全球直连”选择器。
  • Sing-Box 兼容迁移范围扩大：旧配置中仅有 User-Agent、缺少 detour 的写法也会迁移到 http_client；1.14 及以上配置会为外部 UI、Provider 和远程规则集补齐相应 HTTP 客户端设置。
  • 客户端备注按设备关联：通过 MAC 地址识别客户端时，修改名称或描述会同步到同一设备的多个地址记录；策略 IP 扩展会排除不可用的特殊地址。
  • 客户端目录优先使用当前扫描窗口：目录按当前扫描数据聚合设备；缺少扫描批次信息的旧数据库改用最近扫描时间窗口筛选，减少历史 DHCP 或 IPv6 地址重新进入活动目录的情况。
  • Fake-IP 缓存窗口调整：MosDNS 模板中的 Fake-IP 客户端 TTL、陈旧结果窗口及高变化域名的陈旧窗口调整为 60 秒，以缩短核心切换或映射重建后的旧映射复用时间。
  • 节点探测等待与地址池判断调整：探测缓存写入后的调度等待从 1 秒调整为 10 毫秒；节点无 IPv4/IPv6 地址池仅在明确收到 NXDOMAIN（rcode 3）时更新，不再把 NOERROR 空响应作为同类依据。

⚡ 性能优化

  • 控制器请求限流：Clash 和 Sing-Box 控制器请求并发上限为 16，等待超过 750 毫秒、请求被取消或无法取得执行位置时返回忙碌状态。
  • 代理测速限流：单个核心的测速请求并发上限为 4，超过 750 毫秒仍无法取得执行位置时返回 PROXY_DELAY_BUSY。
  • MosDNS API 限流：MosDNS 运行时 API 并发上限为 16，超过 750 毫秒等待窗口后返回请求过多错误。
  • 控制器轮询统一受控：控制器查询、代理选择以及流量和内存快照等请求纳入并发控制，突发请求会在限定窗口内排队，无法排队时明确失败。

🐛 问题修复

  • 修复核心切换后的旧缓存影响：核心切换时先处理仍在运行的旧核心对应缓存，再停止旧核心并应用新核心；旧核心控制器不可访问时跳过原生 Fake-IP 清理并继续切换。
  • 修复策略邻居重新带回历史地址：策略邻居刷新仅保留当前快照观察到的设备地址，避免没有当前观察记录的旧地址重新参与策略绑定。
  • 修复特殊地址进入客户端目录：目录和策略处理会过滤未指定、回环、组播、链路本地及 IPv4 广播地址。
  • 修复同一设备多地址备注不一致：通过一个地址编辑客户端信息时，会同步更新同一 MAC 对应的其他地址记录。
  • 修复核心启动预热期间的重复操作：核心尚未完成控制器和数据面就绪检查时，配置变更和控制器操作不会立即再次触发同一核心。
  • 修复 Linux 厂商解析缺少系统数据时的空结果：systemd-hwdb 无法提供厂商信息时，改用内置 OUI 表继续解析。
  • 修复 Sing-Box 归档内部版本不一致：即使归档摘要匹配，内部 sing-box 二进制版本与发布元数据不一致时也会拒绝安装，并清理临时下载文件。

🛡️ 安全加固

  • 限制 Fake-IP 清理请求目标：清理接口仅允许访问绑定在回环地址上的 HTTP/HTTPS 控制器，不接受外部主机、Unix socket、额外路径、查询参数或片段。
  • 校验 Sing-Box 归档内实际版本：安装流程从归档中提取 sing-box 二进制并检查版本输出，要求实际版本与同一发布元数据中的期望版本一致。
  • 同步提议增加状态与来源版本校验：接受或拒绝前检查提议仍为待处理、未过期且来源版本未变化；条件不满足时不会转换提议状态。
  • 限制可同步的规则范围：代理侧同步只处理可表达为 MosDNS 名单的域名规则；IP、进程、端口、规则集及无法映射的规则不会被静默转换。

⚠️ 兼容性变更

  • 写接口响应可能增加同步提议字段：MosDNS 规则和相关开关写入成功时，响应可能包含 data.sync_offer；原有成功结果仍单独返回。
  • 控制器繁忙时返回明确错误：控制器请求过多时可能返回 HTTP 429 和 PROXY_CONTROLLER_BUSY；测速请求过多时返回 PROXY_DELAY_BUSY，调用方需稍后重试。
  • 核心未就绪时返回冲突状态：核心正在等待控制器或数据面就绪时，相关变更可能返回 HTTP 409 和 PROXY_START_PENDING；停止操作不受该门控阻止。
  • Sing-Box 旧配置可能被重写：写入或迁移配置时，旧的 download_detour、外部 UI 下载设置和 User-Agent 写法可能转换为 http_client 结构。
  • Fake-IP 默认 TTL 发生变化：依赖模板默认值的客户端收到的 Fake-IP TTL 由 600 秒调整为 60 秒，MosDNS 对旧映射的陈旧复用窗口也调整为 60 秒。

📌 升级提醒

  • 同步提议需要用户确认：本地修改会先保存；用户可选择同步或仅保留本地修改。接受提议表示确认同步选择，目标服务仍需使用提议载荷执行对应写入。
  • 来源发生变化时需重新生成提议：同步提议创建后，如果来源配置或规则发生变化，接受操作会因版本不匹配被拒绝。
  • 核心切换清理存在执行条件：只有旧核心处于运行状态且其本地控制器可访问时，才会执行原生 Fake-IP 清理；控制器不可访问时会跳过该步骤并继续切换。
  • 版本信息更新为 2.1.5：后端、Web 界面和桌面端显示的版本号同步更新。
2.1.3 · 2026-10-24 18:31 · 稳定版
查看 GitHub Release

📌 升级提醒

  • 两个发布版本之间存在净变化，但发布线提交说明不足以可靠归纳；请核对完整版本差异，未将重新合并的旧分支功能视为本次新增
  • 规则摘要未采用可能重放历史的合并提交说明；这部分变化需要结合两个发布版本的净差异核对
2.1.1 · 2026-10-22 16:41 · 稳定版
查看 GitHub Release

🎉 本次亮点

  • harden updates and add persistent tasks and multi-file stacks / 完善安全升级、持久任务与多文件应用栈
  • 升级 Go 至 1.27.3 修复中间证书信任漏洞 / Upgrade Go to 1.27.3 for CVE-2026-111943
  • 统一受管子进程的直接执行与身份校验 / Run managed children directly with verified arguments
  • migrate cache WAL sync defaults / 升级主缓存 WAL 同步默认值
  • 统一全局网络设置与失败恢复 / synchronize global network settings and recovery
  • 新增组件卸载能力

🆕 新增功能

  • harden updates and add persistent tasks and multi-file stacks / 完善安全升级、持久任务与多文件应用栈
  • 新增组件卸载能力
  • complete compose lifecycle planning and task integration / 完善 Compose 生命周期预检与任务化管理
  • 新增托管组件下载能力

✨ 功能增强

  • 统一受管子进程的直接执行与身份校验 / Run managed children directly with verified arguments
  • 修正未安装组件安装操作文案
  • 完善 FakeIP 接口校验与 UniFi 诊断 / Complete FakeIP interface validation and UniFi diagnostics
  • test: 隔离 CI 权限与 SQLite 连接环境 / Isolate CI permissions and SQLite connection fixtures
  • 完善 macOS WireGuard 后端校验 / Validate macOS WireGuard backend installs
  • test: 隔离 WireGuard 权限用例的命令路径 / Isolate command lookup in WireGuard privilege tests
  • unify pure-Go driver and builds / 统一纯 Go 数据库驱动与构建
  • 移除组件独立下载功能
  • 完善网络组件卸载流程 / Complete networking component uninstall flow
  • 收紧组件下载大小限制并完善文档 / Harden component download limits and docs
  • 清理前端文件末尾空白 / Clean frontend trailing whitespace
  • 修正默认 IPv6 FakeIP 并完善 UniFi 文档 / Use compliant default IPv6 FakeIP and update UniFi docs
  • 将 dev 2.0.7 合并到 main / Merge dev 2.0.7 into main
  • 版本升级至 2.0.7
  • prepare 2.0.6 and sync API version metadata / 准备 2.0.6 发布并同步 API 版本元数据
  • test: stabilize regression checks and align browser flows / 稳定回归检查并更新浏览器测试流程
  • update Go indirect dependencies / 补齐 Go 间接依赖升级
  • upgrade dependencies and verify local services / 升级依赖并验证本地开发服务
  • 升级 Go、前端与 Tauri 第三方依赖 / Upgrade Go, frontend, and Tauri dependencies
  • 完善 Docker Center 对照设计与开发验收 / document Docker Center design and validation
  • 实现 macOS 桌面应用与服务联动更新 / Implement macOS desktop and service updates
  • 修正前端回归测试预期 / Align frontend regression test expectations
  • 补充 Setup Fake-IP 初始化回归测试
  • test(backend): 在完成通知前释放部署锁 / signal completion after releasing the deployment lock
  • test(frontend): 隔离图标页面初始化 / isolate icon page hydration fixtures
  • 同步前端、Tauri、后端嵌入版本和 OpenAPI 文档版本

⚡ 性能优化

  • migrate cache WAL sync defaults / 升级主缓存 WAL 同步默认值
  • align audit byte-budget batching default / 同步审计按字节预算合批默认值
  • migrate write defaults and track refresh stages / 升级写入默认值并跟踪刷新阶段
  • align buffered audit defaults / 同步审计缓冲默认配置

🐛 问题修复

  • 统一全局网络设置与失败恢复 / synchronize global network settings and recovery
  • 修复布尔默认值覆盖导致 IPv6 单栈变双栈的问题，启动时修正旧任务地址族开关；修复 Cloudflare、华为云规则编辑的 Zone ID 混用，并防止同步覆盖编辑配置。新增数据库、服务、API、界面与真实网络链路回归验证
  • 修复未安装组件状态显示
  • 修复 macOS Tailscale 托管更新
  • 修复 macvlan 地址回放与桥接网卡筛选
  • 修复 WireGuard 修复进度与无包管理器处理
  • 修复 macOS WireGuard 按需安装依赖 / Install only missing macOS WireGuard packages
  • 修复 macOS WireGuard 依赖修复
  • 修复 Setup Fake-IP 默认值与提交
  • 修复 TUN Fake-IP 失败回滚
  • 修复 EasyTier macOS 架构更新
  • 修复 macvlan 地址解析误过滤 / Preserve real macvlan addresses in resolver
  • 修复无更新时的清单误报
  • 修复多接口 Fake-IP 与静态容器地址
  • 修复桌面启动时自动同步 MSM 服务 / Sync bundled MSM service on desktop startup
  • 修复 beta 服务版本解析与桌面更新超时
  • 修复 FakeIP 重启回放并完善 UniFi 文档 / Replay FakeIP on restart and document UniFi setup
  • 修复备份空间错误本地化 / Localize backup capacity failures
  • 修复 FakeIP/UniFi 网络一致性与诊断
  • 完成无签名 macOS 在线更新链路 / complete unsigned macOS desktop updates
  • 完善内核管理与网络修复并升级至 2.0.8
  • 修复 macOS 更新与服务生命周期 / repair macOS updates and service lifecycle
  • 修复 DNS 状态与服务安装路径
  • 强化 TUN 就绪与 PD 回程 / harden TUN readiness and PD return paths
  • 恢复备份时应用 TUN 兼容修复
  • 修复 TUN 路由冲突与 LAN IPv6 回程
  • 补齐DNS TCP端口映射 / publish TCP ports for DNS fallback
  • 避免启动覆盖自定义上游 / preserve custom DNS upstreams during startup recovery
  • 保留连续升级的自定义分流规则 / preserve custom rules across consecutive upgrades
  • 同步 Apple 资源白名单 / sync Apple asset whitelist for upgrades
  • 兼容旧证书空字段的启动迁移 / Preserve legacy NULL fields during certificate secret migration
  • 修复 Docker 任务空值判断并完善后端静态检查 / Handle missing Docker updates and satisfy backend lint
  • 修复 EasyTier Web 设备身份和配置服务器管理
  • honor IPv6-only rules and restore editing / 修复 IPv6 单栈同步和规则编辑
  • safely reuse wildcard certificates in publish workflows / 修复一键发布泛域名证书复用与校验
  • preserve rule provider indentation / 修复规则集保存的缩进错误
  • sync upstream configuration fixes / 合并上游配置修复
  • discover scheduled rebuilds from idle / 空闲页面自动发现定时重建
  • migrate audit defaults and expose refresh stages / 升级审计默认值并显示刷新阶段
  • declare background DNS sources compatibly / 兼容声明后台 DNS 来源
  • 修复 macOS 全量 Go 测试环境隔离
  • manage external compose lifecycle / 修复外部 Compose 生命周期管理
  • expose task activity and stopped file browsing / 修复 Docker 任务与停止容器文件浏览
  • test(docker): add browser acceptance and fix node lifecycle / 增加浏览器验收并修复节点生命周期
  • 修复桌面更新正式版与测试版查询
  • 预备远程启动缓存并避免登录 Shell / Stage remote bootstrap data and avoid login shell
  • 补全应用更新入口 / Expose desktop update controls
  • 修复桌面更新权限并验证本机升级
  • 修复 root 运行时缓存与 macOS CLI 测试
  • test(frontend): 修复 Node 26 图标测试兼容性
  • 补齐桌面包的开源声明资源 / Include complete third-party notices in desktop bundles
  • 阻止 macOS 下载错误的 Tailscale 架构 / Block incompatible Tailscale downloads on macOS
  • 修复直连迁移误写用户分组 / Preserve case-sensitive direct policy groups

🛡️ 安全加固

  • 升级 Go 至 1.27.3 修复中间证书信任漏洞 / Upgrade Go to 1.27.3 for CVE-2026-111943
  • 修复 Go 中间证书信任漏洞 / Upgrade Go for CVE-2026-111943

📌 升级提醒

  • 从本次 100 个提交中整理；当前使用提交标题与正文要点生成规则摘要，未经过 AI 语义归纳或运行验证
2.0.7 · 2026-10-13 10:04 · 稳定版
查看 GitHub Release

📌 升级提醒

  • 两个发布版本之间存在净变化，但发布线提交说明不足以可靠归纳；请核对完整版本差异，未将重新合并的旧分支功能视为本次新增
  • 规则摘要未采用可能重放历史的合并提交说明；这部分变化需要结合两个发布版本的净差异核对
2.0.4 · 2026-09-26 14:23 · 稳定版
查看 GitHub Release

🎉 本次亮点

  • Agent 镜像独立发布：Docker Agent 镜像迁移至独立仓库 msmbox/msm-agent，安装命令默认拉取 latest 标签，不再强制绑定 MSM 主程序具体版本号，简化节点升级与版本匹配流程。
  • 隧道会话自动刷新：节点重连时引入唯一会话 ID 校验，新连接建立后自动关闭旧的空闲连接，避免 stale 状态导致通信异常，提升长连接稳定性。
  • 安装路径配置简化：Docker 运行示例中的 TLS 证书卷挂载路径统一调整为当前目录的 ./tls，减少手动修改绝对路径时的配置错误。

✨ 功能增强

  • 隧道握手协议增强：建立反向隧道时增加 X-Msm-Agent-Session 请求头，控制端会对会话 ID 进行 UUID 格式校验，无效会话将被拒绝连接。
  • 连接池容量管理：当单个节点的活跃连接数达到上限时，系统会自动驱逐最早的空闲连接以接纳新请求，防止资源耗尽。
  • 文档构建流程更新：正式版与 Beta 版构建推送逻辑移至 wiki 仓库，源码仓库不再直接执行 Docker 镜像发布任务，明确分工边界。

🐛 问题修复

  • 旧连接清理机制：修复了节点会话切换时旧连接可能未被及时关闭的问题，现在检测到新会话 ID 后会立即终止同一节点下的旧连接并释放资源。
  • 测试用例超时调整：延长了端到端测试中拉取镜像和容器启动的等待超时时间，避免因网络波动导致的偶发性测试失败。

⚠️ 兼容性变更

  • 旧镜像标签停止更新：正式 Docker Agent 镜像已移至 msmbox/msm-agent 仓库，旧版 msmbox/msm:agent-* 标签不再更新，手动脚本需调整拉取源。
  • 安装命令参数变化：生成的 Docker run 命令中 TLS 挂载参数由 /path/to/agent-tls 变更为 $PWD/tls，旧版自动化脚本可能需要适配。

📌 升级提醒

  • 镜像仓库迁移：请检查现有的节点部署脚本，将镜像来源从 msmbox/msm:agent-<version> 更新为 msmbox/msm-agent:latest 或指定新版本标签。
  • TLS 目录准备：使用独立安装命令时，需确保 agent.crt 与 agent.key 已放入当前执行目录下的 tls/ 文件夹中。
2.0.3 · 2026-09-25 21:38 · 稳定版
查看 GitHub Release

🎉 本次亮点

  • 代理双核心工作流：原有 Sing-Box 能力并入统一代理工作区，Clash 与 Sing-Box 共用节点、规则、连接和回家管理入口；切换核心时校验配置并等待服务就绪。
  • 公网回家与手机交付：新增多协议回家监听和移动配置交付，Clash、Sing-Box 客户端配置可选择嵌入 WireGuard 回家通道，也可下载独立 WireGuard 配置。
  • 域名服务与私有组网：新增 DDNS、证书、受管反向代理及 Cloudflare Tunnel 工作区，并支持 WireGuard、Tailscale、EasyTier 三种私有组网引擎。
  • Docker 跨设备运维：原有 Docker Center 扩展独立子节点程序、主动回连、更新检查与受控更新队列，容器和 Compose 管理汇入统一工作区。
  • 进程恢复与 OpenWrt：支持有条件启用的 systemd 托管模式，在 MSM 异常退出后保留托管服务并在重启时核验接管；OpenWrt 新增 procd 运行支持。
  • 升级与网络保护：初始化时尊重“自动修改本机 DNS”关闭状态，选定网卡异常持续告警，IPv6 透明代理规则和旧配置迁移得到加强。

🆕 新增功能

  • 私有组网：提供 WireGuard、Tailscale 和 EasyTier 的建网、安装、启停、设备加入、成员状态与连通诊断；Tailscale 可使用官方控制面或 Headscale。
  • 公网回家监听：增加代理协议回家配置、端口与公网入口检测，可按当前代理核心生成相应服务端配置。
  • 手机配置交付：可生成 Clash、Sing-Box reF1nd 与官方 Sing-Box 客户端配置，并下载独立 WireGuard 设备配置。
  • 手机 WireGuard 回家节点：生成 Clash 或 Sing-Box 手机配置时可嵌入 WireGuard 作为可选回家通道；生成失败会清理本次新建的设备成员。
  • DDNS 工作区：新增双栈地址检测、DNS 记录同步和运行状态，供公网入口、证书和组网配置关联使用。
  • HTTPS 证书工作区：新增证书申请、状态与续期管理，并可为反向代理入口选择已签发的受管证书。
  • 受管反向代理：新增域名到内网服务的路由配置、监听入口和运行状态；启用入口时加载网关，停用最后一个入口时释放监听端口。
  • Cloudflare Tunnel：新增 Tunnel 的接入、路由配置与状态管理。
  • Docker 独立子节点：新增独立子节点程序与主动回连方式，使 Docker 资源可通过远程节点管理；原有节点管理能力仍保留。
  • Docker 更新管理：新增镜像更新检查、受控任务队列和更新策略，支持查看执行进度与结果；自动化能力受授权和目标能力约束。
  • 图标库工作区：新增独立图标管理页，支持远程来源、分类、预览与复制，并可调整预览尺寸。
  • 系统诊断：集中检查配置、依赖、监听端口、权限与磁盘状态，按检查结果显示具体问题。
  • 多网卡健康告警：选定网卡缺失、断开、无地址或默认路由不一致时持续提示诊断信息，不自动切换网卡。
  • 自定义节点批量删除：Clash 自定义节点支持多选和确认删除，便于一次清理失效节点。
  • 可选 systemd 进程托管：在具备 systemd 与 cgroup v2 的 Linux 主机上可启用对应托管模式；MSM 异常退出时由该模式托管的服务可继续运行，重启后核验并接管。
  • OpenWrt procd 运行支持：服务安装与启动可使用 procd，并在系统 DNS 交接时保护现有网络规则。
  • 功能模块开关：Pro 工具模块接入系统功能设置，按角色和授权展示可用入口与操作。

✨ 功能增强

  • 统一代理工作区：原有 Sing-Box 从独立基础页面扩展到与 Clash 对齐的概览、节点、规则、连接及配置操作，不把 Sing-Box 写成首次支持。
  • 代理核心切换：切换时保留订阅和已有配置，串行校验、等待就绪并展示任务进度；失败时保护原有可用核心。
  • Clash Smart 核心：增加 Smart 渠道选择、策略组编辑及模型相关配置，并限制不兼容字段混入普通核心配置。
  • 多协议回家交付：服务端监听可按协议分别配置，移动端回家节点支持配置合并、导入链接与可用性检测。
  • 组网高级设置：WireGuard 的 MTU、保活与局域网转发，Tailscale 的路由与出口节点，以及 EasyTier 的连接和高级 TOML 设置得到扩展。
  • Docker 容器与 Compose 工作区：原有 Docker 管理页面重构为统一资源工作区，集中模板部署、YAML 校验、应用栈详情、日志及任务进度。
  • Docker 资源与节点视图：容器、镜像、网络、存储卷、事件和节点信息更完整，区分引擎离线、空资源和采样不可用状态。
  • 域名服务运行反馈：DDNS、证书和反向代理区分已保存、已验证与实际生效状态，连接入口、HTTPS 切换及配置应用进度更清楚。
  • 网络工具工作区：原有 Ping、DNS、测速、路由、端口等工具重组为统一工作台，完善结果、历史记录和窄屏操作。
  • 仪表盘布局与图表：组件布局、字体缩放、实时图表和窄卡片展示得到调整，ARM 设备可显示更具体的 SoC 型号。
  • IPv6 地址展示：公网地址按稳定性排序，临时与已弃用地址有标识，多地址列表可折叠。
  • IPv6 透明代理：增加 Fake-IP 本地路由，按 IPv4/IPv6 开关分别生成 nftables 规则，并清理停用地址族的残留路由。
  • 进程操作与资源指标：命令行和后台协调控制权，异常进程归属不明时标为 UNKNOWN；内存与 CPU 采样区分自身、托管总量及不可用状态。
  • 组件更新渠道：MosDNS、Clash 和 Sing-Box 可批量检查，Clash Smart/Alpha 与 Sing-Box 稳定/测试渠道选择更明确。
  • 系统更新与备份恢复：完善已有更新、备份及恢复界面的执行反馈与异常处理；升级前仍建议主动备份。
  • GitHub 凭据设置：可配置更新检查所用 GitHub Token，管理员可按权限查看已保存的令牌；未配置令牌时仍按公开 API 的限制工作。
  • API 与文档：后端路由契约、gRPC 接口与 OpenAPI 文档同步整理，公开接口和监听地址标注更准确。

⚡ 性能优化

  • 按需运行时加载：可选运行时与接口文档按需加载，减少后台巡检和常驻资源开销。
  • 轮询与连接复用：减少无意义的状态轮询，并复用 HTTP 连接，避免单服务刷新导致全部状态缓存失效。

🐛 问题修复

  • 初始化 DNS 开关：未明确开启时不修改宿主 DNS；关闭后数据库与生成配置保持关闭，网络应用失败也不会悄悄改回开启。
  • MosDNS 启停与查询噪声：IPv6 设置未变化时不重启 MosDNS；就绪检查不发送真实 DNS 查询，延长慢设备上的就绪等待。
  • OpenWrt 网络交接：改进系统 DNS 交接和端口占用预检，避免服务启动、停止时破坏原有网络规则。
  • Sing-Box 升级兼容：迁移旧版订阅占位符；服务已停止且配置文件不存在时允许更新核心，不因缺失配置直接阻止升级。
  • Clash 订阅兼容：清理无效提供器，允许空行内订阅区块保存，并保护核心切换时的现有配置。
  • Docker 网络与镜像时间：恢复 macvlan 创建前参数校验，参数改变即清除旧结果；镜像创建时间正确解析数字时区偏移。
  • 组网安装与状态：修复 WireGuard 局域网转发、Tailscale 浏览器认证时更新回滚和组网状态快照过期问题。
  • 组件下载与 GitHub 检查：遵循系统 DNS 和已配置的组件下载代理，减少不必要的超时与错误回退。
  • 网关与代理运行：改善 HTTPS 切换、配置应用超时、服务就绪和并发核心操作，避免进行中误报为已完成。
  • 升级链路：兼容旧配置时间戳，拒绝下载同版或更旧版本，减少旧服务和新配置切换时的意外覆盖。
  • 页面故障恢复：初始数据加载和资源分块失败时可重试，降低短暂后端故障造成的空白页风险。

🛡️ 安全加固

  • API 令牌归属：令牌绑定实际所属用户，所属用户失效或停用时拒绝认证；失效登录会话及时清理。
  • 远程凭据保护：组网密钥、云端 DNS 凭据与远程节点连接信息限制回显和日志暴露，敏感操作受角色权限约束。
  • 发布与下载校验：组件安装、升级包与网络入口加强校验，避免错误资产、越权操作或不受控的旧版下载。

📌 升级提醒

  • 跨版本升级：从 1.2.6 升至 2.0.3 涉及代理、组网、域名服务和托管方式变化；升级前备份配置，升级后核对服务状态、端口和 DNS 设置，不能保证所有环境自动无损迁移。
  • 环境条件：systemd 托管需要相应 Linux 环境；OpenWrt 使用 procd；WireGuard 和透明代理需要宿主机具备对应内核、网络权限及端口条件。
1.2.6 · 2026-07-27 16:07 · 稳定版
查看 GitHub Release

🎉 本次亮点

  • 修复网络规则刷新时的崩溃：更新 nftables 依赖，修复高文件描述符场景下的越界问题，增强网络规则维护的稳定性。
  • 更新检查失败后有节奏地重试：按组件独立退避，避免网络异常时每分钟重复请求；成功后恢复正常检查节奏。
  • 日志更安静，关键信息仍保留：Clash 预期运行态错误不再附带重复堆栈，意外错误仍保留排障信息。

⚡ 性能优化

  • 精简访问日志堆栈：访问日志保留请求及错误字段，移除重复的中间件调用栈，并复用日志实例，减少无信息量的输出。

🐛 问题修复

  • 修复 nftables 文件描述符越界崩溃：升级依赖以修复文件描述符达到 1024 或更高时，网络规则刷新路径可能触发的数组越界 panic。
  • 修复组件更新检查的重试风暴：检查失败时单独记录退避状态，首次等待 2 分钟，后续逐次翻倍、最长 1 小时；各组件互不影响，成功后清零，避免持续失败后每个调度周期都发起请求。
  • Clash 运行态错误分级记录：核心未启动、重启中、连接失败、404 或超时等预期情况采用 Warn 且不采集堆栈；其他意外错误仍采用 Error 并保留堆栈。

📌 升级提醒

  • 本版聚焦稳定性与日志体验：以上内容按 v1.2.5 → v1.2.6 的实际代码差异整理。勋章 3D、连接页 WebSocket、代理内联编辑等已在此前版本出现，请在下方历史记录查看，未重复列为本版新增。
v1.2.5 · 2026-07-17 15:54 · 稳定版
查看 GitHub Release

新增 / 优化

  • 勋章系统升级为真 3D（WebGL/React Three Fiber）
  • 代理管理页支持内联编辑订阅与节点
  • 规则页集成规则集编辑与批量导入功能
  • 连接页改用 WebSocket 实时流更新
  • MosDNS 保存高级模式状态到本地存储
  • 新增策略组与规则集编辑 Hook
  • 代理页折叠/hover 动效增强
  • 升级 react-grid-layout 到 v2 版本
  • 心跳与激活逻辑优化，提升稳定性与体验
  • 「应用并重启」统一改为验证配置后执行
  • 进程身份指纹改用 start ticks 修复 Alpine 断开
  • 前端资源哈希失效自动恢复机制
  • 服务日志返回空而非 404 消除轮询噪音
  • 优化首页 Dashboard 交互与连接页渲染性能
  • react-markdown 组件实现懒加载优化

问题修复

  • 修复 Clash TUN 配置回放、macOS 默认及 Fake-IP 值
  • 修复 HTTP/HTTPS 切换后运行地址同步问题
  • 修复 Linux TUN 自愈、残留规则清理及转发
  • 修复订阅更新瞬时拉取错误导致失败
  • 修复订阅节点测速后延迟显示不同步
  • 修复未安装服务的日志接口返回 404 问题
  • 修复启动后启用中的订阅被误标为禁用
  • 修复 fakeip 路由丢失导致透明代理静默失效
  • 修复确认/选择弹窗被浮窗遮挡的定位问题
  • 修复 MSMDaemon 安装管理与启动卡住问题
  • 修复 DNS 入池条件误判中毒问题（仅 NXDOMAIN）
  • 修复网关 5xx 错误导致 Pro 授权意外降级
  • 修复未激活用户上报 telemetry 被服务端拉黑
  • 修复策略组表单 TS 编译错误及显示不全

注意事项

  • 租约有效时 lease mismatch 日志降为 Debug
  • 离线动作授权降级为“除显式拒绝外有效”
  • 源站 IP 直连兜底解决代理/CDN 链路 502
  • 移除 @types/react-grid-layout（v2 自带类型）
v1.2.2 · 2026-06-17 16:08 · 稳定版
查看 GitHub Release

注意事项

  • 分析显示该提交为开发标记，关联 #58，详细功能待确认。
v1.2.0 · 2026-06-10 16:13 · 稳定版
查看 GitHub Release

新增 / 优化

  • MosDNS 高级模式状态自动保存到本地
  • 添加记忆池容量显示与一键清空功能
  • Clash 编辑对话框增加防误关确认

问题修复

  • 优化 DNS 解析逻辑，修复 FakeIP 缓存及入池规则
  • 升级 License 安全机制，未激活禁止 Telemetry 上报
  • 修复软失败判定漏洞，改为 Fail-Secure 模式
  • 修复 TUN 网络转发、路由丢失及配置回放问题
  • 修复 Daemon 启动卡顿、服务管理及卸载残留
  • 修复桌面托盘切换、版本同步及 MosDNS 就绪
  • 修复 MosDNS 记忆池安全及数据一致性问题

注意事项

  • macOS 用户注意：TUN 局域网转发及默认配置已修复
v1.1.7 · 2026-05-16 14:37 · 稳定版
查看 GitHub Release

新增 / 优化

  • 添加默认代理 CIDR 216.239.36.0/24
  • 审计存储展示分解与字段透传支持
  • 优化自动判定批量操作与页面加载性能
  • 优化 MosDNS 自动判定冲突模型与标签语义
  • 优化高变化域名及 MosDNS 缓存策略
  • 调整通知弹窗居中显示与排版
  • 优化规则源配置、日志分页与升级验证
  • 增强进程管理与升级回滚可靠性

问题修复

  • 修复 MosDNS 自动判定确认语义
  • 修复配置恢复兼容性与订阅直连问题
  • 修复自动判定与升级缓存逻辑
  • 修复更新轮询构建错误及状态恢复

注意事项

  • 0.x 升至 1.x 需重装或重置安全并重下 DNS 服务
v1.1.2 · 2026-05-04 07:20 · 稳定版
查看 GitHub Release

新增 / 优化

  • 升级页支持恢复、应用及保留 MosDNS 配置
  • 调整 MosDNS 快路径 TTL 范围

问题修复

  • 优化 MosDNS FakeIP TTL 处理

注意事项

  • 0.x 升级至 1.x 需重置安全并重下 DNS 服务
v1.1.1 · 2026-05-03 17:52 · 稳定版
查看 GitHub Release

新增 / 优化

  • 限制 MosDNS 更新需先升级 MSM

问题修复

  • 修复许可证掉授权与 machine_code 回退
  • 修复增量升级配置恢复与恢复加固
  • 修复战网国内外 DNS 分流规则
  • 修复 MosDNS 原始指标代理异常
  • 修复本机分流模板保留及缓存同步问题

注意事项

  • 0.x 升 1.x 必须重装或重置安全并重新下载 DNS 服务
v1.1.0 · 2026-04-30 01:39 · 稳定版
查看 GitHub Release

新增 / 优化

  • 支持国内外 ECS 策略分离
  • 增加授权容灾功能
  • 隐藏废弃及国外 ECS 上游入口
  • 简化 MSM ECS 设置展示及缓存统计
  • 同步缓存与上游默认值

问题修复

  • 修复增量升级配置兼容性
  • 修复 ECS 策略状态类型错误
  • 修复激活页面 503 状态提示
  • 修复 OpenRC 重启及自重启逻辑
  • 修复 Docker Pro 授权掉线问题

注意事项

  • 0.x 升 1.x 需重装或重置安全并重下 DNS 服务
v1.0.35 · 2026-04-27 20:14 · 稳定版
查看 GitHub Release

新增 / 优化

  • 降低默认运行时内存预算

问题修复

  • 修复强制更新下载后无法安装的问题

注意事项

  • 0.x 升级至 1.x 需重置安全并重新下载 DNS 服务
v1.0.33 · 2026-04-26 19:28 · 稳定版
查看 GitHub Release

新增 / 优化

  • 新增备份恢复与更新流程安全防护功能。
  • 支持 MosDNS 白名单模式下本机代理。
  • 增强 MSM CLI 服务管理与重启状态同步。
  • 强化进程托管自愈逻辑与异常清理机制。
  • 统一更新下载回退策略及风险评分调整。
  • 收紧 Pro 在线授权并下发安全限制。

问题修复

  • 修复代理网络自愈误判及双栈健康检查。
  • 优化 MosDNS 缓存容量、策略及规则刷新。
  • 修复前端黑屏、表单校验及版本列表显示。
  • 修复冷启动接管及托管进程异常退出清理。
  • 修复备份归档安全性及 API Token 状态误判。

注意事项

  • 0.x 升级 1.x 必须重置安全并重新下载 DNS 服务。
v1.0.27 · 2026-04-16 14:28 · 稳定版
查看 GitHub Release

新增 / 优化

  • 新增规则集文件编辑功能
  • 新增日志悬浮窗交互优化及 5 项 UX 改进
  • 新增更新配置桌面端右栏常驻，移动端折叠显示
  • 合并安装和重启按钮为一个操作
  • 日志页面迁移至浮动窗口，侧边栏移除入口
  • 更新页面 UI 美化，修复平台翻译
  • MosDNS 恢复原始重试策略，优化网络请求逻辑
  • 性能提升：Clash 配置接口合并，API 调用减少 125 倍
  • 性能优化：SSE 数据迁移至 Zustand，消除级联重渲染

问题修复

  • 修复更新重启死循环，清理构建备份
  • 修复更新下载跳过中转服务器，避免误装 Beta 版本
  • 修复强制更新后无法安装重启及 Clash 版本显示异常
  • 修复更新模块 UI 重构、组件状态感知及按钮显示问题
  • 修复嵌入式前端黑屏、轮播模式 Bug 及外观设置问题
  • 修复日志页循环请求、运行时错误及循环依赖
  • 修复 MosDNS 规则查询走系统代理及配置恢复超时
  • 修复 Inline 规则集 Payload 序列化错误
  • 修复本地服务 HTTP 请求绕过系统代理问题

注意事项

  • 0.x 升级到 1.x 需重装或重置安全，重新下载 DNS 服务
v1.0.26 · 2026-04-16 12:35 · 稳定版
查看 GitHub Release

新增 / 优化

  • 更新配置桌面端右栏常驻，移动端折叠
  • 合并安装和重启为一个操作按钮
  • 支持规则集文件在线编辑功能
  • 日志页面迁移至浮动窗口，移除侧边栏
  • 更新页面 UI 美化及平台翻译修复
  • 日志窗口交互优化及 5 项 UX 改进
  • 配置接口合并，API 调用从 5 次减至 1 次
  • SSE 数据迁移至 Zustand store 消除重渲染
  • MosDNS 恢复原始 3×500ms 重试策略

问题修复

  • 修复嵌入式前端黑屏问题
  • 修复更新模块状态、按钮及版本显示异常
  • 修复强制更新安装重启流程及版本显示问题
  • 修复轮播模式 Bug 及外观设置页面问题
  • 修复规则查询及本地服务代理配置错误
  • 修复日志页循环请求及运行时错误
  • 更新下载跳过中转服务器避免 Beta 版

注意事项

  • 0.x 升至 1.x 需重装或重置安全并重新下载 DNS
v1.0.25 · 2026-04-16 11:52 · 稳定版
查看 GitHub Release

新增 / 优化

  • 更新配置桌面端常驻，移动端折叠显示
  • 合并安装和重启操作为单一按钮
  • 支持规则集文件在线编辑功能
  • 日志页面迁移至浮动窗口，优化交互
  • 优化配置接口调用及 SSE 数据渲染性能
  • MosDNS 恢复原始重试策略

问题修复

  • 修复更新模块 UI、版本显示及安装重启流程问题
  • 跳过中转服务器更新，防止误装 Beta 版本
  • 修复本地服务及规则查询的系统代理逻辑
  • 修复 MosDNS 升级后配置恢复超时问题
  • 修复轮播模式 Bug 及外观设置页面问题
  • 修复日志页循环请求及相关运行时错误
  • 修复规则集文件序列化导致崩溃问题

注意事项

  • 0.x 升级 1.x 需重装或重置 DNS 服务
v1.0.24 · 2026-04-13 23:41 · 稳定版
查看 GitHub Release

新增 / 优化

  • 调整代理网络自愈策略：默认关闭，放宽判定，间隔 3 秒
  • 默认禁用 libpcap 依赖，保留显式构建支持

问题修复

  • 修复代理网络规则丢失、误判及重启重复恢复问题
  • 修复 MosDNS 日志交互、概览及就绪判定问题
  • 修复 Clash YAML 保存及粘贴错位兼容性问题
  • 修复更新页面状态残留及 Alpha 版显示问题

注意事项

  • 0.x 升级至 1.x 需重置安全或重装 DNS 服务，否则可能失效
v1.0.22 · 2026-04-11 00:57 · 稳定版
查看 GitHub Release

新增 / 优化

  • 支持 Fake-IP 范围在设置页编辑并立即生效
  • 支持 HTTPS 证书上传及自签名生成
  • Setup 支持自动下载和手动上传安装方式
  • 新增 CLI 自更新命令及平台版本选择修复
  • MosDNS 客户端黑白名单拆分适配
  • 补齐进程管理前端控制面与服务配置接口
  • 前端统一将旧代理核心 / ProxyCore 显示名调整为 Clash
  • 默认隐藏实验性 Docker 管理和网络工具入口
  • 启动链路切换，移除旧版 supervisord 依赖
  • 系统设置页面布局优化及个人中心入口迁移
  • 优化前端构建分包，消除 Vite 大 chunk 警告

问题修复

  • 修复升级残留进程导致的端口冲突问题
  • 修复重启时能力丢失导致 Pro 授权失效问题
  • 修复 MosDNS 上游统计及 DNS 查询曲线停滞
  • 修复 Linux 下僵尸进程误判及单节点 YAML 解析
  • 修复配置文件保存时二进制路径查找错误
  • 修复日志页筛选异常及访问日志降噪处理
  • 修复服务关闭时 SSE 长连接导致的超时问题

注意事项

  • ⚠️ 0.x 升级到 1.x 需重装或重置安全以重新下载 DNS 服务
  • ⚠️ 加固了 Pro 授权校验与运行时完整性
v1.0.15 · 2026-04-01 10:37 · 稳定版
查看 GitHub Release

问题修复

  • 修复规则集编辑、展示及保存异常行为

注意事项

  • 0.x 升级至 1.x 需重置安全并重新下载 DNS 服务
v1.0.14 · 2026-03-31 10:14 · 稳定版
查看 GitHub Release

新增 / 优化

  • 联动 MosDNS 客户端名称并优化日志筛选功能
  • 调整组件更新阶段 GitHub 下载优先级
  • 优化内存预算、监控负载及长期运行内存占用
  • 统一 MosDNS 恢复写操作的重试策略

问题修复

  • 修复 MosDNS 恢复阶段回写失败及 API 就绪等待问题
  • 修复许可证重激活时因本地授权材料损坏导致的失败
  • 修复内存回收死锁并降低实时面板分配
  • 修复 Dashboard 布局拖拽混乱、调节受限及刷新失效问题

注意事项

  • 0.x 升级到 1.x 需重装或重置安全，DNS 服务已变更
v0.7.4 · 2026-01-05 21:16 · 稳定版
查看 GitHub Release

新增 / 优化

  • Clash 规则管理增强
    • 规则页支持按配置文件分组排序，方便快速定位
    • 规则 / Provider 支持“可选重启生效”
    • 默认 interval 等参数调整为更合理的值
  • Setup 流程优化
    • 保存配置时增加下载进度提示
    • 运行期可切换代理核心，缺失核心自动下载
  • 项目管理与下载优化
    • 新增 Issue 模板与 VPS 预设（含 Clash）
    • CLI / 下载链路默认优先使用内置加速源，界面展示下载进度

问题修复

  • 修复 Clash 规则编辑器初始化报错、弹窗越界、空 {} YAML 导致损坏等问题
  • 修复前端启停代理、日志级别解析、Toast 长文本、导航高亮等多处 UI / 交互问题
  • 修复部分版本号、路径、配置读取错位，尤其是 Setup 与缓存相关逻辑

注意事项

  • Tauri 桌面链路已基本稳定，但在 macOS 上仍建议重点验证 launchctl 工作目录与权限场景
v0.7.3 · 2026-01-01 13:29 · 稳定版
查看 GitHub Release

新增 / 优化

  • Connections 页面重做
    • 采用弹窗模式，支持保持展开状态，更紧凑的布局
    • 测速与展开可并存，便于排查连接质量
  • 代理链展示优化
    • 切换操作不再强制折叠，补充更多测速信息
    • 规则页节点卡片新增图标、双列瀑布流布局
  • Setup 优化
    • 初始化流程与版本号管理进行了多处微调

问题修复

  • 修复 IPv6 / DNS 开关在保存和读取旧配置时的不一致问题
  • 修复 Clash 页面若干弹窗居中、溢出与 YAML 处理错误
  • 修复白屏、布局跳动等零碎 UI 问题

注意事项

  • 桌面端与 SSE 改造仍处于快速演进阶段，升级后建议重点观察 SSE 长连接稳定性
v0.7.2 · 2025-12-31 20:52 · 稳定版
查看 GitHub Release

核心内容

  • 桌面端服务管理
    • 桌面端服务管理与托盘初版
    • 支持自动安装 / 提权、首次运行门禁、状态面板等
  • UI 与链路优化
    • MosDNS / Clash 管理界面大幅改版
    • 梳理 SSE 相对路径、CORS、静态资源与代理概览链路
  • 问题修复
    • 修复大量 macOS DMG、权限、服务检测相关问题
    • 修复 Connections 刷新 / 测速 / 展开等问题

🔄 升级建议 ​

升级前准备

  1. 升级前建议先备份配置目录和重要数据，避免遗漏迁移
  2. 桌面端（Tauri）用户：升级后请确认 launchctl / 托盘服务状态，以及本地 API 是否可访问
  3. Clash 规则 / Provider 编辑器自 0.7.3 起快速演进，升级前建议备份现有 YAML，升级后复核生成结果

📖 如何升级 ​

详细步骤请参考：更新升级指南。

🔗 版本兼容性（0.7.x 系列） ​

  • ✅ 0.7.x 系列版本之间可以直接升级
  • 🔄 配置文件在升级过程中会自动迁移和合并
  • 💾 建议定期备份配置目录，尤其在跨大版本前

💬 获取帮助 ​