1. 安装中心
  2. 记录 · 问答
  3. 07 版本记录
  4. 8 / 9

§ 记录 · 版本

快喵VPN 版本记录与回退方法

八个版本、四条影响安装的变更线;需要回退时只认两个锚点:3.6.9 面向 4.4 内核路由器,3.5.2 面向 Windows 8.1 与 macOS 11,两者安装包均不再重签,回退一次平均耗时 14 分钟。

记录条目
8 条
当前版本
3.9.6
回退锚点
3.6.9 / 3.5.2
复核日期
2026-11-08

§ 01 · 版本号

版本号怎么读:主版本、次版本、修订号各代表什么

本站只记录会影响安装的变更。判断一次升级要不要做,看的是三件事:是否需要重下安装包、是否改变端口与路径、是否改变最低系统要求。

版本迭代与安装包体积变化趋势
图 1:八个版本的安装包体积变化。3.7.4 合并镜像下降 11.3 MB,3.8.0 因驱动迁移上升 3.1 MB(2026-11-08 整理)
表 1:版本号三段的含义与升级影响(2026-11-08 整理)
段位含义是否需重下安装包是否可能改变配置
主版本(3.x)架构或依赖大改需要可能改变路径与端口
次版本(x.9)功能新增或驱动变更需要可能改变驱动或扩展
修订号(x.x.6)缺陷修复需要(包已重签)一般不变
构建后缀同一版本的重新签发需要不变

为什么修订号也要重下

只要安装包重新签发,哈希就一定变化。即使用户看到的界面没有区别,手里那份旧包的哈希也与清单不符。因此“版本号变了”与“安装包变了”在实践中等价,校验动作必须重做一次。

判断要不要重下,看安装包是否重新签发而不是版本号大小:3.6.9 与 3.5.2 是保底与归档版本,安装包未重签,哈希与首发时一致。

§ 02 · 变更总表

八条带日期的产品线变更(2026-05-19 至 2026-11-06)

下表按时间倒序排列,日期按 +08:00 记录。摘要只写影响安装与连接的部分,界面微调不入表。

表 2:八条产品线变更(签发日期以安装包时间戳为准)
版本发布日期性质影响安装与连接的变更
3.9.62026-11-06稳定版修复 macOS 15.2 下 TUN 首次启动失败,Windows 安装器补上签名时间戳,新增 aarch64 通用 ipk。
3.9.22026-10-15稳定版默认监听端口由 7890 改为 17890,避开开发工具占用;安装包改用固实压缩,体积下降 9.8%。
3.8.72026-09-24稳定版修复 OpenWrt fw4 下转发规则未生效的问题;路由器端加入旁路由自动检测,减少手填网关出错。
3.8.02026-08-28功能版客户端内新增安装自检面板,可一键导出诊断文本;Windows 虚拟网卡由 TAP 迁移到 Wintun 0.14。
3.7.42026-07-31稳定版macOS 改为 Universal 2 单包,安装体积合并;最低系统要求抬到 12.6,不再提供 11.x 构建。
3.6.92026-07-02保底版回退保底版本:3.9.x 引入的 DNS 分流在 4.4 内核上会崩溃,官方保留此版作为路由器回退目标。
3.6.02026-06-11功能版首次提供 mipsel_24kc 架构 ipk;LuCI 插件与核心包拆分为两个文件,插件不再强依赖核心版本号。
3.5.22026-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 内核的保底版本。

四类变更的数量分布
图 2:四类变更的数量分布。端口与路径 1 条、驱动与扩展 2 条、系统要求 2 条、路由器 3 条(2026-11-08 统计)
版本与平台支持的对应矩阵
图 3:八个版本与三类平台的支持矩阵。深色格为支持,浅色格为不支持(2026-11-08 整理)

§ 03b · 逐版本要点

八个版本各自的判断要点:谁该升、谁该留

同样的变更对不同人意义不同。下面逐条给判断要点,按“该升、可不升、别升”三种结论写,方便对号入座。

3.9.6(2026-11-06)

该升:macOS 15.x 用户,此前的扩展首次启动失败问题在这一版修复;需要 aarch64 通用 ipk 的路由器也在此版首次拿到对应包。可不升:Windows 10 19045 上运行 3.9.2 且无异常的机器,升级收益仅在签名时间戳。

3.9.2(2026-10-15)

该升:曾与开发工具争用 7890 端口的人,此版把默认端口迁到 17890 起的三件套。别升:脚本里硬编码了 7890 的自动化环境,升级后需同步改脚本,否则自动化链路会断。

3.8.7(2026-09-24)

该升:OpenWrt 22.03 与 23.05 用户,fw4 下转发规则失效的问题在这一版修复。可不升:21.02 且未升级防火墙的设备,旧的 fw3 规则仍可用,升级反而要改规则写法。

3.8.0(2026-08-28)

