出问题的现场：横向滑动查看
场景示意照片，用于说明排障常在怎样的环境下发生，不含界面截图。
排障字段
字段与判定码在客户端关于面板与日志里都能看到，采集于 2026 年 11 月。
| 字段 | 公示值 | 说明 |
|---|---|---|
| 判定码 | 五类，形如 E1 至 E5 | 权限、解析、链路、账号、配置各一类 |
| 版本号 | 5.8.2 与构建号 | 版本不一致时先升级再排障 |
| 出口 IP | 连接前后的两个值 | 未变化说明流量没走客户端 |
| 解析结果 | 客户端给出的解析地址 | 与系统 DNS 不同属正常 |
| 重连耗时 | 通常 3 秒至 12 秒 | 超过 30 秒视为异常 |
| 日志范围 | 最近 10 分钟足够定位 | 完整日志按天切分 |
| 定位时长 | 解析类 40 秒，链路类 3 分钟 | 2026-09 至 11 的复盘记录 |
| 反馈渠道 | support@kuaimioapp.com.cn | 附判定码、版本号与端名 |
分端说明卡：六端各自装在哪里
六张卡对应六个安装包，体积与哈希前 8 位一并列出，图注为场景示意。
Windows · 28.4MB
Windows 10 与 11（x64、ARM64），安装形态为exe 安装器，含 TAP 驱动。
- SHA-256 前 8 位 4b8e1c07。
- 系统下限按 2026-11-11 复核。
- 采集时间 2026-11-11。
macOS · 24.7MB
macOS 12 及以上（Apple 芯片与 Intel 通用），安装形态为dmg 镜像，签名公证。
- SHA-256 前 8 位 9d2f5a83。
- 系统下限按 2026-11-11 复核。
- 采集时间 2026-11-11。
Android · 21.6MB
Android 8.0 及以上（arm64-v8a 为主），安装形态为APK，可选 armv7 分包。
- SHA-256 前 8 位 e71a4c96。
- 系统下限按 2026-11-11 复核。
- 采集时间 2026-11-11。
iOS · 26.9MB
iOS 15 及以上（iPhone 与 iPad 通用），安装形态为App Store 版本或 TestFlight 包。
- SHA-256 前 8 位 3f60b8d2。
- 系统下限按 2026-11-11 复核。
- 采集时间 2026-11-11。
Linux · 19.8MB
内核 5.4 及以上（deb、rpm、AppImage），安装形态为三种包型，命令行安装。
- SHA-256 前 8 位 c52d9a17。
- 系统下限按 2026-11-11 复核。
- 采集时间 2026-11-11。
路由器 · 8.3MB
OpenWrt 21.02 及以上；梅林 386 及以上，安装形态为ipk 与 tar.gz 两种固件包。
- SHA-256 前 8 位 7e18c4b0。
- 系统下限按 2026-11-11 复核。
- 采集时间 2026-11-11。
版本记录时间轴：最近七次发布
每条记录带发布日期与一项实测数据，完整说明在版本记录页。
5.8.2：六端安装包重新签名，校验值随页公示
2026-11-11。六端安装包统一重签，SHA-256 全部更换。Windows 包体积 28.4MB，较 5.8.0 增 0.6MB，增量来自驱动签名文件（2026-11-11 采样）。
5.8.0：设备额度面板上线，解绑不再需要重登
2026-11-05。账号页新增设备额度面板，可直接查看在线终端与解绑时间。面板首屏耗时 320 毫秒，弱网条件下实测 1.4 秒（2026-11-04 实测）。
5.7.4：路由器端支持 ipk 单包安装，配置迁移可用
2026-10-22。路由器端新增 ipk 单包安装，安装后配置导入耗时从 46 秒降到 12 秒。该版本固件体积 8.3MB，适配 OpenWrt 21.02 及以上（2026-10-21 测试）。
5.7.0：Linux 端补齐 AppImage，免 root 可运行
2026-10-08。Linux 端补齐 AppImage 包型，免 root 直接运行，依赖体积从 62MB 降到 19.8MB。三种包型的命令行参数保持一致（2026-10-07 版本说明）。
5.6.3：连接失败时会直接给出判定码
2026-09-24。连接失败不再只提示超时，而是返回判定码与下一步动作。DNS 解析类失败的定位时间从 6 分钟压缩到 40 秒（2026-09-23 内部复测）。
5.6.0：安卓端后台驻留改为前台服务常驻
2026-09-10。安卓端后台驻留改走前台服务，30 分钟息屏测试中连接保持率 100%。代价是通知栏常驻一条提示，可在设置里关闭（2026-09-09 实测）。
5.5.2：macOS 端适配 Apple 芯片原生运行
2026-08-27。macOS 端改为通用二进制，Apple 芯片上原生运行，启动耗时从 2.1 秒降到 0.9 秒。安装包体积因此增加 3.4MB（2026-08-26 实测）。
连不上的七步排查
从最便宜的一步开始，每步都有判据。
排查顺序按代价排序：先看不需要改配置的，再看需要改配置的。八成的连接失败在前三步就能定位。
每一步都有明确判据，不靠感觉。判据不成立就进入下一步，成立就停在那里处理。
- 看系统时间：与标准时间偏差超过 5 分钟，证书校验会失败，表现却是超时。
- 看版本号：不是 5.8.2 的先升级，跨两个小版本的配置字段可能不兼容。
- 看出口 IP：连接前后对比，未变化说明流量没走客户端。
- 看判定码：E1 权限、E2 解析、E3 链路、E4 账号、E5 配置，按类处理。
- 换一次节点：同线路换节点后恢复，说明是节点侧问题。
- 换一次网络：蜂窝网络与 Wi-Fi 各试一次，能定位是本地网络还是线路。
- 重启客户端：仍不行再看日志，日志里带完整判定码与时间戳。
解析异常：最容易误判的一类
连接建立了但网页打不开，多与解析有关。
解析异常的典型表现是客户端显示已连接，浏览器却打不开网页。此时出口 IP 已变，说明链路没问题，问题在域名解析。
先看解析地址是不是客户端给出的那个。若仍是本地运营商的地址，说明解析没走客户端，需要在设置里重新下发一次。
- 判据一：出口 IP 已变化，域名解析失败，属解析类。
- 判据二：关闭客户端后网页恢复，属解析劫持或分流误命中。
- 判据三：只有部分域名失败，属分流规则或上游污染。
- 处置一：重新下发一次解析配置，等待 10 秒生效。
- 处置二：临时改用明文解析，确认是否与加密解析有关。
速度不达预期：先分清四类现象
四类现象对应四种原因，别用同一个办法修。
变慢的原因分四类：链路抖动、分流误命中、测速源限速、出口拥塞。它们的现象不同，处置也不同。
最快的判断方式是换一个测速源再测一次。结果差异大，说明问题在测速源；差异小，才需要看链路。
| 现象 | 原因判断 | 处置 |
|---|---|---|
| 网页能开但很慢 | 链路抖动或节点拥塞 | 换节点复测一次，抖动下降即为节点问题 |
| 部分网站打不开 | 分流规则或 DNS 污染 | 先看分流命中，再看解析结果 |
| 测速偏低但下载正常 | 测速端口被限速 | 换测速源，别用单一源下结论 |
| 晚上慢白天快 | 出口拥塞的时间特征 | 记录三个时段的中位延迟再判断 |
客户端异常：闪退、白屏与权限
先排除包体问题，再动配置。
客户端起不来时，第一步不是重装，而是核对安装包哈希。包体被截断会表现为双击无反应或白屏。
安全软件拦截是最常见的第二原因。放行客户端主程序后重启，界面通常就能正常渲染。
| 现象 | 常见原因 | 处置 |
|---|---|---|
| 双击无反应 | 安装不完整或权限不足 | 以管理员运行或重装，先核对哈希 |
| 界面白屏 | 渲染进程被安全软件拦截 | 放行客户端主程序，重启后重试 |
| 连接后系统断网 | 虚拟网卡路由冲突 | 关闭全局模式，改用分流试一次 |
| 托盘图标消失 | 进程被系统回收 | 重新启动客户端并检查自启项 |
路由器端排障
没有界面可点，只能看日志与出口。
路由器端的排障路径与桌面端不同。它没有界面，判定码只写日志，第一手信息是出口 IP 与固件日志。
先确认固件版本达标，再确认分区空间够用。8.3MB 的包解压后要占位，空间不足会表现为进程反复重启。
- 确认固件版本达到 OpenWrt 21.02 或梅林 386。
- 确认分区剩余空间大于 12MB，不足时先清理。
- 用手机连上路由器，确认出口 IP 与预期一致。
- 读最近十分钟日志，找判定码与重启次数。
- 仍不行的刷回上一版固件，导入备份配置。
日志与反馈怎么写
三行有效信息，胜过十张截图。
反馈里最有用的三样是判定码、版本号、时间点。有了这三样，定位通常不需要再问第二轮。
日志默认只保留最近十天，按天切分。问题发生超过十天的，先看是否还留有当时的导出文件。
- 第一行写判定码与出现时间，精确到分钟。
- 第二行写版本号与端名，例如 5.8.2 Windows。
- 第三行写已尝试过的处置，避免重复建议。
- 附日志导出文件，不要贴大段截图。
- 涉及账号的，注明是否多端同时在线。
什么时候该换端，而不是继续排障
有些问题不是修出来的，是换一种端就绕过去了。
移动端频繁断连时，先判断是驻留方式的问题还是线路的问题。息屏就断、亮屏即恢复，多半是驻留被系统回收。
桌面端分流误命中时，与其一条条改规则，不如临时切到全局模式验证一次，能立刻分清是规则问题还是链路问题。
路由器端反复重启的，先看分区空间。空间不足会表现为进程被杀，日志里只有重启记录，看不出原因。
iOS 端不支持自定义解析，遇到解析类问题无法在端内解决，只能改系统设置或换设备验证。
换端的判断标准很简单：同一问题在两端都出现，才值得继续排障；只在单端出现，先换端绕开。
- 息屏即断、亮屏即恢复：驻留被系统回收，不是线路问题。
- 分流疑似误命中：临时切全局验证一次即可分清。
- 路由器端反复重启：先看分区剩余空间是否大于 12MB。
- iOS 端解析问题无法在端内修改，改系统设置。
- 同一问题在两端都出现，才值得继续深挖。
- 只在单端出现的，先换端绕开，再回头看日志。
- 2 端判断是否继续排障的分界。
- 12MB路由器端最低剩余空间。
- E1 至 E5五类判定码。
- 10 天日志默认保留天数。
六端排障快照
各端最常见的判定码与定位时长，按 2026-09 至 11 的复盘记录。
| 端 | 常见判定码 | 定位时长 | 首要处置 |
|---|---|---|---|
| Windows | E1、E3 | 约 3 分钟 | 以管理员运行并查驱动 |
| macOS | E1、E2 | 约 2 分钟 | 放行系统扩展 |
| Android | E3、E4 | 约 90 秒 | 换网络并核对额度 |
| iOS | E2、E3 | 约 2 分钟 | 重新允许 VPN 配置 |
| Linux | E5 | 约 4 分钟 | 回退配置并看日志 |
| 路由器 | E3、E5 | 约 5 分钟 | 查出口 IP 与日志 |
快照按端逐行列出，数值与正文表格口径一致，采集时间见每行末列。
口径词条：本页术语的准确定义
同一个词在不同站写法不同，这里给出本站采用的定义，共 10 条。
- 判定码
- 连接失败时返回的五类代码，E1 至 E5 各对应一类原因。
- E1 权限类
- 系统权限未授予，虚拟网卡或 VPN 配置没建起来。
- E2 解析类
- 域名解析没走客户端，表现是能连上却打不开网页。
- E3 链路类
- 出口或节点侧不可达，换节点或换网络可复现。
- E4 账号类
- 登录态失效或额度用满，需要重新登录或解绑。
- E5 配置类
- 分流规则或 DNS 配置冲突，回退配置可排除。
- 重连耗时
- 断线后恢复连接的时间，通常 3 秒至 12 秒。
- 探活
- 定时发起的连通性检查，用于统计保持率。
- 日志切分
- 日志按天分割保存，默认保留最近十天。
- 复现条件
- 能让问题稳定出现的网络与时段组合。
排障的常见问题
答案对应 5.8.2 的判定码体系，旧版本提示语可能不同。
判定码 E2 是什么意思？
E2 属解析类失败，表示域名解析没有走客户端。先确认解析地址，再重新下发一次配置，多数在 10 秒内恢复。
为什么时间不准就连不上？
连接握手要用证书校验，系统时间偏差超过 5 分钟会导致校验失败。表现是超时，很容易被误判为线路问题。
换了节点还是慢怎么办？
换节点无效说明问题不在节点。先换测速源排除测速误差，再记录三个时段的中位延迟，看是否属于出口拥塞。
客户端装完打不开怎么查？
先核对安装包哈希，排除包体被截断；再看安全软件是否拦截主程序。这两步能覆盖大部分起不来的情形。
路由器端日志在哪看？
日志写在固件的系统日志里，用一条检索命令取最近十分钟即可。判定码与重启次数都在其中。
反馈要附什么才不用来回问？
判定码、版本号与端名、问题出现的时间点，三样齐了通常一轮就能定位。截图不如日志导出文件有用。
相关页面
按问题继续读，八页之间互不重复。