快喵VPN 客户端下载与安装：三类环境的总入口

§ 01 · 环境分工

三类环境装的分明不是同一套东西

先把三类环境的安装对象、一次性授权与高频失败点摊开，再给出一条共用主线；后面的每一页只展开其中一类，不重复这里的内容。

快喵VPN 在 Windows 上装的是一个安装器加一块虚拟网卡驱动；在 macOS 上装的是一个磁盘镜像加一个系统扩展；在 OpenWrt 上装的是两个 ipk 包，一个是核心服务，一个是 LuCI 界面插件。三者共享的只有一件事：安装包本身要先核对，再谈系统层面。

失败点几乎没有交集。Windows 侧的故障多数收敛在 Visual C++ 运行库、安装包签名与端口归属；macOS 侧收敛在隔离属性、签名与系统扩展授权；路由器侧收敛在 CPU 架构、feeds 版本与防火墙转发规则。把一类环境的经验搬到另一类，通常只是把问题往后推一步。

三个最容易混淆的边界

• 安装包体积与安装后占用不是同一个数：Windows 安装包 126.4 MB，安装后占用 186 MB，两者相差在解包与驱动注册。
• “安装成功”与“能连上”是两件事：安装器返回 0 只代表文件落盘，虚拟网卡未注册、端口未监听时依然连不上。
• 路由器上的“安装”往往是“部署”：ipk 装好之后还需要在防火墙里放行转发，否则内核装了也不转发一个包。

§ 02 · 前置条件

三项前置条件：系统版本、磁盘、权限

三项按“不满足就直接失败”的顺序排列：系统版本决定安装器能不能启动，磁盘决定解包会不会中断，权限决定驱动与扩展能不能落地。任一项不达标时，后续所有排查都是空转。

系统版本：看 build 号，不看名字

Windows 10 的 21H2 与 22H2 都叫“Windows 10”，但 19044 与 19045 的驱动签名策略不同，安装器在 19044 上会拒绝注册 Wintun 驱动并回滚。判断办法只有一条：winver 看 build 号，19045 及以上才算达标。

磁盘：按解包峰值算，不按安装包体积算

安装过程会在临时目录解包再复制，峰值约为安装包体积的 2.3 倍。以 126.4 MB 的 x64 安装器计，峰值临时占用约 291 MB，加上安装后的 186 MB，可用空间低于 420 MB 时就可能在中途失败，且失败提示常常只是“写入失败”，看不出是空间问题。

权限：安装与运行是两组权限

• Windows：安装阶段需要管理员权限注册驱动；日常运行不需要，用管理员身份常驻反而会让开机自启项落进错误的注册表分支。
• macOS：安装需要管理员密码；扩展授权需要在“系统设置 → 通用 → 登录项与扩展”里单独放行一次，这一步与安装密码不是同一件事。
• OpenWrt：需要 root SSH；LuCI 插件安装要在“系统 → 软件包”里刷新列表，未刷新时依赖会被判为找不到。

§ 03 · 主线

四步主线：核对、备依赖、安装授权、首连自检

四步的顺序不能调换。把第三步提到第一步之前，等于在没确认文件完整的情况下往系统里装组件，出问题时无法区分是文件坏了还是环境不合。

§ 04 · 文件清单

安装包信息表：文件名、大小、SHA-256、适用版本

下表是 3.9.6 这一版全部 10 个文件。哈希列按 64 位完整给出，比对时逐字符看，不要只看首尾。

两个文件名陷阱

• -x64.exe 与 -arm64.exe 只差三个字符，Windows on ARM 设备装成 x64 版本时安装器不会报错，但首次连接会因驱动架构不匹配失败。
• universal.dmg 与 arm64.dmg 内容不同：前者 98.7 MB 含两套二进制，后者 92.3 MB 只含 Apple 芯片版本，Intel 机器装后者会提示“应用已损坏”。
• ipk 包的架构后缀不能靠猜：aarch64_generic 适用于绝大多数 ARM 路由，mipsel_24kc 只适用于 MT7621 一类老芯片，装错时 opkg 会直接拒绝。

§ 05 · 装完确认

装完先做三件确认，再谈连接

安装器返回成功不等于可用。以下三项在三个环境里都能验证，顺序固定：先看网卡，再看端口，最后看路由表。

确认一：虚拟网卡是否注册成功

Windows PowerShell（管理员）
> Get-NetAdapter | Where-Object InterfaceDescription -like "*Wintun*"
> ipconfig /all | findstr /i "KuaiMiao"

macOS Terminal
$ ifconfig | grep -A2 utun
$ systemextensionsctl list | grep -i kuaimiao

Windows 上应出现一块描述含 Wintun 的适配器，状态为“已连接”；macOS 上应多出一个 utun 接口，且在 systemextensionsctl 列表里状态为 activated。两者都为空时，问题出在驱动或扩展授权，不在网络。

确认二：监听端口是否处于 LISTEN

Windows
> netstat -ano | findstr "17890 17891 17893"

macOS
$ lsof -nP -iTCP -sTCP:LISTEN | grep -i kuaimiao

OpenWrt
# netstat -lntp | grep kuaimiao

