§ 问答 · 安装
把安装阶段的高频疑问归成六类,共 43 个问题;每条答案都给出判断命令与预期结果,能够在 2 分钟内自证,而不是只给结论。
§ 01 · 系统与硬件
这一组问题都能用一条命令回答。先看清自己的系统 build 号,再看安装包文件名里的架构,多数疑问会自行消失。

不能。21H2 的 build 是 19044,安装器要求 19045 及以上,在驱动注册阶段会回滚并提示签名策略不匹配。升级到 22H2 后即可正常安装,安装包不必更换。
能装但不再更新。x86 安装包仍保留在清单里(118.9 MB),3.9.x 之后不再为 32 位系统提供新构建。若机器支持 64 位,建议重装 64 位系统后再用当前版本。
装 -arm64.exe。装成 x64 版本时安装器不报错,但首次连接会因驱动架构不匹配失败,报错文本与运行时库缺失相同,容易误判。
只能停在 3.5.2,那是最后支持 macOS 11 的版本。3.7.4 起最低要求抬到 12.6,安装器在 11.x 上会直接拒绝。
不需要。3.7.4 起改为 Universal 2 单包(98.7 MB),一个镜像同时含两套二进制。清单里另有 92.3 MB 的 arm64 分包,只是可选精简版,Intel 机器装了会提示应用已损坏。
够用。客户端常驻内存约 120 至 180 MB,分流规则较多时会上到 260 MB。4 GB 机器建议关闭分流里的应用级规则,只保留域名规则,可把常驻降到 140 MB 左右。
可以,但需要开启嵌套虚拟化或使用桥接网络。Windows 虚拟机里装驱动需要宿主允许虚拟网卡设备,未开启时表现为网卡不出现。路由器场景用 KVM 跑 OpenWrt 是常见做法,本页吞吐数据里 x86_64 一组就是这样采集的。
只影响安装耗时,不影响连接。机械盘上安装约 90 秒,固态盘约 25 秒;首连耗时差异在 0.3 秒以内。
| 环境 | 最低系统 | 安装后占用 | 建议可用空间 |
|---|---|---|---|
| Windows | 10 22H2(19045)/ 11(22631) | 186 MB | 420 MB |
| macOS | macOS 12.6 | 168 MB | 260 MB |
| OpenWrt | OpenWrt 21.02 | 3.1 MB | 24 MB |
§ 02 · 安装过程
这一组问题集中在“点了之后没反应”与“装到一半停下”。两者的取证动作完全不同:前者看权限与策略,后者看空间与文件。
先看任务管理器里有没有安装器进程:没有说明被策略拦下,改用管理员身份运行或在事件查看器里查 AppLocker 记录;有进程但无界面,说明安装器在解包,等 30 秒再看。
多数是驱动注册失败。先确认位数与运行库,再看临时目录里的安装日志末尾,通常会写明驱动注册被拒的原因。杀软与企业 EDR 是常见拦截方。
Windows 上检查开始菜单的最近添加项,安装器默认不创建桌面快捷方式;macOS 上一定在应用程序目录里,找不到说明拖到了别处,直接从挂载卷重拖一次。
需要一次。凡是改驱动或扩展的版本(3.8.0 起),升级后都要重新授权,未授权时表现为网卡或扩展不出现,而不是报错。
同一大版本内可以,跨大版本建议先卸载。跨版本覆盖可能保留旧的驱动适配器或扩展条目,导致两条默认路由并存或扩展重复注册。
可以下载,但不建议在网络盘上直接运行安装器。解包阶段的临时写入可能因网络抖动失败,表现为“写入文件失败”,而实际原因是路径不可靠。
不需要。安装过程不联网,只有首次连接时需要网络。值得注意的是:装了企业代理的环境里,安装器可能会去校验在线证书状态,此时需允许它访问网络或临时跳过在线校验。
按端口、网卡、路由表的顺序查三项。三项都在但对端无响应时,问题在出口侧而不是安装侧,转入线路排查而不是重装。

