§ 记录 · 版本
八个版本、四条影响安装的变更线;需要回退时只认两个锚点:3.6.9 面向 4.4 内核路由器,3.5.2 面向 Windows 8.1 与 macOS 11,两者安装包均不再重签,回退一次平均耗时 14 分钟。
§ 01 · 版本号
本站只记录会影响安装的变更。判断一次升级要不要做,看的是三件事:是否需要重下安装包、是否改变端口与路径、是否改变最低系统要求。

| 段位 | 含义 | 是否需重下安装包 | 是否可能改变配置 |
|---|---|---|---|
| 主版本(3.x) | 架构或依赖大改 | 需要 | 可能改变路径与端口 |
| 次版本(x.9) | 功能新增或驱动变更 | 需要 | 可能改变驱动或扩展 |
| 修订号(x.x.6) | 缺陷修复 | 需要(包已重签) | 一般不变 |
| 构建后缀 | 同一版本的重新签发 | 需要 | 不变 |
只要安装包重新签发,哈希就一定变化。即使用户看到的界面没有区别,手里那份旧包的哈希也与清单不符。因此“版本号变了”与“安装包变了”在实践中等价,校验动作必须重做一次。
§ 02 · 变更总表
下表按时间倒序排列,日期按 +08:00 记录。摘要只写影响安装与连接的部分,界面微调不入表。
| 版本 | 发布日期 | 性质 | 影响安装与连接的变更 |
|---|---|---|---|
| 3.9.6 | 2026-11-06 | 稳定版 | 修复 macOS 15.2 下 TUN 首次启动失败,Windows 安装器补上签名时间戳,新增 aarch64 通用 ipk。 |
| 3.9.2 | 2026-10-15 | 稳定版 | 默认监听端口由 7890 改为 17890,避开开发工具占用;安装包改用固实压缩,体积下降 9.8%。 |
| 3.8.7 | 2026-09-24 | 稳定版 | 修复 OpenWrt fw4 下转发规则未生效的问题;路由器端加入旁路由自动检测,减少手填网关出错。 |
| 3.8.0 | 2026-08-28 | 功能版 | 客户端内新增安装自检面板,可一键导出诊断文本;Windows 虚拟网卡由 TAP 迁移到 Wintun 0.14。 |
| 3.7.4 | 2026-07-31 | 稳定版 | macOS 改为 Universal 2 单包,安装体积合并;最低系统要求抬到 12.6,不再提供 11.x 构建。 |
| 3.6.9 | 2026-07-02 | 保底版 | 回退保底版本:3.9.x 引入的 DNS 分流在 4.4 内核上会崩溃,官方保留此版作为路由器回退目标。 |
| 3.6.0 | 2026-06-11 | 功能版 | 首次提供 mipsel_24kc 架构 ipk;LuCI 插件与核心包拆分为两个文件,插件不再强依赖核心版本号。 |
| 3.5.2 | 2026-05-19 | 归档版 | 最后支持 Windows 8.1 与 macOS 11 的版本;此后的安装器不再包含这两套系统的运行库。 |
更早的版本对当前安装已无参考价值:3.5 之前不提供 macOS 与 OpenWrt 构建,安装路径也与现在不同。保留八条覆盖了从主流版本到回退锚点的全过程,既能查到当前版本,也能查到需要回退时该退到哪一版。
§ 03 · 对安装的影响
变更记录的价值在于回答“我这一版要不要动”。下面把八条记录拆成四类影响,按类看比按版本看更快。
3.9.2 把默认监听端口从 7890 迁到 17890,并在 17891 提供局域网入站、17893 提供本地 DNS 接管。仍在按 7890 排查端口冲突的人,会得到“端口空闲但连不上”的错误结论。迁移后的端口无需手动配置,除非与既有软件冲突。
3.8.0 把 Windows 虚拟网卡从 TAP 迁移到 Wintun 0.14,升级后需要重新授权一次驱动;3.9.6 修复了 macOS 15.2 下扩展首次启动失败的问题,此前在 15.x 上首次连接会失败一次、重启客户端后正常。
3.7.4 把 macOS 最低版本抬到 12.6,同时取消 Apple 芯片与 Intel 的分包,改为 Universal 2 单包;3.5.2 是最后支持 Windows 8.1 与 macOS 11 的版本,此后的安装器不再包含这两套系统的运行库。
3.6.0 首次提供 mipsel_24kc 架构 ipk,并把 LuCI 插件与核心包拆成两个文件;3.8.7 修复 fw4 下转发规则未生效的问题,并加入旁路由自动检测;3.6.9 是针对 4.4 内核的保底版本。


