Repository navigation
🚀 MSM beta-2.1.6（Beta 版）
Pre-release
Pre-release
·
18 commits
to main
since this release
📦 MSM beta-2.1.6
Beta 版每日自动构建 · 包含最新代码更新
✨ 本次更新
🎉 本次亮点（Highlights）
- 设备地址展示更清晰：名单中的同一设备若同时拥有 IPv4 和 IPv6 地址，会按规范化 MAC 地址合并为一项，并优先使用 IPv4 作为主地址，减少重复设备条目。
- 移除设备更完整：从白名单或黑名单移除合并后的设备时，会同时移除其主地址和关联地址；移除按钮也不会再误触发备注编辑。
- 过期地址不再混入在线清单：Linux 邻居缓存中的非新鲜 IPv4 地址不再直接视为当前设备；主动扫描确认的 IPv4 作为当前结果，降低历史 DHCP 地址造成误判的可能。
- IPv6 轮换时减少历史地址干扰：策略刷新会跟随当前邻居快照，设备仅呈现 IPv6 时最多保留一个最近使用的 IPv4 关联地址，不再恢复同一 MAC 下的全部历史 IPv4。
✨ 功能增强（Changed）
- 同设备 IPv4/IPv6 地址合并：名单客户端会按规范化后的 MAC 地址合并多个地址，保留关联地址、别名和备注等信息；合并结果优先使用 IPv4 作为主地址，没有有效主机名时使用 IPv4 展示。
- 移除操作覆盖关联地址：白名单和黑名单移除合并设备时，会从名单中一并删除该设备的主地址及其他关联地址，并自动保存更新后的名单。
- 移除按钮不再打开编辑界面：点击名单卡片中的移除按钮时，会阻止事件继续触发卡片编辑操作，避免移除设备的同时打开备注编辑。
🐛 问题修复（Fixed）
- 过滤过期的 IPv4 邻居缓存：Linux 邻居项处于非新鲜状态时不再作为有效 IPv4 客户端；主动扫描成功后，缓存中的 IPv4 也不会补回扫描未确认的地址，同时仍可使用 IPv6 邻居信息补充清单。
- 避免恢复整组历史 IPv4 地址：邻居刷新确认某个 MAC 仍存在、但当前没有 IPv4 时，仅保留该设备最近使用的一个可用 IPv4 作为策略关联锚点；链路本地 IPv6 只用于确认设备存在，不会作为展示地址。
- IPv6 地址轮换跟随当前邻居快照：策略刷新不再恢复当前快照中缺失的历史 IPv6 地址，设备更换 IPv6 隐私地址后，清单按最新观察到的地址更新。
- 修正邻居刷新后的扫描批次标记：每次邻居刷新都会更新客户端的最近扫描时间；仅由 ARP 发现的客户端也会记录当前扫描批次，使目录查询能够选择本次刷新结果。
📋 构建信息
| 项目 | 内容 |
|---|---|
| 版本号 | beta-2.1.6 |
| 发布通道 | beta |
| 源仓库 | msm9527/msm |
| 构建分支 | dev 🌿 |
| 源提交 | c234d3e |
| 构建时间 | 2026-10-25 12:00:13 CST ⏰ |
🎯 最新提交详情
升级版本至 2.1.6 / Bump version to 2.1.6
- 📅 时间: 2026-10-25 11:56:16 CST
- 🔗 链接: https://github.com/msm9527/msm/commit/c234d3ed0a572c1877512fe6fcfa1560f2aa1424
💾 下载安装
🖥️ 命令行版本（CLI）
Linux 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| amd64 | msm-beta-2.1.6-linux-amd64.tar.gz |
标准版本（推荐） |
| amd64-v3 | msm-beta-2.1.6-linux-amd64-v3.tar.gz |
优化版（需 AVX2） |
| amd64-musl | msm-beta-2.1.6-linux-amd64-musl.tar.gz |
Alpine Linux |
| amd64-musl-v3 | msm-beta-2.1.6-linux-amd64-musl-v3.tar.gz |
Alpine 优化版 |
| arm64 | msm-beta-2.1.6-linux-arm64.tar.gz |
ARM 64位 |
| arm64-musl | msm-beta-2.1.6-linux-arm64-musl.tar.gz |
ARM Alpine |
| armv7 | msm-beta-2.1.6-linux-armv7.tar.gz |
ARM 32位 (v7) |
| armv6 | msm-beta-2.1.6-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.6-linux-amd64-panabit.apx |
派网 x86_64 安装包 |
| arm64 | msm-beta-2.1.6-linux-arm64-panabit.apx |
派网 ARM64 安装包 |
说明：
.apx安装后会在派网页面中提供 MSM 控制入口- 实际管理界面由派网入口页跳转到 MSM 自身 Web 控制台
- 如果派网设备已有服务占用目标端口，请先处理端口冲突
macOS 平台
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-beta-2.1.6-darwin-amd64.tar.gz |
Intel 芯片 Mac |
| Apple Silicon | msm-beta-2.1.6-darwin-arm64.tar.gz |
M1/M2/M3 芯片 |
🖼️ 桌面应用版本（Desktop）
macOS 桌面应用
| 架构 | 文件 | 说明 |
|---|---|---|
| Intel | msm-desktop-beta-2.1.6-darwin-amd64.dmg |
Intel 芯片 Mac |
| Apple Silicon | msm-desktop-beta-2.1.6-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.6/msm-beta-2.1.6-linux-amd64.tar.gz
# 解压
tar -xzf msm-beta-2.1.6-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.6
# 运行容器
docker run -d \
--name msm \
-p 7777:7777 \
-v /opt/msm:/opt/msm \
msmbox/msm:beta-2.1.6⚖️ 使用与合规
MSM 是用于管理用户自有或已获授权设备的自托管管理平台，不提供代理节点、订阅或违法内容。请勿用于未授权访问、侵权或其他违法活动。
📚 文档与支持
🤖 由 GitHub Actions 自动构建