§ 03 · 权限与安全
权限相关的误解通常来自把“安装权限”与“运行权限”混为一谈。两者在不同平台上的边界也不同。
不需要。只有安装和驱动注册需要管理员权限,日常运行不需要。用管理员身份常驻会让开机自启项落到错误分支,反而更不稳定。
正常情况只需一次。反复要求输入说明扩展未正确授权,或应用被放在了非应用程序目录。把应用放回应用程序目录并重走一次扩展授权即可。
先核对哈希:哈希与清单一致说明文件未被改写,属误报;不一致则说明文件被拦截或改写,应重新下载。两种情况都不要直接关闭杀软长期裸奔。
企业设备通常由组策略或 MDM 限制驱动安装。判断依据是事件查看器里的 AppLocker 或策略拒绝记录。这类情况只能由管理员放行,个人侧无法绕过。
本站只描述安装行为,不评价具体业务功能。判断一个客户端是否记录浏览内容,看它是否声明日志策略、日志保存在哪里、保留多久。安装包里附带的服务说明与隐私条款是唯一可靠依据,不要依赖第三方转述。
卸载程序不总会清理服务项。Windows 上用 Get-Service 查残留并停止,macOS 上在扩展列表里移除,路由器上用 opkg remove 而不是删文件。
注册驱动或扩展时使用,用完即结束,不需要常驻。
普通用户即可,管理员常驻会引入自启项错位的问题。
首次启动时由系统询问,专用与公用网络都需要允许,否则外网不通。
§ 04 · 校验与签名
校验动作本身很简单,疑问多集中在“校验通过为什么还装不上”与“校验失败该不该继续”。
哈希只证明文件没变,不证明环境合适。哈希通过仍失败时,问题一定在本机:位数、运行库、端口、扩展授权四类,按安装页的自查清单逐条过。
不建议。先看体积:体积偏小多半是下载中断,重新下载即可;体积正常但哈希不同,说明传输过程被改写,换网络重下。只有确认是同一份文件被重新包装时才可继续,但这已超出普通用户的判断范围。
有。签名回答“谁签的”,哈希回答“是否被改”。两者一起才能同时排除替换与篡改。只看签名时,被改写的文件仍可能带着原签名段。
如果签名带时间戳,证书过期不影响验签;不带时间戳时,过期当天起验签就会失败。3.9.6 已补上时间戳,升级后这类问题不再出现。
需要。手工安装 ipk 时 opkg 只校验包内摘要,不校验源签名,因此哈希是唯一可用的完整性证据。三个架构的 ipk 哈希都在清单里。
不建议把安装包上传到第三方站点算哈希:这类站点既可能留档,也可能改写文件。本地一条命令即可完成,没有上传的必要。


§ 05 · 路由器
路由器侧的疑问几乎都围绕架构、空间与接法三件事。先确认 CPU 架构,再看 flash 空间,最后决定接法。
执行 opkg print-architecture,第一行是主架构。aarch64_cortex-a53 一类装 aarch64_generic,MT7621 一类装 mipsel_24kc,软路由装 x86_64。
通常不行。核心包 3.1 MB 加插件后需要约 3.3 MB 的 overlay 空间,8 MB flash 设备上 overlay 常只剩 3 至 5 MB。用 df -h /overlay 确认,不足时只能换设备或改用旁路由方案。
会引入一次额外转发。实测 x86_64 旁路由额外延迟约 1.2 ms,aarch64 约 2.4 ms,mipsel_24kc 约 6.8 ms。千兆内网下旁路由的瓶颈通常在设备 CPU 而不是网络结构。
DHCP 下发的网关没改,或设备仍持有旧租约。改 DHCP 后把租期缩短到 10 分钟,或让设备断开重连一次。
先看 PPPoE 是否连上,再看 MTU 是否 1492,最后看防火墙转发区域是否允许 LAN 到 WAN。三者任一不对都表现为“能进管理页但不能上网”。
不支持。核心服务按单实例设计,同时启动两个会因为端口相同而互相抢占,日志里会反复出现绑定失败。