§ 03b · 逐版本要点
同样的变更对不同人意义不同。下面逐条给判断要点,按“该升、可不升、别升”三种结论写,方便对号入座。
该升:macOS 15.x 用户,此前的扩展首次启动失败问题在这一版修复;需要 aarch64 通用 ipk 的路由器也在此版首次拿到对应包。可不升:Windows 10 19045 上运行 3.9.2 且无异常的机器,升级收益仅在签名时间戳。
该升:曾与开发工具争用 7890 端口的人,此版把默认端口迁到 17890 起的三件套。别升:脚本里硬编码了 7890 的自动化环境,升级后需同步改脚本,否则自动化链路会断。
该升:OpenWrt 22.03 与 23.05 用户,fw4 下转发规则失效的问题在这一版修复。可不升:21.02 且未升级防火墙的设备,旧的 fw3 规则仍可用,升级反而要改规则写法。
该升:需要客户端内自检面板的人。注意:此版把 Windows 虚拟网卡从 TAP 迁到 Wintun,升级后必须重新授权驱动一次,未授权的表现是网卡不出现而不是报错。
该升:Apple 芯片用户,此版合并为 Universal 2 单包,不再需要区分架构。别升:macOS 11.x 用户,此版把最低系统抬到 12.6,装不上去。
该留:4.4 内核的旧路由器,这是官方保留的回退锚点,包不再重签,哈希稳定。别升:已在 5.4 内核及以上运行的设备,回退只为应急,长期应升级固件。
该升:MT7621 平台路由器,首次拿到 mipsel_24kc 架构的 ipk。注意:此版起 LuCI 插件与核心包拆开,两者版本号必须一致,混用会出现界面能开但选项不生效。
该留:Windows 8.1 与 macOS 11 的最后可用版本。别升:其他系统上没有任何理由停在 3.5.x,该版本已停止更新,也不再包含新系统的运行库。

§ 04 · 平台矩阵
并不是所有历史版本都能装在当前系统上。下表的“可装”指安装器能完成安装,“可用”指首次连接成功。
| 版本 | Windows 10 / 11 | macOS 12.6+ | OpenWrt 21.02+ |
|---|---|---|---|
| 3.9.6 | 可装可用 | 可装可用 | 可装可用 |
| 3.9.2 | 可装可用 | 可装可用(15.2 需重启一次) | 可装可用 |
| 3.8.7 | 可装可用 | 可装可用 | 可装可用(fw4 修复) |
| 3.8.0 | 可装可用 | 可装可用 | 可装可用 |
| 3.7.4 | 可装可用 | 可装可用 | 可装可用 |
| 3.6.9 | 可装可用 | 可装可用 | 可装可用(保底版) |
| 3.6.0 | 可装可用 | 可装可用 | 可装(需同版插件) |
| 3.5.2 | 可装可用(含 Win 8.1) | 可装可用(含 11.x) | 不可用 |
矩阵里的“可装可用”都是在全新安装条件下验证的。升级安装时还要看残留:从 3.7.4 之前的版本直接升到 3.9.6 而不卸载,可能保留旧的 TAP 适配器,导致两条默认路由并存。

§ 05 · 回退方法
回退不是降级安装。直接覆盖安装旧版会留下两份服务,抢同一个端口,表现比升级前更糟。
分流规则与自定节点清单导出为文本,回退后重新导入,不要整目录拷贝。
按各平台安装页的卸载清单执行,确认端口已释放、适配器已删除。
安装前先算 SHA-256,与当年清单比对;不合格的旧包宁可不用。
网卡或扩展、端口监听、默认路由三项依次确认,再谈连接速度。
回退后的三项确认
Windows:> Get-NetAdapter | ? InterfaceDescription -like *Wintun*
macOS:$ systemextensionsctl list | grep -i kuaimiao
OpenWrt:# netstat -lntp | grep 17890
三项任一为空,说明回退未完成,不要继续测试连接
§ 06 · 回退后
回退完成后的第一小时最关键:这段时间内的日志能说明回退是否真的解决了问题,还是只改变了症状。
| 检查项 | 预期结果 | 异常时的动作 |
|---|---|---|
| 启动日志 | 无 error 行,服务在 3 秒内就绪 | 回退包可能不完整,重新校验 |
| 端口 | 17890 处于 LISTEN | 残留进程未清,先 kill 再启动 |
| 连接耗时 | 与当年记录相差 < 20% | 线路或固件已变化,属正常波动 |
| 配置导入 | 规则条数与导出前一致 | 导入失败时手工重建关键规则 |
回退不是终点:把回退原因写进自己的运维记录,下次升级前先对照。同一台设备因同一原因回退两次,说明环境确实不兼容新版本,应停在回退版本并把系统或固件升级列入计划。
§ 07 · 升级顺序
多台设备同时升级是故障放大器。一旦新版本有问题,全部设备同时不可用,连排查入口都没有。
用 24 小时观察连接稳定性与端口占用,确认无异常再扩大。
同类设备的系统与固件相近,问题暴露会更集中,便于定位。
关键设备留到最后,升级前准备好回退包与导出配置。
同一台设备两次升级失败时,停止升级并查环境。
路由器批量升级时要额外注意架构:同一批设备里可能混有 aarch64 与 mipsel 两种架构,装错包会直接失败。升级前先统计 opkg print-architecture 的输出,按架构分组再操作。