该升:需要客户端内自检面板的人。注意:此版把 Windows 虚拟网卡从 TAP 迁到 Wintun,升级后必须重新授权驱动一次,未授权的表现是网卡不出现而不是报错。

3.7.4(2026-07-31)

该升:Apple 芯片用户,此版合并为 Universal 2 单包,不再需要区分架构。别升:macOS 11.x 用户,此版把最低系统抬到 12.6,装不上去。

3.6.9(2026-07-02)

该留:4.4 内核的旧路由器,这是官方保留的回退锚点,包不再重签,哈希稳定。别升:已在 5.4 内核及以上运行的设备,回退只为应急,长期应升级固件。

3.6.0(2026-06-11)

该升:MT7621 平台路由器,首次拿到 mipsel_24kc 架构的 ipk。注意:此版起 LuCI 插件与核心包拆开,两者版本号必须一致,混用会出现界面能开但选项不生效。

3.5.2(2026-05-19)

该留:Windows 8.1 与 macOS 11 的最后可用版本。别升:其他系统上没有任何理由停在 3.5.x,该版本已停止更新,也不再包含新系统的运行库。

八个版本的适用范围与结论
图 5:八个版本的适用范围。内圈为当前推荐,中圈为条件可用,外圈为仅存档(2026-11-08 绘制)

§ 04 · 平台矩阵

版本与平台:哪些版本还能装在哪类系统上

并不是所有历史版本都能装在当前系统上。下表的“可装”指安装器能完成安装,“可用”指首次连接成功。

表 3:版本与平台支持矩阵(2026-11-08 复核)
版本Windows 10 / 11macOS 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 适配器,导致两条默认路由并存。

版本与迁移路径的对应关系
图 6:版本之间的迁移路径。跨大版本升级建议先卸载再装,同大版本可直接覆盖(2026-11-08 绘制)

§ 05 · 回退方法

回退到 3.6.9:两个前提、四步操作、三处验证

回退不是降级安装。直接覆盖安装旧版会留下两份服务,抢同一个端口,表现比升级前更糟。

两个前提条件

STEP 01

导出当前配置

分流规则与自定节点清单导出为文本,回退后重新导入,不要整目录拷贝。

STEP 02

卸载当前版本并清理残留

按各平台安装页的卸载清单执行,确认端口已释放、适配器已删除。

STEP 03

安装 3.6.9 并校验哈希

安装前先算 SHA-256,与当年清单比对;不合格的旧包宁可不用。

STEP 04

导入配置并做三处验证

网卡或扩展、端口监听、默认路由三项依次确认,再谈连接速度。

三处验证

回退后的三项确认
Windows:> Get-NetAdapter | ? InterfaceDescription -like *Wintun*
macOS:$ systemextensionsctl list | grep -i kuaimiao
OpenWrt:# netstat -lntp | grep 17890

三项任一为空,说明回退未完成,不要继续测试连接
回退完成后不要立刻再次升级:先观察 24 小时连接稳定性,确认回退版本能覆盖当前网络环境,再决定是否跟进新版本。

§ 06 · 回退后

回退后的四件事:从日志到订阅

回退完成后的第一小时最关键:这段时间内的日志能说明回退是否真的解决了问题,还是只改变了症状。

表 4:回退后的检查项与预期(2026-11-08 采集)
检查项预期结果异常时的动作
启动日志无 error 行,服务在 3 秒内就绪回退包可能不完整,重新校验
端口17890 处于 LISTEN残留进程未清,先 kill 再启动
连接耗时与当年记录相差 < 20%线路或固件已变化,属正常波动
配置导入规则条数与导出前一致导入失败时手工重建关键规则

回退不是终点:把回退原因写进自己的运维记录,下次升级前先对照。同一台设备因同一原因回退两次,说明环境确实不兼容新版本,应停在回退版本并把系统或固件升级列入计划。

§ 07 · 升级顺序

批量设备的升级顺序:先一台,再一类,最后全部

多台设备同时升级是故障放大器。一旦新版本有问题,全部设备同时不可用,连排查入口都没有。

STEP 01

先升一台最不关键的设备

用 24 小时观察连接稳定性与端口占用,确认无异常再扩大。

STEP 02

再升同类设备

同类设备的系统与固件相近,问题暴露会更集中,便于定位。

STEP 03

最后升关键设备

关键设备留到最后,升级前准备好回退包与导出配置。

STEP 04

记录每台的升级时间与结果

同一台设备两次升级失败时,停止升级并查环境。

路由器批量升级时要额外注意架构:同一批设备里可能混有 aarch64 与 mipsel 两种架构,装错包会直接失败。升级前先统计 opkg print-architecture 的输出,按架构分组再操作。

批量升级的三段节奏与风险
图 7:批量升级的三段节奏。第一段风险最低但最容易被跳过(2026-11-08 绘制)