§ 05b · 命令速查
问答里提到的命令集中在这里,按用途分成四张表。所有命令都在 2026-11-08 至 11-09 复测过,复制即可执行。
| 要查什么 | Windows | macOS | OpenWrt |
|---|---|---|---|
| 系统版本 | winver | sw_vers | cat /etc/openwrt_release |
| 位数与架构 | [Environment]::Is64BitOperatingSystem | uname -m | uname -m |
| 可用空间 | Get-PSDrive C | df -h / | df -h /overlay |
| 虚拟网卡 | Get-NetAdapter | ? InterfaceDescription -like *Wintun* | ifconfig | grep utun | ip link |
| 服务状态 | Get-Service | ? Name -like *KuaiMiao* | systemextensionsctl list | /etc/init.d/kuaimiao status |
| 最近日志 | Get-WinEvent -LogName Application -MaxEvents 20 | log show --last 5m | logread | tail -20 |
| 要查什么 | Windows | macOS | OpenWrt |
|---|---|---|---|
| 文件哈希 | Get-FileHash -Algorithm SHA256 | shasum -a 256 | sha256sum |
| 文件体积 | (Get-Item f).Length | ls -l f | ls -l f |
| 签名状态 | Get-AuthenticodeSignature | spctl -a -vvv | opkg-key list |
| 隔离属性 | 不适用 | xattr -l | 不适用 |
| 批量校验 | Get-ChildItem | Get-FileHash | sha256sum -c sums.txt | sha256sum -c sums.txt |
| 要查什么 | Windows | macOS | OpenWrt |
|---|---|---|---|
| 端口监听 | Get-NetTCPConnection -LocalPort 17890 | lsof -nP -iTCP:17890 | netstat -lntp | grep 17890 |
| 占用进程 | Get-Process -Id | ps -p | ps | grep kuaimiao |
| 默认路由 | route print -4 | netstat -rn | head | ip route |
| DNS 结果 | Resolve-DnsName 域名 | scutil --dns | nslookup 域名 |
| MTU 试探 | ping -f -l 1472 域名 | ping -D -s 1472 域名 | ping -M do -s 1472 域名 |
| 要查什么 | 命令 | 预期结果 | 异常时 |
|---|---|---|---|
| CPU 架构 | opkg print-architecture | 主架构与 ipk 文件名一致 | 换对应架构的包 |
| overlay 空间 | df -h /overlay | 可用 ≥ 24 MB | 清理备份或扩容 |
| 软件源版本 | cat /etc/opkg/distfeeds.conf | 与系统大版本一致 | 改源或升级固件 |
| 已装组件 | opkg list-installed | grep kuaimiao | 核心与插件版本一致 | 统一版本重装 |
| 防火墙实现 | fw4 print 或 iptables -V | 与固件版本匹配 | 改写规则或回退版本 |
| 服务状态 | /etc/init.d/kuaimiao status | running | 看 logread 定位 |
四张表的使用顺序固定:先取证确认环境,再校验确认文件,然后看端口确认服务,最后在路由器上确认兼容性。顺序反过来会让排查失去参照。

§ 05c · 双平台对照
同一句报错在两个系统上可能指向完全不同的成因。下表把最容易混用的六组并排放。
| 问题 | Windows 侧 | macOS 侧 |
|---|---|---|
| 提示发布者未知 | Get-AuthenticodeSignature 看 Status | spctl -a -vvv 看 source |
| 装完连不上 | netstat 看 17890 是否监听 | scutil --nc list 看配置项 |
| 驱动或扩展缺失 | Get-NetAdapter 找 Wintun | systemextensionsctl list 找扩展 |
| 卸载残留 | ProgramData 目录与服务项 | SystemExtensions 与账户配置目录 |
| 首次运行拦截 | 防火墙与 SmartScreen 提示 | Gatekeeper 与隔离属性 |
| 开机自启失效 | 任务计划程序里的启动项 | 登录项与扩展里的允许列表 |
差异的根源在机制:Windows 用驱动与注册表,macOS 用系统扩展与隔离属性。把一侧的经验直接搬到另一侧,最常见的后果是把扩展授权问题当成网络问题处理。

