Repository navigation
Releases: mmwx-group/mmwx-agent
Releases · mmwx-group/mmwx-agent
Release list
v1.1.3
v1.1.2
v1.1.2
修复
- 系统 DNS 配置有误时节点测活超时 / TLS 握手错误:服务器的
/etc/resolv.conf里 nameserver 不通或很慢时,内嵌 Xray 的每条连接都会卡在域名解析上。现在启动 Xray 前会先试着解析几个常见域名:解析正常则不做任何改动;不正常、且你没有自己配置过dns时,本次运行改用公共 DNS(不写回配置文件),并在日志里提示检查/etc/resolv.conf。
文档与部署示例
- Docker 部署需要
NET_ADMIN权限:转发链的内核转发引擎、反向隧道、客户端 IP 白名单都依赖它。docker-compose.yml与 README 的示例已默认带上;已有的 Docker 部署请加--cap-add NET_ADMIN(compose 里是cap_add: [NET_ADMIN])后重建容器,不需要privileged。
升级方式:在主控「服务管理」里对服务器点升级即可。
v1.1.1
v1.1.1
新增
- 转发链「连接保持」改为整条链的开关:同一个客户端 IP 在每一跳都落到同一台服务器,各组的权重与故障转移照常生效。需要主控 v0.5.6-beta.10 及以上,且链上每台 Agent 都升级到本版本。
修复
- 只修改连接保持相关设置时,运行中的转发规则没有随之更新。
- Docker 部署的 Agent 缺少 NET_ADMIN 权限时,内核转发的提示改为明确说明「给容器加
--cap-add NET_ADMIN后重建即可」,不再让人去重装 nftables 或开 privileged(#1174)。
v1.1.0
⚠️ Miu 协议升级到第二版,与第一版线上格式不兼容。 用到 Miu 节点的话,主控(v0.5.6-beta.8)、Agent(v1.1.0)、客户端 / 测速内核(mihomo-miu-v2-*)须一起升级;只升其中一边,Miu 节点会连不上。不用 Miu 的不受影响。
更新日志
v1.1.0 (2026-10-10)
- 🌈 主控提示许可证功能变化时立即续租一次:心跳确认里的功能清单指纹与上次续租成功时不同(含进程启动后第一次收到)就把续租提到现在,不用等租约自己的周期(20 小时租约下是 6 小时 40 分);两次提示续租至少间隔 2 分钟,失败时退回原定时间、不进入每 30 秒一次的重试。另:响应体没读完也能复用连接
- 🌈 续租许可证的连接改为复用,并缓存域名解析 20 小时 —— 从前每次续租都新建连接、重新解析(空闲连接 90 秒就关,续租间隔又恰好等于域名 TTL),全网几千台 agent 的查询全数落到按查询计费的负载均衡 DNS 上。现在空闲连接保留 10 分钟、带 TCP 保活;解析结果缓存 20 小时,缓存的地址连不上时立即重新解析,解析失败时沿用旧地址
- 🛠️ Miu 第二版的构建依赖补齐:fork xray 钉到 22eec79c(第二版入站用到的 session.SpliceFramer 在这个提交才有,原来钉的 b3e3632c 会编译不过);third_party/MIU_SOURCE 的来源提交更新为 018644c
- 🌈 third_party/miu 同步到 Miu 第二版(通道池 + 原样转发;与第一版线上格式不兼容,三端客户端须同步升级)
升级方式
在主控「服务管理」中对目标服务器点击「Agent 管理 → 升级 Agent」，或重新运行安装脚本。
二进制（linux/darwin × amd64/arm64）由 GitHub Action 自动编译并上传到本 Release。
v1.0.0
更新日志
v1.0.0 (2026-10-08)
- 🌈 反向隧道:目标服务器在 NAT 后面、入口服务器连不进去时,由目标主动拨一条 WireGuard 隧道到入口,两台各多一个内网地址;入口上的端口转发 / 链式转发把目标写成内网地址即可。隧道配置落盘,Agent 重启后自行恢复。需要主控 v0.5.6-beta.6 及以上,在「节点管理 → Tunnel 管理 → 反向隧道」里使用
- 🌈 升级可以由主控指定版本:今后 Agent 的预发布版不上 CDN、也不会成为「最新版本」,只有预发布版的主控会把它当作升级目标;版本号格式不对或比当前版本旧的升级请求一律拒绝。正式版主控的升级行为不变
- 🛠️ 转发探测把 SYN 重传算作丢包:丢一个包的那一轮原先显示「延迟翻倍、抖动 400ms、丢包 0%」,现在重传的样本不进延迟与抖动、计入丢包
升级方式
在主控「服务管理」中对目标服务器点击「Agent 管理 → 升级 Agent」,或重新运行安装脚本。
二进制(linux/darwin × amd64/arm64)由 GitHub Action 自动编译并上传到本 Release。
v1.0.0-beta.1
更新日志
v1.0.0-beta.1 (2026-10-08)
这是 Agent 的第一个预发布版,配合主控 v0.5.6-beta.6 使用。
- 🌈 反向隧道:目标服务器在 NAT 后面、入口服务器连不进去时,由目标主动拨一条 WireGuard 隧道到入口,两台各多一个内网地址;入口上的端口转发 / 链式转发把目标写成内网地址即可。隧道配置落盘,Agent 重启后自行恢复。在主控「节点管理 → Tunnel 管理 → 反向隧道」里使用
- 🌈 升级可以由主控指定版本:预发布版不上 CDN、也不会成为「最新版本」,只有预发布版的主控会把它当作升级目标;版本号格式不对或比当前版本旧的请求一律拒绝
- 🛠️ 转发探测把 SYN 重传算作丢包:丢一个包的那一轮原先显示「延迟翻倍、抖动 400ms、丢包 0%」,现在重传的样本不进延迟与抖动、计入丢包
升级方式
这是预发布版,不会成为「最新版本」,正式版主控看不到它。
- 已经是 v1.0.0-beta.1 及以后的 Agent:在预发布版主控的「服务管理 → Agent 管理 → 升级 Agent」里直接升级
- v0.9.9 及更早的 Agent:它们的升级只会取最新正式版,从面板升不到预发布版,需要在服务器上执行一次(下载、用现有 Agent 验签、替换并重启):
V=v1.0.0-beta.1; A=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/'); U=https://github.com/mmwx-group/mmwx-agent/releases/download/$V/mmw-agent-linux-$A; B=$(command -v mmw-agent || echo /usr/local/bin/mmw-agent); curl -fsSL -o /tmp/mmw-agent.new "$U" && curl -fsSL -o /tmp/mmw-agent.new.sig "$U.sig" && "$B" __verify-update /tmp/mmw-agent.new /tmp/mmw-agent.new.sig && install -m 0755 /tmp/mmw-agent.new "$B" && rm -f /tmp/mmw-agent.new /tmp/mmw-agent.new.sig && systemctl restart mmw-agent二进制(linux/darwin × amd64/arm64)由 GitHub Action 自动编译并上传到本 Release。
v0.9.9
更新日志
v0.9.9 (2026-10-07)
- 🌈 内嵌 xray 支持 Miu 协议入站(需主控 v0.5.6-beta.5 及以上;外置 xray 不支持)
- 🌈 仅监控模式(
xray_mode: none):agent 只上报在线状态 / 网卡流量 / 网速 / 系统指标 / 延迟探测,不安装、不探测、不改动、不启停 Xray —— 本机已有的 Xray 原样不动。主控添加服务器时打开「仅监控」即可(需主控 v0.5.6-beta.5 及以上);Docker 部署用MMWX_XRAY_MODE=none - 🌈 macOS:外置模式按仅监控运行(mac 上装不了外置 Xray);补上网卡流量与实时网速,此前恒为 0
- 🛠️ fix: 走 UDP 的转发链(Hysteria2 等)连接数恒为 0 —— 上报的连接数与来源 IP 改为 TCP 连接 + UDP 会话
- 🛠️ fix: 选了内核引擎(iptables / nftables)的转发链连接数恒为 0 —— 内核规则生效时按连接跟踪计数
- 🛠️ fix: 面板实时网速在短时间测速时明显偏低(下载 100MB/s 显示 36MB/s)—— 突发流量不再被摊到整个 15 秒窗口
升级方式
在主控「服务管理」中对目标服务器点击「Agent 管理 → 升级 Agent」，或重新运行安装脚本。
二进制（linux/darwin × amd64/arm64）由 GitHub Action 自动编译并上传到本 Release。
v0.9.8
更新日志
v0.9.8 (2026-10-05)
- 🛠️ fix: 服务器封了 443 出站时下载不到 geoip.dat / geosite.dat,内嵌 xray 起不来(默认路由的 geoip:private 加载失败)—— 改为依次:先复制本机已有的(外置 xray 放在 /usr/local/share/xray 等目录,支持 XRAY_LOCATION_ASSET);再试镜像,连接 5 秒不通就换下一个(从前每个镜像白等 30 秒,两个文件最多卡 3 分钟),并显式走 HTTPS_PROXY 等代理环境变量;镜像全不通时从主控(含备用主控)的 /api/remote/geodata 下载
- 🛠️ fix: 转发链从 nftables 切到 iptables 时,nft 那一段的转发流量被重复计一次 —— 两个后端共用同一份「上次读数」,sync 先重建 iptables 时忘掉了这条规则的读数,随后拆旧 nft 表前收尾巴,就把旧表里的整段累计当成新增量再加一次(测试环境实测重复计入一整段,计费随之多算);上次读数改为按后端分开记,补单测
升级方式
在主控「服务管理」中对目标服务器点击「Agent 管理 → 升级 Agent」，或重新运行安装脚本。
二进制（linux/darwin × amd64/arm64）由 GitHub Action 自动编译并上传到本 Release。
v0.9.7
更新日志
v0.9.7 (2026-10-04)
- 🌈 CI 固定的 xray fork 升到 9e60e20:mieru 入站支持 socks5 UDP ASSOCIATE、低熵段、密钥缓存、防重放与随机填充
- 🌈 转发规则支持透传客户端真实 IP:send_proxy_protocol 的入口 relay 连上游后先写 PROXY v2 头(只写一次,之后照常 splice),这类规则不走内核转发;握手声明 forward_proxy_protocol 与 xray_trusted_proxy_protocol(内嵌 xray 认出口入站的 trustedProxyProtocolSources);CI 固定的 xray fork 升到 12696ee
- 🌈 转发规则新增 priority 策略(按上游顺序,第一个健康的主用、其余备用),握手声明 forward_priority —— 主控的选路段 / 最低延迟优先据此下发主备;内核转发只 DNAT 到主用,主控按延迟换主用时旧主用的在途连接保留(放行、计数照旧),不再清连接跟踪
升级方式
在主控「服务管理」中对目标服务器点击「Agent 管理 → 升级 Agent」，或重新运行安装脚本。
二进制（linux/darwin × amd64/arm64）由 GitHub Action 自动编译并上传到本 Release。