Repository navigation
🚀 MSM 2.0.4(稳定版)
✨ 本次更新
🎉 本次亮点(Highlights)
- Agent 镜像独立发布:Docker Agent 镜像迁移至独立仓库
msmbox/msm-agent,安装命令默认拉取latest标签,不再强制绑定 MSM 主程序具体版本号,简化节点升级与版本匹配流程。 - 隧道会话自动刷新:节点重连时引入唯一会话 ID 校验,新连接建立后自动关闭旧的空闲连接,避免 stale 状态导致通信异常,提升长连接稳定性。
- 安装路径配置简化:Docker 运行示例中的 TLS 证书卷挂载路径统一调整为当前目录的
./tls,减少手动修改绝对路径时的配置错误。
✨ 功能增强(Changed)
- 隧道握手协议增强:建立反向隧道时增加
X-Msm-Agent-Session请求头,控制端会对会话 ID 进行 UUID 格式校验,无效会话将被拒绝连接。 - 连接池容量管理:当单个节点的活跃连接数达到上限时,系统会自动驱逐最早的空闲连接以接纳新请求,防止资源耗尽。
- 文档构建流程更新:正式版与 Beta 版构建推送逻辑移至 wiki 仓库,源码仓库不再直接执行 Docker 镜像发布任务,明确分工边界。
🐛 问题修复(Fixed)
- 旧连接清理机制:修复了节点会话切换时旧连接可能未被及时关闭的问题,现在检测到新会话 ID 后会立即终止同一节点下的旧连接并释放资源。
- 测试用例超时调整:延长了端到端测试中拉取镜像和容器启动的等待超时时间,避免因网络波动导致的偶发性测试失败。
⚠️ 兼容性变更(Deprecated)
- 旧镜像标签停止更新:正式 Docker Agent 镜像已移至
msmbox/msm-agent仓库,旧版msmbox/msm:agent-*标签不再更新,手动脚本需调整拉取源。 - 安装命令参数变化:生成的 Docker run 命令中 TLS 挂载参数由
/path/to/agent-tls变更为$PWD/tls,旧版自动化脚本可能需要适配。
📌 升级提醒(Notes)
- 镜像仓库迁移:请检查现有的节点部署脚本,将镜像来源从
msmbox/msm:agent-<version>更新为msmbox/msm-agent:latest或指定新版本标签。 - TLS 目录准备:使用独立安装命令时,需确保
agent.crt与agent.key已放入当前执行目录下的tls/文件夹中。
📋 构建信息
| 项目 | 内容 |
|---|---|
| 版本号 | 2.0.4 |
| 发布通道 | stable |
| 源仓库 | msm9527/msm |
| 构建分支 | main 🌿 |
| 源提交 | 85d32a0 |
| 构建时间 | 2026-09-26 15:26:17 CST ⏰ |
🎯 最新提交详情
merge: promote MSM 2.0.4 from dev / 合并 dev 发布 MSM 2.0.4
- 📅 时间: 2026-09-26 14:23:57 CST
- 🔗 链接: https://github.com/msm9527/msm/commit/85d32a0c9e4fc7e71ebaa770e409bd2da033fdbf
💾 下载安装
🖥️ 命令行版本(CLI)
Linux 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-2.0.4-linux-amd64.tar.gz |
标准版本(推荐) |
| amd64-v3 | msm-2.0.4-linux-amd64-v3.tar.gz |
优化版(需 AVX2) |
| amd64-musl | msm-2.0.4-linux-amd64-musl.tar.gz |
Alpine Linux |
| amd64-musl-v3 | msm-2.0.4-linux-amd64-musl-v3.tar.gz |
Alpine 优化版 |
| arm64 | msm-2.0.4-linux-arm64.tar.gz |
ARM 64位 |
| arm64-musl | msm-2.0.4-linux-arm64-musl.tar.gz |
ARM Alpine |
| armv7 | msm-2.0.4-linux-armv7.tar.gz |
ARM 32位 (v7) |
| armv6 | msm-2.0.4-linux-armv6.tar.gz |
ARM 32位 (v6) |
💡 提示: amd64-v3 版本针对较新的 CPU 进行了优化(需要支持 AVX、AVX2 等指令集),性能更好但兼容性较低。如果不确定,请使用标准的 amd64 版本。
🧩 派网应用版本(APX)
PanaBit / 派网
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-2.0.4-linux-amd64-panabit.apx |
派网 x86_64 安装包 |
| arm64 | msm-2.0.4-linux-arm64-panabit.apx |
派网 ARM64 安装包 |
说明:
.apx安装后会在派网页面中提供 MSM 控制入口- 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
- 如果派网设备已有服务占用目标端口,请先处理端口冲突
macOS 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-2.0.4-darwin-amd64.tar.gz |
Intel 芯片 Mac |
| Apple Silicon | msm-2.0.4-darwin-arm64.tar.gz |
M1/M2/M3 芯片 |
🖼️ 桌面应用版本(Desktop)
macOS 桌面应用
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-desktop-2.0.4-darwin-amd64.dmg |
Intel 芯片 Mac |
| Apple Silicon | msm-desktop-2.0.4-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.4/msm-2.0.4-linux-amd64.tar.gz
# 解压
tar -xzf msm-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:2.0.4
# 运行容器
docker run -d \
--name msm \
-p 7777:7777 \
-v /opt/msm:/opt/msm \
msmbox/msm:2.0.4⚖️ 使用与合规
MSM 是用于管理用户自有或已获授权设备的自托管管理平台,不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。