§ 06 · 版本与回退
版本相关的问题集中在“要不要升”与“能不能退”。判断依据是变更是否触碰驱动、端口与最低系统要求三处。
看变更是否触及三处:驱动或扩展、端口与路径、最低系统要求。三处都没动时升级风险最低;触及任一处时,先在一台非关键设备上验证 24 小时。
不需要。回退只需卸载当前版本、清理残留、安装旧版三步。旧版的安装包与哈希在版本记录页可以查到。
部分在。分流规则与自定节点通常可以导出再导入,其余配置(端口、自启项)需要重设。整目录拷贝配置目录容易带入旧版本字段,不建议。
不能。两个版本会抢同一组端口,也会各自注册虚拟网卡,表现为两条默认路由并存。需要对比测试时请用不同机器或虚拟机。
旧版本不会获得修复更新,长期停留意味着已知问题不会被修。回退应作为临时手段,同时把系统或固件升级列入计划,尽快回到当前版本。

§ 07 · 排错方法
方法类问题没有标准答案,但有可复用的判断框架。下面四条是本站所有排错页共用的思路。
按取证成本排:能一条命令验证的先做,需要改配置的后做。这样即使最终没解决,也不会因为改了太多东西而失去对照。
换一台设备用同一网络试:两台都失败说明在网络侧,只有一台失败说明在客户端侧。这一步成本极低,能砍掉一半分支。
只在文件损坏或配置错位时有用。装不上的原因如果是位数、运行库或权限,重装十次结果相同。判断办法是看重装前后错误码是否变化:不变说明根因未动。
同一动作重复三次仍失败时应当停下,先把证据整理成五行(哈希、系统版本、位数、版本与端口、错误文本),再换思路或求助。继续重复只会消耗时间。
| 框架 | 适用场景 | 关键动作 |
|---|---|---|
| 按成本排序 | 完全不知道从哪下手 | 先做 30 秒能做的 |
| 换设备对照 | 怀疑网络侧问题 | 同网络换一台机器 |
| 看重装差异 | 反复重装无效 | 对比重装前后错误码 |
| 三次即停 | 陷入重复尝试 | 整理五行证据再求助 |
§ 08 · 资料勘误
本站所有数字都标了采集环境,因此勘误也需要同样的信息。只发一句“我这装不上”无法定位,附上五行证据就能复现。
勘误的处理顺序是:先复现,再定位是文案错还是环境差异,最后决定改文案还是补一条边界说明。只有能复现的差异才会进正文,避免把个案写成通用结论。
代装会让用户失去判断能力:下次遇到同类问题仍然无法自查。本站的目标是把判断顺序写清楚,让读者自己能定位到具体环节。
数据 · 关键数字
每个数字后面都跟着条件,换了机器与版本数字会变,判断顺序不变。下面七条是本站各页共用的基础数据。
43 个问题按六类归档,其中系统与硬件 8 条、安装过程 8 条,统计数据为本页条目的实际分布(2026-11-08)。
安装失败按阶段分布:解包 21%、驱动注册 46%、首次连接 33%,数据来自 360 次安装记录(2026-09 至 11 月)。
8 MB flash 设备上 overlay 通常只剩 3 至 5 MB,测试环境为 3 台老款路由器(2026-11-09 采样)。
旁路由额外延迟在 x86_64 上为 1.2 ms、aarch64 为 2.4 ms、mipsel_24kc 为 6.8 ms,测试条件为千兆有线。
回退平均耗时 14 分钟而升级平均 6 分钟,统计数据为 2026-11-08 的 24 次操作记录。
命令表共 4 张、条目 22 条,全部在 Windows 11 22631、macOS 14.6.1 与 OpenWrt 23.05.3 上验证过。
三类环境的最低要求分别为 19045、12.6 与 21.02,依据各平台接口版本记录与实测安装结果。
这七条数据在安装页、校验页与排错页里被反复引用,三处数字始终一致;若你发现某页与另一页冲突,以数据采集日期较新的那一页为准,同时欢迎按页脚邮箱反馈。
§ 09 · 采集口径
本页答案来自三类环境的实际安装记录与反馈,数字与安装页、校验页保持一致。
问答里的数值凡与安装页重复的,两处始终同步更新;若发现不一致,请以安装页为准并反馈,我们会按版本记录页的日期一并修订。