v2rayNG 排查指南
v2rayNG 是安卓端最常用的 Xray/v2ray 系客户端之一：轻量、协议覆盖广、更新频繁。它与 Clash 系客户端的最大差异在于配置模型——v2rayNG 以单个节点配置为中心，分流规则相对简单，因此故障面更集中在订阅解析与节点配置本身。
订阅导入与更新
- 在服务商面板复制订阅地址（注意是订阅地址，不是节点单链接）；
- 主界面右上角
+→ 从剪贴板导入批量 URL 或☰→ 订阅分组设置 → 添加订阅地址； - 回到订阅分组页，点击 更新订阅 拉取节点列表。
更新订阅前先断开代理。旧节点已失效时，经由失效代理请求订阅会形成死锁，表现为一直转圈或超时——这是 SUB-001：订阅更新失败 里最常见的一种成因。
路由模式
设置页的 路由模式 决定哪些流量走代理：
- 绕过局域网及大陆地址：日常推荐，国内流量直连、境外走代理；
- 全局：所有流量走代理，排查时用它排除分流规则这个变量；
- 仅代理大陆地址：反向模式，普通用户不要选，误选后表现为境外网站全部打不开。
排查任何"部分网站不通"的问题，第一步都是切到全局复测。原理见系统代理。
日志在哪里看
v2rayNG 的日志入口是主界面 ☰ → 日志（部分版本在设置内）。这是判断内核是否正常启动的权威位置：
- 内核启动失败的日志通常包含
failed to parse或字段名相关错误 → 协议不被当前版本支持，升级应用； - 连接阶段的
dial tcp ... i/o timeout→ 节点不可达，对照 TCP-001； connection reset by peer→ 链路中途被重置，对照 TCP-003。
日志里的报错原文是提工单时最有价值的信息，但发送前确认不含订阅地址，参见订阅泄露处理。
常见现象对照
| 现象 | 可能原因 | 对应文档 |
|---|---|---|
| 导入订阅后没有节点 | 协议不受支持 / 订阅返回非节点内容 | 订阅返回网页 |
| 节点全部超时 | 网络限制 / 账号流量耗尽 | 所有节点同时超时 |
| 已连接但打不开网页 | 路由模式选错 / DNS 异常 | 已连接却无法上网 |
| 后台一段时间后断线 | 厂商省电策略 | Android 通用排查 |
| 提示证书或 TLS 错误 | 系统时间偏差 | 系统时钟偏差 |
| 部分应用不走代理 | 应用分流设置（每应用代理） | 浏览器能用应用不能用 |
安卓平台的两个额外变量
省电策略。国内厂商 ROM 会在后台清理 VpnService，表现为"锁屏一会儿就断"。判断方法：保持应用前台、屏幕常亮复测，前台稳定即可确认。处理方式见 Android 通用排查。
每应用代理。设置里的应用分流（允许/绕过指定应用）配置后容易被遗忘，日后出现"某个 App 不走代理"时先回来检查这份名单。
取证方法
安卓端没有 CLI 运行环境。取证走两条路：v2rayNG 的日志页取报错原文，同网络下的桌面设备对同一节点做分层检测：
connproof diagnose 节点域名 --port 节点端口桌面正常而手机失败 → 问题在安卓侧配置，回到本页逐项检查；两边一致失败 → 问题在链路或服务端，带证据找客服。判断责任边界的完整方法见是机场问题还是我的问题。