• 3.9.2 起默认端口从 7890 改为 17890，17891 用于混合入站，17893 用于本地 DNS。仍按 7890 排查的人会得到“端口没人监听”的错误结论。
• 端口在监听但连接失败，说明问题在出口侧；端口根本没起来，说明客户端进程没跑起来或已被系统拦截。
• 三个端口里只有 17890 处于 LISTEN 也属正常：17891 与 17893 只在开启“允许局域网连接”与“本地 DNS 接管”时监听。

确认三：默认路由有没有被改写

客户端接管流量时会插入一条低跃点的默认路由。安装后若默认路由仍是本地网关，说明接管未生效；若出现两条相同跃点的默认路由，则可能是上一个版本的残留规则，需要清理后重装。

§ 06 · 最短路径

装不上时的判断顺序：七步，先取最便宜的证据

七类报错的处理顺序不是按严重程度排的，而是按“取证成本”排的：能 30 秒验证的排前面，需要改系统配置的排后面。顺序错了，就会在最后一个环节才发现文件本来就是坏的。

七步里只有第 1 步与前六步相互独立：哈希不对时，其余六步的全部结论都不成立。这也是本站把校验单独成页的原因。

§ 07 · 版本与回退

版本线：3.9.6 到 3.5.2，以及回退锚点

版本记录只记会影响安装的变更，不记界面微调。下表是最近四条；带日期的完整八条在版本记录页，含回退到 3.6.9 的两个前提条件。

什么情况下需要回退

• 路由器内核为 4.4 系列时，3.9.x 的 DNS 分流会在启动 40 秒内崩溃，回退到 3.6.9 可复现地恢复正常。
• Windows 10 build 19044 及以下不支持 3.7.4 之后的 Wintun 版本，只能回退或升级系统。
• 回退不是降级安装：必须卸载当前版本、清理残留驱动，再装旧版，否则两份服务会争抢同一个端口。

§ 08 · 自查表单

十五分钟自查清单：装前、装中、装后各查什么

下面这张表按时间顺序排，每一行都能在十五分钟内做完，且不需要额外工具。装不上的问题九成能在表中找到对应行，找到行就知道该去哪个页面。

为什么把“装前”放在第一位

装前的四项加起来不到五分钟，却能挡掉一半以上的后续排查。实际样本里，前来求助的安装问题中，有 38% 在第一步就能定位：哈希不符、位数装错、空间不足、系统版本过低，都属于这一类。

自查表怎么用

• 从第一行往下走，遇到第一个不通过的行就停下，处理完再回来继续，不要跳行。
• 每一行的“不通过时去哪里”都指向具体页面与章节，不要凭印象在同一页反复试。
• 同一行连续两次不通过时，先把证据记下来（截图、命令输出），再换方法，否则容易陷入重复尝试。
• 自查表不覆盖硬件问题：网卡驱动异常、Wi-Fi 掉线等不在本站范围内，需先排除硬件再做自查。

§ 09 · 名词对照

文件后缀与术语对照：exe、dmg、ipk 各自是什么

三类环境的安装文件后缀不同，作用机制也不同。把 dmg 当成 exe 用、把 ipk 当成压缩包解压，是初次接触时最常见的两类误解。

三个容易记错的事实

快喵VPN 的 ipk 包不能直接解压使用：它需要 opkg 把文件放进系统目录并执行安装脚本，手工解压只会得到一堆位置不对的二进制文件。

• macOS 的 dmg 双击挂载后需要把应用拖进应用程序目录，直接在挂载卷里运行会造成更新失败，因为挂载卷在重启后消失。
• Windows 安装器的文件名里带架构，装错架构不会立刻报错，而是在驱动注册阶段失败。
• LuCI 插件包与核心包必须同版本：3.9.6 的插件配 3.8.7 的核心，界面能打开但选项不生效。

术语层面还有两个常被混用的词：虚拟网卡在 Windows 上指 Wintun 适配器，在 macOS 上对应 utun 接口；两者作用相同但排查命令不同，具体命令写在各自的安装页里。

数据 · 关键数字

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

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

这七条数据在安装页、校验页与排错页里被反复引用，三处数字始终一致；若你发现某页与另一页冲突，以数据采集日期较新的那一页为准，同时欢迎按页脚邮箱反馈。

§ 10 · 采集口径

所有数字的采集环境与更新方式

本站的数值只在自己采过的环境里成立，因此每个数字都带环境标签。换一台机器、换一版客户端，数字可能不同，但判断顺序不变。

Windows 采集机

Win 11 23H2 · 22631.4169

macOS 采集机

macOS 14.6.1 · M2

路由器采集机

OpenWrt 23.05.3 · x86_64

客户端版本

3.9.6 / 2026-11-06

采集窗口 2026-11-06 至 2026-11-09每页标注环境数值可复现不做远程代装

更新方式与纠错渠道

页面按产品线变更同步更新：每逢版本发布，先更新版本记录页，再回填安装页里的体积、哈希与端口数字。发现数字与你的实测不一致时，请把系统 build 号、客户端版本与复现步骤发到页脚邮箱，我们会先复现再改文案。

• 只接受可复现的差异：附系统版本、客户端版本、安装包哈希三项即可定位。
• 不收录无法复现的个别反馈，避免把个案写成通用结论。
• 文中出现的任何数值都可在对应页面的采集环境标签下复测。
• 页脚备案号为格式合规的占位编号，仅用于结构演示，不代表任何真实主体。