Repository navigation
🚀 MSM beta-2.0.4(Beta 版)
Pre-release
Pre-release
·
61 commits
to main
since this release
✨ 本次更新
🎉 本次亮点(Highlights)
- Docker Agent 镜像独立发布:Agent 镜像迁移至
msmbox/msm-agent独立仓库,安装命令默认拉取latest标签,不再强制绑定主程序版本号,简化升级流程。 - 节点隧道会话一致性保障:反向隧道连接引入会话 ID 校验与连接池重置机制,Agent 重连时自动清理旧连接,避免多会话状态冲突。
- 隧道空闲连接稳定性提升:调整控制端隧道服务端超时策略,移除激进的空闲超时设置,防止在调度前意外关闭已建立的反向连接。
✨ 功能增强(Changed)
- Docker Agent 镜像源调整:独立 Agent 镜像不再从
msmbox/msm仓库发布,改为从msmbox/msm-agent仓库拉取;前端生成的安装命令已更新为新的镜像地址。 - 节点隧道注册逻辑优化:隧道注册表增加会话 ID 跟踪,当检测到新会话 ID 时自动重置连接池并关闭旧连接,确保控制端与当前活跃 Agent 会话一致。
- 安装示例路径规范化:Docker Agent 安装命令中的 TLS 证书挂载路径从
/path/to/agent-tls调整为$PWD/tls,更符合本地直接运行的操作习惯。
🐛 问题修复(Fixed)
- 隧道空闲连接意外断开:修复了控制端隧道服务端因默认超时设置导致空闲连接被提前关闭的问题,确保连接池中的隧道在调度前保持可用。
- 多会话连接状态不一致:修复了 Agent 重连后旧连接未被及时清理可能导致的状态冲突问题,现在新会话建立时会主动驱逐旧连接。
📌 升级提醒(Notes)
- Docker Agent 升级路径:独立 Agent 镜像已迁移至
msmbox/msm-agent仓库,现有用户升级或重新安装时需使用新的镜像地址;控制端升级至 2.0.4 后建议核对 Agent 兼容性。 - TLS 证书挂载路径:手动运行 Docker Agent 时,请确保证书目录挂载路径与新生成的命令一致(默认指向当前目录的
tls/文件夹)。 - 版本号更新:本次发布版本号从 2.0.3 升级至 2.0.4,涵盖后端、前端及桌面端组件。
📋 构建信息
| 项目 | 内容 |
|---|---|
| 版本号 | beta-2.0.4 |
| 发布通道 | beta |
| 源仓库 | msm9527/msm |
| 构建分支 | dev 🌿 |
| 源提交 | b61a15d |
| 构建时间 | 2026-09-26 19:06:53 CST ⏰ |
🎯 最新提交详情
chore: bump MSM version to 2.0.4 / 升级 MSM 版本至 2.0.4
- 📅 时间: 2026-09-26 14:22:55 CST
- 🔗 链接: https://github.com/msm9527/msm/commit/b61a15dd3fcd5df17831dc1e62ba605f9473ea29
💾 下载安装
🖥️ 命令行版本(CLI)
Linux 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-beta-2.0.4-linux-amd64.tar.gz |
标准版本(推荐) |
| amd64-v3 | msm-beta-2.0.4-linux-amd64-v3.tar.gz |
优化版(需 AVX2) |
| amd64-musl | msm-beta-2.0.4-linux-amd64-musl.tar.gz |
Alpine Linux |
| amd64-musl-v3 | msm-beta-2.0.4-linux-amd64-musl-v3.tar.gz |
Alpine 优化版 |
| arm64 | msm-beta-2.0.4-linux-arm64.tar.gz |
ARM 64位 |
| arm64-musl | msm-beta-2.0.4-linux-arm64-musl.tar.gz |
ARM Alpine |
| armv7 | msm-beta-2.0.4-linux-armv7.tar.gz |
ARM 32位 (v7) |
| armv6 | msm-beta-2.0.4-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)
PanaBit / 派网
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-beta-2.0.4-linux-amd64-panabit.apx |
派网 x86_64 安装包 |
| arm64 | msm-beta-2.0.4-linux-arm64-panabit.apx |
派网 ARM64 安装包 |
说明:
.apx安装后会在派网页面中提供 MSM 控制入口- 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
- 如果派网设备已有服务占用目标端口,请先处理端口冲突
macOS 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-beta-2.0.4-darwin-amd64.tar.gz |
Intel 芯片 Mac |
| Apple Silicon | msm-beta-2.0.4-darwin-arm64.tar.gz |
M1/M2/M3 芯片 |
🖼️ 桌面应用版本(Desktop)
macOS 桌面应用
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-desktop-beta-2.0.4-darwin-amd64.dmg |
Intel 芯片 Mac |
| Apple Silicon | msm-desktop-beta-2.0.4-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.4/msm-beta-2.0.4-linux-amd64.tar.gz
# 解压
tar -xzf msm-beta-2.0.4-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.4
# 运行容器
docker run -d \
--name msm \
-p 7777:7777 \
-v /opt/msm:/opt/msm \
msmbox/msm:beta-2.0.4⚖️ 使用与合规
MSM 是用于管理用户自有或已获授权设备的自托管管理平台,不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。