Skip to content

🚀 MSM 2.1.7（稳定版）

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 27 Oct 23:42
· 12 commits to main since this release
2.1.7
3ccc4b5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

📦 MSM 2.1.7

Build Status
Version
Platform

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

✨ 本次更新

🎉 本次亮点（Highlights）

  • 网页卸载先预览、再确认：新增当前实例的完全卸载流程，管理员确认清理范围后执行，并可查看完成、失败或状态未知的结果。
  • 重置后减少旧状态回流：扩展服务端清理范围，同步浏览器标签页与图标库缓存，减少重新初始化后旧记录、旧设置再次出现的情况。
  • DDNS 更适合双出口环境：默认采用国内 HTTPS 检测源，IPv4、IPv6 可分别绑定出口接口；检测结果冲突时阻止对应地址族更新。
  • Clash 升级保留现有设置：调整配置升级合并方式，补齐模板默认项并保留已有配置，改善回家访问与自定义设置在升级时被覆盖的问题。
  • WireGuard 安装与排障更清楚：补充运行依赖检查、APT 安装恢复处理及 UDP 端口映射提示，帮助定位“服务已运行但外网仍无法连接”的原因。

🆕 新增功能（Added）

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

✨ 功能增强（Changed）

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

🐛 问题修复（Fixed）

  • 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 段，此项不代表要求迁移现有地址段。

🛡️ 安全加固（Security）

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

📌 升级提醒（Notes）

  • macOS 桌面卸载改为完全清理：桌面端的服务卸载现调用 --purge，不再仅移除系统服务注册。完全卸载不可撤销，需要保留的备份应提前移到配置目录之外。
  • 容器安装仍需宿主机清理：网页不会代删 Docker 容器、MSM 专用卷、绑定目录或启动编排；不支持网页卸载的安装应按界面提示在宿主机处理。
  • 双 WAN 需要匹配上级路由：DDNS 绑定本机 LAN 接口不能替上级路由器选择 WAN。应让检测域名或 MSM 流量经过回家访问所用出口，并按实际网络分别配置 IPv4、IPv6 接口。

📋 构建信息

项目 内容
版本号 2.1.7
发布通道 stable
源仓库 msm9527/msm
构建分支 main 🌿
源提交 fb9b5b3
构建时间 2026-10-28 07:24:40 CST ⏰
🎯 最新提交详情

合并 MSM 2.1.7 至 main / Merge MSM 2.1.7 into main

💾 下载安装

🖥️ 命令行版本（CLI）

Linux 平台
架构 文件 说明
amd64 msm-2.1.7-linux-amd64.tar.gz 标准版本（推荐）
amd64-v3 msm-2.1.7-linux-amd64-v3.tar.gz 优化版（需 AVX2）
amd64-musl msm-2.1.7-linux-amd64-musl.tar.gz Alpine Linux
amd64-musl-v3 msm-2.1.7-linux-amd64-musl-v3.tar.gz Alpine 优化版
arm64 msm-2.1.7-linux-arm64.tar.gz ARM 64位
arm64-musl msm-2.1.7-linux-arm64-musl.tar.gz ARM Alpine
armv7 msm-2.1.7-linux-armv7.tar.gz ARM 32位 (v7)
armv6 msm-2.1.7-linux-armv6.tar.gz ARM 32位 (v6)

💡 提示： amd64-v3 版本针对较新的 CPU 进行了优化（需要支持 AVX、AVX2 等指令集），性能更好但兼容性较低。如果不确定，请使用标准的 amd64 版本。

🧩 派网应用版本（APX）

PanaBit / 派网
架构 文件 说明
amd64 msm-2.1.7-linux-amd64-panabit.apx 派网 x86_64 安装包
arm64 msm-2.1.7-linux-arm64-panabit.apx 派网 ARM64 安装包

说明：

  1. .apx 安装后会在派网页面中提供 MSM 控制入口
  2. 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
  3. 如果派网设备已有服务占用目标端口，请先处理端口冲突
macOS 平台
架构 文件 说明
Intel msm-2.1.7-darwin-amd64.tar.gz Intel 芯片 Mac
Apple Silicon msm-2.1.7-darwin-arm64.tar.gz M1/M2/M3 芯片

🖼️ 桌面应用版本（Desktop）

macOS 桌面应用
架构 文件 说明
Intel msm-desktop-2.1.7-darwin-amd64.dmg Intel 芯片 Mac
Apple Silicon msm-desktop-2.1.7-darwin-arm64.dmg M1/M2/M3 芯片

安装步骤：

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

# 解压
tar -xzf msm-2.1.7-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:2.1.7

# 运行容器
docker run -d \
  --name msm \
  -p 7777:7777 \
  -v /opt/msm:/opt/msm \
  msmbox/msm:2.1.7

⚖️ 使用与合规

MSM 是用于管理用户自有或已获授权设备的自托管管理平台，不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。

📚 文档与支持

🤖 由 GitHub Actions 自动构建

GitHub
Documentation
Docker

Assets 17
Loading