Repository navigation
🚀 MSM beta-2.2.0（Beta 版）
Pre-release
Pre-release
📦 MSM beta-2.2.0
Beta 版每日自动构建 · 包含最新代码更新
✨ 本次更新
🎉 本次亮点（Highlights）
- 三套仪表盘按需切换：经典、简约与霓虹三种布局共享实时数据，分别侧重可拖拽管理、状态概览和可视化监控，用户可按工作习惯选择展示方式。
- 导航与外观集中重构：侧边栏、图标栏和顶部导航均可选择，模块内统一使用标签切换；主题、圆角、玻璃材质、背景与效果质量集中到“界面外观”。
- 域名服务流程更清晰：域名与证书工作台提供概览引导、服务卡片、待处理事项和网关状态；DDNS、发布服务和证书入口按任务重新组织，减少查找和配置成本。
- 自建私网安装过程可见：EasyTier、Tailscale 等组件安装改为后台任务，界面显示当前阶段、下载进度和实时日志，失败后仍可查看安装记录。
- Sing-Box 代理组图标可保存：内置模板组可显示对应图标，自定义图标按配置单独保存，并在代理控制器与编辑器中保持一致。
🎉 重磅功能（Major）
- 三套独立仪表盘布局：经典风格保留可拖拽卡片网格；简约风格提供时钟、活动环、服务卡片和设备信息；霓虹风格提供环形仪表、服务矩阵、网络曲线和终端读数。风格选择器同步更新为布局缩略图。
- 悬浮外壳与可配置界面外观：侧栏、顶栏和移动底栏改为悬浮圆角表面；新增导航布局、主题模式、主题色、圆角、玻璃材质、透明度、模糊度、效果质量、背景场景和高光强度等设置，并支持随账号同步。
- 模块化导航与简洁模式：导航按常用、扩展功能和管理组织为模块，模块内页面统一通过顶部标签切换；简洁模式默认隐藏配置文件、运行日志、Docker 事件等专业入口，开启高级功能后可显示，已有路由和深链接仍可访问。
🆕 新增功能（Added）
- Clone Fan Clash 配置模板：新增包含订阅提供商、地区策略组、延迟测试、故障转移、负载均衡、规则集及常见服务分流规则的 Clash 配置模板。
- 域名服务概览工作台：域名与证书模块新增服务商账号、动态域名解析、发布服务的引导流程，并提供已发布服务卡片、待处理事项和网关状态；证书列表可显示剩余天数，空状态提供申请或导入入口。
- 后台网络组件安装任务：新增安装任务的启动和状态查询能力，前端可跟踪准备、发布、下载、打包等阶段，以及下载进度、实时日志和失败信息。
- macOS 物理网卡识别：macOS 可通过系统硬件端口和接口状态识别物理网卡、连接状态及协商速率，并过滤网桥、Thunderbolt 网络和本地管理地址对应的虚拟网卡。
✨ 功能增强（Changed）
- DDNS 向导按域名优先配置：域名字段移到主要位置，已有服务商账号以卡片选择并默认选中；选择新账号时才显示令牌字段，记录类型、TTL 和公网地址来源收纳到更多设置，任务名称可根据域名生成。
- 发布服务向导改为分步操作：发布流程使用带编号、说明和完成状态的步骤条；窄屏下隐藏过长的步骤提示，保留紧凑的步骤标识。
- 仪表盘告警更聚焦：系统正常时隐藏“需要关注”面板；出现问题时按严重程度列出具体事项，并提供前往诊断或任务中心的入口。暂时隐藏后，问题发生变化时会再次提示。
- 玻璃界面覆盖范围扩大：内容卡片、抽屉、弹窗、顶栏菜单、用户菜单和移动底栏统一使用玻璃材质；新增极光、柔光和纯色背景场景，高质量模式下极光可缓慢流动，并遵循减少透明度和减少动态效果设置。
- 经典仪表盘布局重新调整：不同屏幕尺寸使用更宽松的卡片行高与间距，标题、图标块、分隔线、进度条、标签和拖拽手柄的视觉层次同步调整。
- 域名与证书界面用语简化：将“凭据”“上游”“权威 DNS”等术语改为“服务商账号”“目标服务”“域名服务器”等更直观的表达，并同步调整检查状态、表单提示和操作名称。
- 设置与代理编辑器层次统一：页面标题改为无边框标题行，内容卡片统一使用顶部高光和柔和阴影；代理编辑器的策略组、规则、规则集、节点和配置标签改为统一的多语言样式，并显示相关数量。
- 设置项标题支持换行：设置卡片不再让宽控件挤压标题，时区、令牌有效期等设置项在空间不足时仍能显示完整标题。
- 外观设置入口集中：设置页改为显示界面外观摘要和入口，主题模式与语言不再重复出现在多个位置；菜单顺序恢复按钮文案同步调整。
- 仪表盘图表与服务视觉更新：图表改用单调平滑曲线；简约风格加入大号时钟、活动环和应用图标式服务卡片，霓虹风格加入发光负载核心、流量曲线和霓虹状态模块。
🐛 问题修复（Fixed）
- macOS 桌面版反向代理缓存目录校验异常：桌面版以 root 运行且配置目录位于普通用户主目录时，不再继承该用户的
XDG_DATA_HOME，而是使用 root 自己的运行时缓存目录，避免因缓存目录归属检查失败而无法启动。 - 组件未安装时无法保存自建私网配置：保存配置不再因组件尚未安装而提前失败，“保存并应用”可以继续进入安装和启动流程。
- EasyTier 在 macOS root 环境下误报 TUN 不可用：以 root 运行时允许使用 macOS 的
utun设备；自定义设备名仍需符合 macOS 支持的utunN形式。 - 复用已有网络程序时路径未保存：复用 Homebrew 等来源的 EasyTier 或 Tailscale 时写回实际程序路径，避免后续启动仍提示组件未安装。
- WireGuard 残留接口影响重启恢复：Darwin 接口映射对应的 socket 不存在时按已停止处理，MSM 重启后可重新恢复接口。
- Sing-Box 代理组图标在保存后丢失：Sing-Box 原生配置没有图标字段时，MSM 管理的图标不再随编辑器保存丢失；代理控制器和编辑器会补回已保存或模板提供的图标。
- macOS 物理网卡列表为空：修复仅依赖 Linux 网卡目录导致 macOS 始终显示未检测到物理网卡的问题。
- 域名服务工作台状态展示不一致：概览、DDNS、证书和发布服务页面重新整理数据展示与入口，证书剩余天数、失败事项和网关状态可在对应工作区查看。
⚠️ 兼容性变更（Deprecated）
- 导航入口位置调整：Docker、域名与证书、远程访问和网络工具等功能改为在模块内通过顶部标签切换；移动端底栏固定为首页、DNS、代理、系统和“更多”，扩展模块位于“更多”。
- 专业页面默认隐藏：配置文件、运行日志、Docker 事件等页面在简洁模式下不显示为标签，但原有地址和深链接仍可访问；需要时请开启高级功能。
- 域名与证书模块名称更新：模块入口及标签改用“域名与证书”“反向代理”“动态域名解析”等更明确的名称，相关页面位置随模块化导航调整。
📌 升级提醒（Notes）
- 网络组件安装改为后台任务：安装期间请在对应任务进度中查看阶段、下载进度和日志；安装失败时日志会保留，便于继续定位问题。
📋 构建信息
| 项目 | 内容 |
|---|---|
| 版本号 | beta-2.2.0 |
| 发布通道 | beta |
| 源仓库 | msm9527/msm |
| 构建分支 | dev 🌿 |
| 源提交 | 5b81b62 |
| 构建时间 | 2026-11-05 22:42:13 CST ⏰ |
🎯 最新提交详情
发布 MSM 2.2.0 并加入 Clone Fan 配置 / Release MSM 2.2.0 and add Clone Fan config
- 📅 时间: 2026-11-05 16:44:02 CST
- 🔗 链接: https://github.com/msm9527/msm/commit/5b81b629dd690fea01a2b36afa7da6e6dc15ab98
💾 下载安装
🖥️ 命令行版本（CLI）
Linux 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-beta-2.2.0-linux-amd64.tar.gz |
标准版本（推荐） |
| amd64-v3 | msm-beta-2.2.0-linux-amd64-v3.tar.gz |
优化版（需 AVX2） |
| amd64-musl | msm-beta-2.2.0-linux-amd64-musl.tar.gz |
Alpine Linux |
| amd64-musl-v3 | msm-beta-2.2.0-linux-amd64-musl-v3.tar.gz |
Alpine 优化版 |
| arm64 | msm-beta-2.2.0-linux-arm64.tar.gz |
ARM 64位 |
| arm64-musl | msm-beta-2.2.0-linux-arm64-musl.tar.gz |
ARM Alpine |
| armv7 | msm-beta-2.2.0-linux-armv7.tar.gz |
ARM 32位 (v7) |
| armv6 | msm-beta-2.2.0-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.2.0-linux-amd64-panabit.apx |
派网 x86_64 安装包 |
| arm64 | msm-beta-2.2.0-linux-arm64-panabit.apx |
派网 ARM64 安装包 |
说明：
.apx安装后会在派网页面中提供 MSM 控制入口- 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
- 如果派网设备已有服务占用目标端口，请先处理端口冲突
macOS 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-beta-2.2.0-darwin-amd64.tar.gz |
Intel 芯片 Mac |
| Apple Silicon | msm-beta-2.2.0-darwin-arm64.tar.gz |
M1/M2/M3 芯片 |
🖼️ 桌面应用版本（Desktop）
macOS 桌面应用
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-desktop-beta-2.2.0-darwin-amd64.dmg |
Intel 芯片 Mac |
| Apple Silicon | msm-desktop-beta-2.2.0-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.2.0/msm-beta-2.2.0-linux-amd64.tar.gz
# 解压
tar -xzf msm-beta-2.2.0-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.2.0
# 运行容器
docker run -d \
--name msm \
-p 7777:7777 \
-v /opt/msm:/opt/msm \
msmbox/msm:beta-2.2.0⚖️ 使用与合规
MSM 是用于管理用户自有或已获授权设备的自托管管理平台，不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。
📚 文档与支持
🤖 由 GitHub Actions 自动构建
