Repository navigation
🚀 MSM beta-2.1.8（Beta 版）
Pre-release
Pre-release
·
11 commits
to main
since this release
📦 MSM beta-2.1.8
Beta 版每日自动构建 · 包含最新代码更新
✨ 本次更新
🎉 本次亮点（Highlights）
- 诊断日志一键收集：从日志窗口导出 MSM 与当前运行服务的脱敏日志，按服务合并打包，省去逐个查找和下载的步骤。
- MosDNS 升级保留用户选择：默认增量升级保留已修改的配置、开关和文件权限，自动恢复优先采用本地保存内容，避免旧快照覆盖较新的设置。
- 组网状态分清保存与生效：服务卡片区分当前运行配置和已保存设置，EasyTier 显示实际分配地址，并为尚未应用的修改提供提示。
- 日志与更新入口更顺手：顶栏新增日志快捷入口和管理员检查更新入口，适配网页、桌面端及移动端布局，快捷检查请求不会重复执行。
🆕 新增功能（Added）
- 一键导出当前诊断日志：日志窗口可将 MSM、运行或暂停中的受管服务日志导出为 ZIP，包括 MosDNS 当前原生日志和运行中的 WireGuard 接口日志。每个服务合并为一个日志文件，排除轮转历史与停止服务日志。
- 顶栏直达日志与更新检查：非访客用户可直接打开日志浮窗或移动端抽屉，重复点击不会创建多个日志窗口；管理员可跳转更新页并发起检查。网页与桌面端均按请求执行一次，忙碌时不额外并发检查。
✨ 功能增强（Changed）
- 小屏顶栏留出更多操作空间：收紧按钮间距，窄屏隐藏品牌文字及 Pro 主题按钮的文字和装饰图标；主题按钮补充可访问名称与悬停提示，保持紧凑布局下的可识别性。
🐛 问题修复（Fixed）
- MosDNS 增量升级保留已修改文件：保留用户改过的主配置、自定义配置、子配置及文件权限，更新未修改的模板文件；开关仅补缺失项。兼容修复不再强制开启 FakeIP 缓存，也不再将未知用户配置登记为可替换的默认模板。
- MosDNS 自动恢复优先采用本地设置：增量升级以本地文件中的开关、客户端代理模式、上游和 SOCKS5/ECS 设置为准；已有上游、全局覆盖、广告过滤源或分流源文件时，跳过对应旧快照回写，保留显式清空及 API 模型未覆盖的字段。缺少文件时仍可恢复旧快照。
- MosDNS 独立网络策略不被旧初始化值覆盖：已初始化实例在保留配置重装及自动维护时，保留 MosDNS 文件中的 IPv6 选择与 FakeIP 网段，不再回放过时的初始化设置；必要的 IPv6 占位保护仍会补齐。
- MosDNS 自定义写入参数跨版本保留：审计批量写入大小、刷新间隔及主缓存 WAL 同步间隔改为只补缺失值，不再因 MSM 构建或模板变化重置已有配置，保留用户自行调整的写入策略。
- 组网卡片展示实际运行值：WireGuard、EasyTier 和 Tailscale 的卡片改用运行地址和已应用端口，WireGuard/EasyTier 网段按运行地址计算，WireGuard 端口提示同步跟随。EasyTier 从当前本地实例读取地址，读取失败不沿用旧租约或固定偏好；Tailscale 未连接时显示“由控制服务器分配”。
- 组网待应用提示识别更多差异：EasyTier 对比当前配置、启动参数及程序，Tailscale 对比守护进程端口、程序和实际偏好，覆盖 DNS、路由、SSH、标签、出口节点等设置；路由顺序、等价 CIDR 和出口节点名称别名不会被误判为差异。
- EasyTier 自动分配不再被静态字段阻挡：开启 DHCP 后禁用固定地址和网段输入，但保留原值及编辑内容供关闭后恢复；未使用的静态字段不再阻止保存，高级配置模式也不再额外要求填写这些隐藏字段。
- EasyTier 静态网段与地址前缀一致：网段根据本机虚拟地址的 CIDR 前缀自动计算并只读展示，后台保存时同步规范化，避免单独填写的网段与核心实际使用的地址范围不一致。
- Tailscale 保存不再校验无关静态地址：跳过由控制服务器分配地址时不使用的静态地址、网段及包含关系校验，避免隐藏的旧值阻挡真实设置保存，包括 IPv6 地址场景。
- 已停止的 Tailscale 正确返回停止状态：受管守护进程不存在或已停止时，不再尝试通过不可用套接字采集状态，避免将明确停止的服务显示为采集不可用。
⚠️ 兼容性变更（Deprecated）
- 组网 API 分离保存值与运行值：
config.local_address保持保存值，不再被 Tailscale 实时地址替换。需要运行状态的集成应读取services[]下的runtime_local_address、runtime_listen_port、runtime_virtual_cidr，并结合settings_pending判断是否待应用；相应运行值不可用时字段可能省略。
📌 升级提醒（Notes）
- 诊断日志导出的范围与权限：新日志包沿用 viewer 及以上日志读取权限，逐行脱敏，仅包含日志，不附带配置、进程环境或元数据；响应禁止缓存。导出期间阻止重复操作并反馈结果，打包失败不会返回不完整 ZIP；额外服务状态探测失败会记入 MSM 日志，对应日志可能未被收集。
- MosDNS 配置保留适用范围：配置保留适用于默认增量升级及相应自动维护流程；全量、重置升级仍按所选模式使用模板。主动保存初始化设置、接受跨服务同步或恢复指定快照，仍会显式应用对应设置。
📋 构建信息
| 项目 | 内容 |
|---|---|
| 版本号 | beta-2.1.8 |
| 发布通道 | beta |
| 源仓库 | msm9527/msm |
| 构建分支 | dev 🌿 |
| 源提交 | 526692a |
| 构建时间 | 2026-10-29 08:04:51 CST ⏰ |
🎯 最新提交详情
feat(logs): 新增最新日志导出与更新入口并保护 MosDNS 配置 / Add current log export and update shortcuts; preserve MosDNS configuration
- 📅 时间: 2026-10-28 11:14:23 CST
- 🔗 链接: https://github.com/msm9527/msm/commit/526692a118e5873ee5f5e15f7a9cd20d833e13c6
💾 下载安装
🖥️ 命令行版本（CLI）
Linux 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-beta-2.1.8-linux-amd64.tar.gz |
标准版本（推荐） |
| amd64-v3 | msm-beta-2.1.8-linux-amd64-v3.tar.gz |
优化版（需 AVX2） |
| amd64-musl | msm-beta-2.1.8-linux-amd64-musl.tar.gz |
Alpine Linux |
| amd64-musl-v3 | msm-beta-2.1.8-linux-amd64-musl-v3.tar.gz |
Alpine 优化版 |
| arm64 | msm-beta-2.1.8-linux-arm64.tar.gz |
ARM 64位 |
| arm64-musl | msm-beta-2.1.8-linux-arm64-musl.tar.gz |
ARM Alpine |
| armv7 | msm-beta-2.1.8-linux-armv7.tar.gz |
ARM 32位 (v7) |
| armv6 | msm-beta-2.1.8-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.1.8-linux-amd64-panabit.apx |
派网 x86_64 安装包 |
| arm64 | msm-beta-2.1.8-linux-arm64-panabit.apx |
派网 ARM64 安装包 |
说明：
.apx安装后会在派网页面中提供 MSM 控制入口- 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
- 如果派网设备已有服务占用目标端口，请先处理端口冲突
macOS 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-beta-2.1.8-darwin-amd64.tar.gz |
Intel 芯片 Mac |
| Apple Silicon | msm-beta-2.1.8-darwin-arm64.tar.gz |
M1/M2/M3 芯片 |
🖼️ 桌面应用版本（Desktop）
macOS 桌面应用
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-desktop-beta-2.1.8-darwin-amd64.dmg |
Intel 芯片 Mac |
| Apple Silicon | msm-desktop-beta-2.1.8-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.1.8/msm-beta-2.1.8-linux-amd64.tar.gz
# 解压
tar -xzf msm-beta-2.1.8-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.1.8
# 运行容器
docker run -d \
--name msm \
-p 7777:7777 \
-v /opt/msm:/opt/msm \
msmbox/msm:beta-2.1.8⚖️ 使用与合规
MSM 是用于管理用户自有或已获授权设备的自托管管理平台，不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。
📚 文档与支持
🤖 由 GitHub Actions 自动构建
