Repository navigation
🚀 MSM 2.1.6(稳定版)
✨ 本次更新
🎉 本次亮点(Highlights)
- 跨服务配置同步可确认:MosDNS 与 Clash、Sing-Box 的 IPv6 和受管理域名名单变更可生成同步提议,接受前校验来源版本与有效期;用户可选择同步或保持两侧独立。
- DNS 不再返回伪 IPv6:识别上游返回的
2001::1占位 AAAA 结果,先丢弃并尝试其他解析链路,仍为占位地址时拒绝返回,减少错误 IPv6 进入连接流程。 - 代理核心操作更可控:Clash 与 Sing-Box 的配置变更、控制器请求、重启和就绪检查按核心协调;并发达到限制或核心仍在预热时会明确拒绝操作。
- 客户端目录聚合多地址:同一 MAC 当前关联的 IPv4、IPv6 会聚合为一个设备条目,名单匹配、移除和编辑可覆盖该设备的活动地址。
- 运行时配置更能保留用户修改:Clash 活动配置中的可管理字段会同步回设置数据,启动恢复和自动协调不再仅凭旧设置覆盖现有地址池或提供商内容。
- Sing-Box 安装增加版本一致性校验:除下载摘要外,还会核对归档内二进制版本与发布元数据;版本不匹配或缺少目标二进制时不会继续安装。
🎉 重磅功能(Major)
- 用户确认式跨服务策略同步:新增同步提议的持久化、查询、接受和拒绝流程。MosDNS 名单及 IPv6 设置、代理侧受管理域名规则等变更可携带提议摘要;提议默认 10 分钟过期,接受时会检查仍待处理且来源版本未变化,降低旧配置覆盖新修改的风险。
- 网络客户端策略自动绑定:网络库存按 MAC 关联当前 IPv4/IPv6 地址,MosDNS 客户端策略可将设备策略扩展到这些地址;地址轮换时更新派生绑定,同时保留用户明确配置的地址和 CIDR 条目。
- 跨平台邻居信息纳入客户端目录:Linux 读取内核邻居缓存,支持的非 Linux 路径使用系统 ARP/NDP 回退信息;目录按当前扫描结果聚合设备,并过滤回环、组播、链路本地等不适合作为客户端标识的地址。
🆕 新增功能(Added)
- 同步提议 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 活动配置变更同步:配置更新、切换、回滚、恢复等路径会通知应用层,使活动配置中的可管理字段能够回写设置数据。
✨ 功能增强(Changed)
- 重载与重启状态明确区分:配置应用接口会返回实际发生的是热加载还是重启,并补充相应状态字段;需要重启的操作会等待核心进入可用状态后再返回。
- 代理控制器增加并发边界: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 提供商节点解析更稳健:统一处理运行时返回的提供商节点数据,过滤缺少有效名称或格式不正确的条目,避免切换期间异常数据影响页面操作。
⚡ 性能优化(Performance)
- 策略同步优先读取邻居缓存:后台策略同步可直接读取已有 ARP/NDP 邻居信息,而不是每次都执行完整网段探测;完整扫描仍用于需要更丰富设备信息的场景。
- 延迟探测避免无限并发:Clash 与 Sing-Box 的代理延迟测试使用独立并发槽位,超出容量时快速反馈,而不是继续叠加控制器请求。
- MosDNS 请求采用有限并发:运行时 API 使用固定并发容量和最长等待时间,使高并发场景更早返回可处理的错误。
🐛 问题修复(Fixed)
- 拒绝
2001::1AAAA 占位地址:修复 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 提供商切换期间页面异常:运行时返回不完整数据时不再直接触发节点处理异常,已有有效数据也不会因一次刷新失败而被清空。
🛡️ 安全加固(Security)
- 校验 Sing-Box 归档内版本:安装时读取归档中的二进制版本,并与同一发布元数据提供的期望版本比较;缺少二进制或版本不匹配时拒绝继续安装。
- 限制 Fake-IP 清理的控制器地址:清理 Clash 或 Sing-Box Fake-IP 缓存时校验控制器地址为受支持的本地地址,并使用活动配置中的控制器和认证信息。
- 同步提议接受前校验来源状态:提议过期、已处理或来源配置发生变化时拒绝接受,避免基于旧提议应用配置。
- 代理控制器写操作增加忙碌保护:并发写入达到限制或核心处于未就绪状态时拒绝本次操作,降低多个配置变更同时执行造成状态错乱的风险。
⚠️ 兼容性变更(Deprecated)
- 名单写入接口增加可选字段:MosDNS 名单写入接口支持
suppress_sync;不需要触发跨服务同步提示的内部写入方可携带该字段。 - 写入接口可能返回同步提议:规则和名单写入接口除原有成功结果外,可能在
data.sync_offer中返回提议;不使用同步能力的客户端可忽略该字段。 - 代理配置响应区分重载与重启:相关接口增加
reloaded等状态字段,调用方不应只依据旧的restarted字段判断实际生效方式。 - 自动协调不再隐式迁移旧 Fake-IP IPv6 地址池:启动恢复和自动模板协调会保留现有地址池;需要更换地址池时,应通过设置中的显式地址配置完成。
- Sing-Box 旧下载字段会被转换:旧版
download_detour等字段会在兼容处理时转换为http_client.detour,新生成和保存的配置采用新版结构。
📌 升级提醒(Notes)
- 检查自定义 API 客户端的响应解析:如果客户端严格校验规则、名单或代理配置接口的响应结构,需要允许
sync_offer、reloaded等新增字段。 - 同步提议需在有效期内确认:提议默认有效 10 分钟;来源配置发生变化后,原提议不能继续接受。
- 关注 Sing-Box 安装校验结果:下载内容需同时满足摘要校验和归档内版本匹配,否则安装流程会拒绝激活该归档。
📋 构建信息
| 项目 | 内容 |
|---|---|
| 版本号 | 2.1.6 |
| 发布通道 | stable |
| 源仓库 | msm9527/msm |
| 构建分支 | main 🌿 |
| 源提交 | 55fd747 |
| 构建时间 | 2026-10-25 12:52:45 CST ⏰ |
🎯 最新提交详情
Merge pull request #102 from msm9527/dev
- 📅 时间: 2026-10-25 11:57:30 CST
- 🔗 链接: https://github.com/msm9527/msm/commit/55fd747acc0d0ff2535b1c861f50bed2be673e0b
💾 下载安装
🖥️ 命令行版本(CLI)
Linux 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-2.1.6-linux-amd64.tar.gz |
标准版本(推荐) |
| amd64-v3 | msm-2.1.6-linux-amd64-v3.tar.gz |
优化版(需 AVX2) |
| amd64-musl | msm-2.1.6-linux-amd64-musl.tar.gz |
Alpine Linux |
| amd64-musl-v3 | msm-2.1.6-linux-amd64-musl-v3.tar.gz |
Alpine 优化版 |
| arm64 | msm-2.1.6-linux-arm64.tar.gz |
ARM 64位 |
| arm64-musl | msm-2.1.6-linux-arm64-musl.tar.gz |
ARM Alpine |
| armv7 | msm-2.1.6-linux-armv7.tar.gz |
ARM 32位 (v7) |
| armv6 | msm-2.1.6-linux-armv6.tar.gz |
ARM 32位 (v6) |
💡 提示: amd64-v3 版本针对较新的 CPU 进行了优化(需要支持 AVX、AVX2 等指令集),性能更好但兼容性较低。如果不确定,请使用标准的 amd64 版本。
🧩 派网应用版本(APX)
PanaBit / 派网
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-2.1.6-linux-amd64-panabit.apx |
派网 x86_64 安装包 |
| arm64 | msm-2.1.6-linux-arm64-panabit.apx |
派网 ARM64 安装包 |
说明:
.apx安装后会在派网页面中提供 MSM 控制入口- 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
- 如果派网设备已有服务占用目标端口,请先处理端口冲突
macOS 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-2.1.6-darwin-amd64.tar.gz |
Intel 芯片 Mac |
| Apple Silicon | msm-2.1.6-darwin-arm64.tar.gz |
M1/M2/M3 芯片 |
🖼️ 桌面应用版本(Desktop)
macOS 桌面应用
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-desktop-2.1.6-darwin-amd64.dmg |
Intel 芯片 Mac |
| Apple Silicon | msm-desktop-2.1.6-darwin-arm64.dmg |
M1/M2/M3 芯片 |
安装步骤:
- 下载对应架构的 DMG 文件
- 双击 DMG 文件,将应用拖入 Applications 文件夹
- 首次打开时,如果遇到"无法验证开发者"提示:
- 打开"系统设置" → "隐私与安全性"
- 点击"仍要打开"按钮
- 由于应用未经过 Apple 公证,macOS 可能拦截首次打开,或提示"文件已损坏/无法打开"。可执行以下命令解除隔离属性:
- /usr/bin/xattr -cr "/Applications/msm-desktop.app"
- 该命令仅用于处理 Gatekeeper/隔离属性拦截;发布流程已校验包内后端签名和可执行性。如果执行后仍无法安装服务,请下载最新版本并反馈错误日志。
🚀 快速安装
一键安装脚本(推荐)
curl -fsSL https://raw.githubusercontent.com/msm9527/msm-wiki/main/install.sh | sudo bash🔐 完整性校验
- 校验清单:
SHA256SUMS - CLI 发布包使用加固版构建,启动时会校验内嵌官方 SHA-256;若二进制被篡改会拒绝运行
手动安装(以 Linux amd64 为例)
# 下载
wget https://github.com/msm9527/msm-wiki/releases/download/2.1.6/msm-2.1.6-linux-amd64.tar.gz
# 解压
tar -xzf msm-2.1.6-linux-amd64.tar.gz
# 安装
sudo mv msm /usr/local/bin/msm
sudo chmod +x /usr/local/bin/msm
# 验证
msm --versionDocker 安装
# 拉取镜像
docker pull msmbox/msm:2.1.6
# 运行容器
docker run -d \
--name msm \
-p 7777:7777 \
-v /opt/msm:/opt/msm \
msmbox/msm:2.1.6⚖️ 使用与合规
MSM 是用于管理用户自有或已获授权设备的自托管管理平台,不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。