Repository navigation
🚀 MSM 2.0.3(稳定版)
✨ 本次更新
🎉 本次亮点
- 代理双核心工作流:原有 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 和透明代理需要宿主机具备对应内核、网络权限及端口条件。
📋 构建信息
| 项目 | 内容 |
|---|---|
| 版本号 | 2.0.3 |
| 发布通道 | stable |
| 源仓库 | msm9527/msm |
| 构建分支 | main 🌿 |
| 源提交 | 8ef0fd2 |
| 构建时间 | 2026-09-25 23:33:35 CST ⏰ |
🎯 最新提交详情
Merge PR #90: 发布 v2.0.3 / promote v2.0.3 to main
- 📅 时间: 2026-09-25 21:38:30 CST
- 🔗 链接: https://github.com/msm9527/msm/commit/8ef0fd2051a869331ac0068adba9d8259476c83e
💾 下载安装
🖥️ 命令行版本(CLI)
Linux 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-2.0.3-linux-amd64.tar.gz |
标准版本(推荐) |
| amd64-v3 | msm-2.0.3-linux-amd64-v3.tar.gz |
优化版(需 AVX2) |
| amd64-musl | msm-2.0.3-linux-amd64-musl.tar.gz |
Alpine Linux |
| amd64-musl-v3 | msm-2.0.3-linux-amd64-musl-v3.tar.gz |
Alpine 优化版 |
| arm64 | msm-2.0.3-linux-arm64.tar.gz |
ARM 64位 |
| arm64-musl | msm-2.0.3-linux-arm64-musl.tar.gz |
ARM Alpine |
| armv7 | msm-2.0.3-linux-armv7.tar.gz |
ARM 32位 (v7) |
| armv6 | msm-2.0.3-linux-armv6.tar.gz |
ARM 32位 (v6) |
💡 提示: amd64-v3 版本针对较新的 CPU 进行了优化(需要支持 AVX、AVX2 等指令集),性能更好但兼容性较低。如果不确定,请使用标准的 amd64 版本。
🧩 派网应用版本(APX)
PanaBit / 派网
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-2.0.3-linux-amd64-panabit.apx |
派网 x86_64 安装包 |
| arm64 | msm-2.0.3-linux-arm64-panabit.apx |
派网 ARM64 安装包 |
说明:
.apx安装后会在派网页面中提供 MSM 控制入口- 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
- 如果派网设备已有服务占用目标端口,请先处理端口冲突
macOS 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-2.0.3-darwin-amd64.tar.gz |
Intel 芯片 Mac |
| Apple Silicon | msm-2.0.3-darwin-arm64.tar.gz |
M1/M2/M3 芯片 |
🖼️ 桌面应用版本(Desktop)
macOS 桌面应用
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-desktop-2.0.3-darwin-amd64.dmg |
Intel 芯片 Mac |
| Apple Silicon | msm-desktop-2.0.3-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.0.3/msm-2.0.3-linux-amd64.tar.gz
# 解压
tar -xzf msm-2.0.3-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.0.3
# 运行容器
docker run -d \
--name msm \
-p 7777:7777 \
-v /opt/msm:/opt/msm \
msmbox/msm:2.0.3⚖️ 使用与合规
MSM 是用于管理用户自有或已获授权设备的自托管管理平台,不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。