Repository navigation
🚀 MSM beta-2.0.2(Beta 版)
Pre-release
Pre-release
·
76 commits
to main
since this release
✨ 本次更新
🎉 本次亮点(Highlights)
- 托管服务崩溃存活:Linux 下支持 systemd 托管模式,MSM 异常退出时托管服务不中断,恢复后自动核验并接管原进程。
- 进程控制权统一:CLI 与后台守护进程通过锁机制协调,防止多实例冲突操作,离线 CLI 需获取控制权锁方可管理。
- 初始化 DNS 更保守:未明确授权时默认不修改宿主 DNS,网络规则应用失败后仍保持关闭状态,避免配置残留。
- 资源指标更准确:服务状态新增采样可用标识与 cgroup 内存数据,采样失败时明确显示不可用而非零值。
🆕 新增功能(Added)
- systemd 进程托管后端:Linux 环境下支持将托管服务配置为 systemd 模式,利用 cgroup v2 实现更精准的进程组管理与资源统计。
- CLI 操作记录查询:新增
msm operation <ID>命令,支持查询异步进程控制请求的执行阶段与结果。
✨ 功能增强(Changed)
- 服务状态 API 字段扩展:
GET /api/v1/services返回新增metrics_available、cgroup_memory及backend字段,前端据此调整资源展示逻辑。 - 初始化 DNS 开关逻辑:
POST /api/v1/setup/initialize的auto_set_dns默认为关闭,且会在网络配置失败时持久化关闭状态,需显式传递true才开启。 - 组件下载代理策略:EasyTier 与 Tailscale 更新检查优先使用系统设置的组件下载代理,无效配置将报错而非静默回退直连。
🐛 问题修复(Fixed)
- Sing-Box 旧版占位符清理:升级时自动移除未订阅模板中的旧版 provider 占位符,避免配置冲突。
- Clash 空订阅区块保存:修复
proxy-providers为空行内映射(如{})时保存失败的问题,支持规范化处理。 - 重启失败服务恢复:优化 MSM 自身重启逻辑,若重启前准备失败,支持恢复已停止的托管服务至原状态。
- 进程组状态核验:修复根进程退出但子进程组仍存活时状态误报为停止的问题,此类情况将标记为
UNKNOWN并保留 DNS 租约。 - Sing-Box 无配置更新:允许在服务停止且配置文件缺失时执行 Sing-Box 核心更新,避免阻塞升级流程。
- 初始化 DNS 关闭失效:修复初始化请求中未传递 DNS 开关时可能误开启自动修改宿主 DNS 的问题。
📌 升级提醒(Notes)
- 版本号:后端与前端版本均升级至 2.0.2。
- API 兼容性:服务状态响应结构变更,旧客户端需适配
metrics_available等新字段;初始化接口autoSetDNS字段仍兼容但推荐使用auto_set_dns。 - 进程管理:Linux 用户若遇到服务状态显示
UNKNOWN,通常表示进程组归属未确认,需手动停止或等待系统核验完成。
📋 构建信息
| 项目 | 内容 |
|---|---|
| 版本号 | beta-2.0.2 |
| 发布通道 | beta |
| 源仓库 | msm9527/msm |
| 构建分支 | dev 🌿 |
| 源提交 | 331e7ed |
| 构建时间 | 2026-09-25 14:13:26 CST ⏰ |
🎯 最新提交详情
chore(release): bump version to 2.0.2 / 发布版本升级至 2.0.2
- 📅 时间: 2026-09-25 13:39:35 CST
- 🔗 链接: https://github.com/msm9527/msm/commit/331e7ed115ea3b91b63f7ec11591017dd140c9e7
💾 下载安装
🖥️ 命令行版本(CLI)
Linux 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-beta-2.0.2-linux-amd64.tar.gz |
标准版本(推荐) |
| amd64-v3 | msm-beta-2.0.2-linux-amd64-v3.tar.gz |
优化版(需 AVX2) |
| amd64-musl | msm-beta-2.0.2-linux-amd64-musl.tar.gz |
Alpine Linux |
| amd64-musl-v3 | msm-beta-2.0.2-linux-amd64-musl-v3.tar.gz |
Alpine 优化版 |
| arm64 | msm-beta-2.0.2-linux-arm64.tar.gz |
ARM 64位 |
| arm64-musl | msm-beta-2.0.2-linux-arm64-musl.tar.gz |
ARM Alpine |
| armv7 | msm-beta-2.0.2-linux-armv7.tar.gz |
ARM 32位 (v7) |
| armv6 | msm-beta-2.0.2-linux-armv6.tar.gz |
ARM 32位 (v6) |
💡 提示: amd64-v3 版本针对较新的 CPU 进行了优化(需要支持 AVX、AVX2 等指令集),性能更好但兼容性较低。如果不确定,请使用标准的 amd64 版本。
📡 OpenWrt 原生安装包(IPK / APK + LuCI)
OpenWrt 24.10 及以前使用 IPK(opkg),25.12 及以后使用 APK(apk v3)。选择与设备包架构匹配的 msm 包,再安装同版本 luci-app-msm 插件。
下载 OpenWrt 软件包(x86_64 / ARM64 / ARMv7 / ARMv6)
### 🧩 派网应用版本(APX)
<details>
<summary><b>PanaBit / 派网</b></summary>
| 架构 | 文件 | 说明 |
|------|------|------|
| amd64 | msm-beta-2.0.2-linux-amd64-panabit.apx | 派网 x86_64 安装包 |
| arm64 | msm-beta-2.0.2-linux-arm64-panabit.apx | 派网 ARM64 安装包 |
说明:
.apx安装后会在派网页面中提供 MSM 控制入口- 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
- 如果派网设备已有服务占用目标端口,请先处理端口冲突
macOS 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-beta-2.0.2-darwin-amd64.tar.gz |
Intel 芯片 Mac |
| Apple Silicon | msm-beta-2.0.2-darwin-arm64.tar.gz |
M1/M2/M3 芯片 |
🖼️ 桌面应用版本(Desktop)
macOS 桌面应用
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-desktop-beta-2.0.2-darwin-amd64.dmg |
Intel 芯片 Mac |
| Apple Silicon | msm-desktop-beta-2.0.2-darwin-arm64.dmg |
M1/M2/M3 芯片 |
安装步骤:
- 下载对应架构的 DMG 文件
- 双击 DMG 文件,将应用拖入 Applications 文件夹
- 首次打开时,如果遇到"无法验证开发者"提示:
- 打开"系统设置" → "隐私与安全性"
- 点击"仍要打开"按钮
- 由于应用未经过 Apple 公证,macOS 可能拦截首次打开,或提示"文件已损坏/无法打开"。可执行以下命令解除隔离属性:
- /usr/bin/xattr -cr "/Applications/msm-desktop.app"
- 该命令仅用于处理 Gatekeeper/隔离属性拦截;发布流程已校验包内后端签名和可执行性。如果执行后仍无法安装服务,请下载最新版本并反馈错误日志。
🚀 快速安装
OpenWrt 请使用上方的原生软件包,按 OpenWrt 安装指南 操作。
一键安装脚本(Linux / macOS)
curl -fsSL https://raw.githubusercontent.com/msm9527/msm-wiki/main/install_beta.sh | sudo bash🔐 完整性校验
- 校验清单:
SHA256SUMS - CLI 发布包使用加固版构建,启动时会校验内嵌官方 SHA-256;若二进制被篡改会拒绝运行
手动安装(以 Linux amd64 为例)
# 下载
wget https://github.com/msm9527/msm-wiki/releases/download/beta-2.0.2/msm-beta-2.0.2-linux-amd64.tar.gz
# 解压
tar -xzf msm-beta-2.0.2-linux-amd64.tar.gz
# 安装
sudo mv msm /usr/local/bin/msm
sudo chmod +x /usr/local/bin/msm
# 验证
msm --versionDocker 安装
# 拉取镜像
docker pull msmbox/msm:beta-2.0.2
# 运行容器
docker run -d \
--name msm \
-p 7777:7777 \
-v /opt/msm:/opt/msm \
msmbox/msm:beta-2.0.2⚖️ 使用与合规
MSM 是用于管理用户自有或已获授权设备的自托管管理平台,不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。