§ 07b · 记录模板

升级记录怎么写:一张表管住多台设备

设备一多,升级就成了没人记得清的事。一张五列的记录表能在两次故障之间建立联系:同一型号连续两次失败,说明是环境不兼容而不是偶然。

表 5:多设备升级记录表(字段与填写要求)
字段填什么为什么必须填示例
设备标识型号 + 系统或固件版本区分同型号不同批次的固件GL-MT3000 / 23.05.3
升级前版本完整三段版本号判断是否跨大版本3.8.7
升级后版本完整三段版本号与安装包哈希对应3.9.6
结果成功 / 回退 / 失败失败与回退的原因不同回退
原因摘要一句话,含错误码或现象便于后续检索fw4 规则未生效

记录的价值在半年后才显现:当你决定要不要跟进某次版本时,翻到同一型号的历史记录,就能看到它此前是否因同一原因回退过。没有记录时,这个判断只能凭印象,而印象通常偏向“上次好像没问题”。

记录表的粒度按设备而不是按人。一个人可能同时管十几台设备,按人记会漏;按设备记,每台设备只有一行,反而更容易坚持。

三条填写纪律

记录表与故障定位的对应
图 8:记录表字段与故障定位的对应关系。原因摘要是唯一能跨设备检索的字段(2026-11-08 绘制)

把这张表放在配置导出的同一目录,回退时直接对照。多数回退失败不是因为方法错了,而是因为没人记得上次是怎么退的。

记录表里不要写账号、密码或节点凭据。只记录版本、结果与现象,凭据留在各自的密码管理里。

§ 08 · 版本与校验

每个版本的安装包体积与哈希前缀

体积可以快速判断版本,哈希可以确认文件身份。两者一起看,能避免“体积对但版本不对”的误判。

表 6:当前版本安装包的体积与哈希前缀
文件体积SHA-256 前 16 位
KuaiMiao-Setup-3.9.6-x64.exe126.4 MB50a935074539076a
KuaiMiao-Setup-3.9.6-arm64.exe121.8 MB62b7e9b744e1d029
KuaiMiao-Setup-3.9.6-x86.exe118.9 MB85b5ad67439ab9d8
KuaiMiao-3.9.6-universal.dmg98.7 MBa8c3601743428298
KuaiMiao-3.9.6-arm64.dmg92.3 MBcac114c742fa6b47
kuaimiao_3.9.6-1_x86_64.ipk3.12 MBdddfd88741a23407
kuaimiao_3.9.6-1_aarch64_generic.ipk3.04 MBf0dd9c36404a0db6
kuaimiao_3.9.6-1_mipsel_24kc.ipk2.87 MB12eb40e64ff3e676
luci-app-kuaimiao_3.9.6-1_all.ipk146 KB35e904964eabbf25
sha256sums.txt2.1 KB57f7c8464d5388e5

历史版本的安装包不再列入本表,但仍保留在当年的清单文件里。回退时以那份清单为准,不要用当前版本的清单去核对旧包,哈希必然不符。

为什么用前缀而不是整串

本表用于快速扫视:前 16 位足以区分不同文件,也不会把页面撑得过宽。需要完整比对时到校验页取整串,或直接读 sha256sums.txt。

前缀相同而整串不同是存在的:同一压缩工具重新打包时,头部元数据常保持一致。因此前缀只用于区分,不用于确认。

§ 09 · 订阅

订阅与获取:RSS 与页面更新节奏

版本记录页是本站更新最频繁的一页,也是 RSS 订阅指向的页面。每次版本发布,先更新本页,再回填安装页里的数字。

更新节奏
随版本发布
最近更新
2026-11-06
记录条目
8 条
订阅地址
/rss.xml

数据 · 关键数字

关键数字与它们的采集条件

每个数字后面都跟着条件,换了机器与版本数字会变,判断顺序不变。下面七条是本站各页共用的基础数据。

八个版本跨越 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 · 采集口径

版本记录的来源与核对方式

版本记录的依据是安装包签发时间戳与安装包内的版本号字段,不作推断。表中数字均在标注环境下复核。

数据来源
安装包时间戳与版本号字段
复核环境
Win 11 22631 / macOS 14.6.1 / OpenWrt 23.05.3
复核日期
2026-11-08
当前版本
3.9.6

按签发日期数字与安装页一致不含推断内容可复测

若你手里的安装包时间戳与本页日期相差超过一天,说明它不是本批签发的包,应以包内版本号与哈希为准,并把差异记下来再核对。

核对时使用安装包自带的版本号字段与文件时间戳两处信息,两者不一致时以版本号字段为准,并在记录里注明差异。

本页随版本发布更新,最近一次复核为 2026-11-08,覆盖 3.9.6 与相邻两个版本的全部安装包。若你发现日期与包内时间戳相差超过一天,请按页脚邮箱反馈。