Skip to content

🚀 MSM beta-2.0.2(Beta 版)

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 25 Sep 06:27
· 76 commits to main since this release
a268c03

📦 MSM beta-2.0.2

Build Status
Version
Platform

Beta 版每日自动构建 · 包含最新代码更新


✨ 本次更新

🎉 本次亮点(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


💾 下载安装

🖥️ 命令行版本(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)
文件 格式
luci-app-msm-2.0.2_beta-r3_all.apk apk
luci-app-msm_2.0.2_beta-r3_all.ipk ipk
msm-2.0.2_beta-r3_x86_64.apk apk
msm_2.0.2_beta-r3_x86_64.ipk ipk
msm-2.0.2_beta-r3_aarch64_cortex-a53.apk apk
msm-2.0.2_beta-r3_aarch64_cortex-a72.apk apk
msm-2.0.2_beta-r3_aarch64_generic.apk apk
msm_2.0.2_beta-r3_aarch64_cortex-a53.ipk ipk
msm_2.0.2_beta-r3_aarch64_cortex-a72.ipk ipk
msm_2.0.2_beta-r3_aarch64_generic.ipk ipk
msm-2.0.2_beta-r3_arm_arm1176jzf-s_vfp.apk apk
msm_2.0.2_beta-r3_arm_arm1176jzf-s_vfp.ipk ipk
msm-2.0.2_beta-r3_arm_cortex-a15_neon-vfpv4.apk apk
msm-2.0.2_beta-r3_arm_cortex-a7_neon-vfpv4.apk apk
msm-2.0.2_beta-r3_arm_cortex-a9_neon.apk apk
msm-2.0.2_beta-r3_arm_cortex-a9_vfpv3-d16.apk apk
msm_2.0.2_beta-r3_arm_cortex-a15_neon-vfpv4.ipk ipk
msm_2.0.2_beta-r3_arm_cortex-a7_neon-vfpv4.ipk ipk
msm_2.0.2_beta-r3_arm_cortex-a9_neon.ipk ipk
msm_2.0.2_beta-r3_arm_cortex-a9_vfpv3-d16.ipk ipk
        ### 🧩 派网应用版本(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 安装包 |

说明:

  1. .apx 安装后会在派网页面中提供 MSM 控制入口
  2. 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
  3. 如果派网设备已有服务占用目标端口,请先处理端口冲突
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 芯片

安装步骤:

  1. 下载对应架构的 DMG 文件
  2. 双击 DMG 文件,将应用拖入 Applications 文件夹
  3. 首次打开时,如果遇到"无法验证开发者"提示:
    • 打开"系统设置" → "隐私与安全性"
    • 点击"仍要打开"按钮
  4. 由于应用未经过 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 --version

Docker 安装

# 拉取镜像
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 是用于管理用户自有或已获授权设备的自托管管理平台,不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。


📚 文档与支持


🤖 由 GitHub Actions 自动构建

GitHub
Documentation
Docker