§ 07b · 记录模板
设备一多,升级就成了没人记得清的事。一张五列的记录表能在两次故障之间建立联系:同一型号连续两次失败,说明是环境不兼容而不是偶然。
| 字段 | 填什么 | 为什么必须填 | 示例 |
|---|---|---|---|
| 设备标识 | 型号 + 系统或固件版本 | 区分同型号不同批次的固件 | GL-MT3000 / 23.05.3 |
| 升级前版本 | 完整三段版本号 | 判断是否跨大版本 | 3.8.7 |
| 升级后版本 | 完整三段版本号 | 与安装包哈希对应 | 3.9.6 |
| 结果 | 成功 / 回退 / 失败 | 失败与回退的原因不同 | 回退 |
| 原因摘要 | 一句话,含错误码或现象 | 便于后续检索 | fw4 规则未生效 |
记录的价值在半年后才显现:当你决定要不要跟进某次版本时,翻到同一型号的历史记录,就能看到它此前是否因同一原因回退过。没有记录时,这个判断只能凭印象,而印象通常偏向“上次好像没问题”。
记录表的粒度按设备而不是按人。一个人可能同时管十几台设备,按人记会漏;按设备记,每台设备只有一行,反而更容易坚持。

把这张表放在配置导出的同一目录,回退时直接对照。多数回退失败不是因为方法错了,而是因为没人记得上次是怎么退的。
§ 08 · 版本与校验
体积可以快速判断版本,哈希可以确认文件身份。两者一起看,能避免“体积对但版本不对”的误判。
| 文件 | 体积 | SHA-256 前 16 位 |
|---|---|---|
| KuaiMiao-Setup-3.9.6-x64.exe | 126.4 MB | 50a935074539076a |
| KuaiMiao-Setup-3.9.6-arm64.exe | 121.8 MB | 62b7e9b744e1d029 |
| KuaiMiao-Setup-3.9.6-x86.exe | 118.9 MB | 85b5ad67439ab9d8 |
| KuaiMiao-3.9.6-universal.dmg | 98.7 MB | a8c3601743428298 |
| KuaiMiao-3.9.6-arm64.dmg | 92.3 MB | cac114c742fa6b47 |
| kuaimiao_3.9.6-1_x86_64.ipk | 3.12 MB | dddfd88741a23407 |
| kuaimiao_3.9.6-1_aarch64_generic.ipk | 3.04 MB | f0dd9c36404a0db6 |
| kuaimiao_3.9.6-1_mipsel_24kc.ipk | 2.87 MB | 12eb40e64ff3e676 |
| luci-app-kuaimiao_3.9.6-1_all.ipk | 146 KB | 35e904964eabbf25 |
| sha256sums.txt | 2.1 KB | 57f7c8464d5388e5 |
历史版本的安装包不再列入本表,但仍保留在当年的清单文件里。回退时以那份清单为准,不要用当前版本的清单去核对旧包,哈希必然不符。
本表用于快速扫视:前 16 位足以区分不同文件,也不会把页面撑得过宽。需要完整比对时到校验页取整串,或直接读 sha256sums.txt。
§ 09 · 订阅
版本记录页是本站更新最频繁的一页,也是 RSS 订阅指向的页面。每次版本发布,先更新本页,再回填安装页里的数字。
数据 · 关键数字
每个数字后面都跟着条件,换了机器与版本数字会变,判断顺序不变。下面七条是本站各页共用的基础数据。
八个版本跨越 2026-05-19 至 2026-11-06 共 171 天,统计数据来自安装包签发时间戳。
安装包体积最大变化为 3.7.4 合并镜像后的 11.3 MB 降幅,依据当年清单的体积列对照。
回退平均耗时 14 分钟,其中重配占 9 分钟,测试环境为三台设备各回退 2 次(2026-11-08)。
回退锚点只有 2 个(3.6.9 与 3.5.2),安装包不再重签,哈希与首发时一致,来源为签发记录。
批量升级的第一段观察期建议 24 小时,依据 2026-09 至 11 月的 12 次批量升级记录。
端口迁移发生在 3.9.2,涉及 3 个默认端口,统计数据来自变更记录与安装页的端口说明。
版本记录共 8 条,覆盖 171 天的产品线变更,采样口径为每台设备上安装包的首次签发日。
这七条数据在安装页、校验页与排错页里被反复引用,三处数字始终一致;若你发现某页与另一页冲突,以数据采集日期较新的那一页为准,同时欢迎按页脚邮箱反馈。
§ 10 · 采集口径
版本记录的依据是安装包签发时间戳与安装包内的版本号字段,不作推断。表中数字均在标注环境下复核。
若你手里的安装包时间戳与本页日期相差超过一天,说明它不是本批签发的包,应以包内版本号与哈希为准,并把差异记下来再核对。
核对时使用安装包自带的版本号字段与文件时间戳两处信息,两者不一致时以版本号字段为准,并在记录里注明差异。
本页随版本发布更新,最近一次复核为 2026-11-08,覆盖 3.9.6 与相邻两个版本的全部安装包。若你发现日期与包内时间戳相差超过一天,请按页脚邮箱反馈。