v2rayNG 连接失败怎么办？按订阅、节点、VPN 权限和 DNS 排查
简答：先不要重装：打开 v2rayNG 日志，先确认是订阅更新失败、节点测试失败、VPN 启动失败，还是显示已连接但网页打不开。最快路径是切换手机网络、重新更新订阅、连续测试多个节点、确认 Android VPN 权限与其他 VPN 状态，再临时用全局路由复测；能打开测试网页且日志不再出现超时或解析错误，才算排查成功。
定义：v2rayNG 连接失败，是指客户端无法通过当前配置建立可用的 VPN 隧道，或隧道显示已启动但实际流量未能正常经过节点。
先试这一步：3 分钟判断故障在哪一层
本文是独立使用指南，不代表任何客户端项目或服务商的官方页面。v2rayNG 项目仓库将其描述为 Android 客户端，并说明支持 Xray core 和 v2fly core；项目 README 同时把发布文件入口指向其 GitHub Releases 页面。版本和界面会变化，本文不把某个版本号当作固定结论，下载或升级前请以当前发布页为准：项目仓库、当前 Releases 页面。
| 现象 | 先检查 | 判断 | 下一步 |
|---|---|---|---|
| 订阅更新失败、没有新节点 | 手机能否打开普通网页；订阅地址是否完整 | 客户端还没有得到有效配置 | 切换 Wi-Fi/移动数据，重新更新订阅；仍失败时核对订阅状态 |
| 节点测试全部失败 | 连续测试多个节点；查看日志中的超时、解析或握手提示 | 可能是节点、网络路径或配置字段问题 | 换网络并换节点；不要同时修改 DNS、路由和节点参数 |
| 点击启动后立刻停止 | Android VPN 授权、其他 VPN、始终开启 VPN | 可能是系统 VPN 服务冲突或权限状态异常 | 关闭其他 VPN，检查系统 VPN 设置后重新启动 |
| 显示已连接但网页打不开 | 全局/规则模式、分应用代理、私密 DNS、Wi-Fi 手动代理 | 隧道可能已建立，但流量没有按预期转发 | 临时切换全局模式复测，再恢复原模式定位规则问题 |
成功判据：至少一个节点可以完成真实连接测试；浏览器能够打开普通测试页面；切换 Wi-Fi 或移动数据后仍能重复连接；关闭客户端后手机网络可以恢复。
按顺序排查：每次只改一个设置
- 确认手机本身能上网。先完全停止 v2rayNG，使用浏览器打开一个平时可以访问的页面，再分别切换 Wi-Fi 和移动数据。若两种网络都无法正常联网，先修复 Android 本地网络，客户端排查暂时没有意义。
- 更新订阅并确认配置确实存在。在 v2rayNG 中找到订阅分组或订阅管理区域，执行更新操作。不同版本可能使用不同菜单名称；如果找不到，可在应用设置或订阅列表中搜索“订阅”“更新”“分组”等关键词。更新后确认列表中出现节点，而不是只有空分组、错误文本或明显不完整的配置。不要把订阅地址、分享链接和本地配置文件混用。
- 连续测试多个节点。先选同一分组中的多个节点执行测试，记录“全部失败”还是“只有个别失败”。如果只有单个节点失败，优先暂时换节点；如果多个节点在同一网络下都失败，再检查本地网络、VPN 权限、系统时间和订阅状态。不要因为一个节点失败就修改全部协议字段。
- 重新确认 Android VPN 授权。启动客户端时，Android 通常会通过系统 VPN 服务询问是否允许应用建立 VPN。若系统设置中已有其他 VPN 正在运行，先停止或断开它；Android 每个用户或工作资料通常只能有一个活动 VPN 服务，启动新的 VPN 服务会停止已有服务，具体行为可参考 Android VPN 官方文档。如果系统 VPN 页面启用了“始终开启”或“未连接 VPN 时阻止连接”，先暂时关闭后复测，避免把系统拦截误判为节点故障。
- 临时切换全局模式。如果客户端显示已连接，但只有部分应用打不开，先把路由模式临时切换为全局或等价的全量代理模式，再用浏览器复测。全局模式能访问而规则模式不能访问，通常说明问题更接近分流、域名规则或分应用设置；全局模式也不能访问，则继续查节点、DNS、系统网络和日志。测试完成后恢复原来的路由模式。
- 检查 Wi-Fi 手动代理和私密 DNS。进入当前 Wi-Fi 网络详情，查看是否手动设置了代理；如果代理地址和端口不是你主动配置的，可先恢复为无代理后复测。再到 Android 网络设置中查看“私密 DNS”，如果填写了自定义主机名，临时改为自动或关闭进行对照测试。不同厂商的菜单路径不同，建议在系统设置搜索“VPN”“私密 DNS”“代理”“电池优化”。
- 检查时间与后台限制。系统日期、时间或时区明显不正确时，可能影响依赖 TLS 的连接；先打开自动设置日期和时间。若锁屏后容易断开，进入应用电池设置，将 v2rayNG 的后台活动限制调整为系统允许的选项，再进行一次锁屏和解锁复测。厂商系统的名称不同，不要直接照搬其他品牌的菜单路径。
Android 官方文档说明，始终开启 VPN 可以持续维持 VPN 服务，也可以阻止不经过 VPN 的连接；因此，开启“未连接 VPN 时阻止连接”后，如果隧道无法建立，其他应用也可能表现为没有网络。排查期间应先确认这类系统开关的状态，再判断客户端或节点是否故障：Android VpnService API 文档。
看日志定位：超时、解析、端口和证书分别怎么处理
日志菜单的名称和展示方式可能随版本变化，通常可以从主界面、侧边菜单或设置中查找“日志”“运行日志”“清空日志”等入口。下面的关键词只用于缩小排查范围，不是 v2rayNG 官方错误码定义。
| 日志线索 | 优先检查 | 处理方式 |
|---|---|---|
timeout、i/o timeout、handshake timeout | 当前网络、节点地址、端口和节点可用性 | 切换 Wi-Fi/移动数据，再测试多个节点；不要先改 DNS |
lookup、no such host、解析失败 | 域名解析、私密 DNS、DNS 设置和订阅内容 | 先将私密 DNS 改为自动或关闭进行对照，再更新订阅 |
connection refused、端口拒绝 | 节点端口、配置字段、服务端监听状态 | 重新导入或更新配置，并换另一个节点交叉测试 |
x509、证书或 TLS 错误 | 系统时间、域名、TLS 参数和证书配置 | 先校准系统时间；不要为了绕过错误随意关闭证书校验 |
| 启动后无明显日志、立即断开 | VPN 权限、其他 VPN、始终开启 VPN 和后台限制 | 先停止其他 VPN，重新授权，再从前台启动客户端 |
如果日志只显示连接尝试而没有明确错误，先保存当前配置或截图，然后只做一次网络切换或节点切换。成功后再逐项恢复设置，这样可以知道到底是哪一步产生变化。
“节点测速成功”不等于“真实连接成功”
节点测速、TCP ping 或类似测试，通常只能说明某个地址或端口在当前测试方式下有响应；它不能单独证明浏览器流量、DNS 请求和所有应用都能正常通过。v2rayNG 的发布说明中曾列出 TCP ping 测试、订阅更新后自动测试等功能，但具体按钮和行为应以当前版本页面为准：v2rayNG Releases。
- 先运行节点测试，记录是否只有一个节点失败。
- 再启动 VPN，使用浏览器打开一个普通测试页面。
- 如果浏览器能打开但某个应用不能，检查分应用代理、应用自身网络权限和规则模式。
- 如果节点测试成功但浏览器仍打不开，切换全局模式，并检查 DNS、浏览器安全 DNS 和 Wi-Fi 手动代理。
- 如果全局模式也失败，回到节点、订阅、VPN 权限和日志，不要继续堆叠设置。
测试结束后，关闭 VPN 并确认手机恢复正常联网；如果关闭客户端后仍无法联网，检查 Android 的始终开启 VPN和“未连接 VPN 时阻止连接”开关。
最后处理：清除数据、重装和反馈前要保留什么
清除应用数据或重装应放在最后，因为这可能删除本地节点、订阅分组、路由选择和应用偏好。执行前先保存必要的订阅地址或配置文件，并记录当前客户端版本、Android 版本、网络类型、失败节点名称、日志关键词和是否更换网络后仍失败。不要在公开反馈中粘贴完整订阅地址、服务器密钥或个人账号信息。
- 先导出或备份仍需要的本地配置。
- 记录问题发生前最后一次成功连接的大致时间，以及是否更换过网络或系统设置。
- 仅清除应用缓存或重启应用作为低风险对照；清除数据前确认已经保存配置。
- 重新安装后只导入一个配置或一个订阅，先测试一个节点，再恢复其他设置。
- 若多个节点、多个网络和干净配置都失败，再向服务商反馈，而不是继续反复重装。
反馈时至少提供：Android 系统版本、v2rayNG 页面显示的版本、订阅更新时间是否成功、失败节点是否全部失败、当前使用的 Wi-Fi 或移动数据、日志中的关键错误，以及是否存在其他 VPN 或始终开启 VPN。无法确认的版本、服务状态和节点状态，应直接标注“未核实”。
排查完成后的核对清单
- 手机在停止 v2rayNG 时可以正常联网。
- 订阅更新成功，节点列表不是空的，也没有明显残缺内容。
- 至少测试过两个或更多节点，并记录了结果差异。
- Android VPN 权限已允许，其他 VPN 已停止。
- 没有把始终开启 VPN 或“未连接 VPN 时阻止连接”误当成客户端连接状态。
- Wi-Fi 手动代理、私密 DNS 和系统时间已经完成对照测试。
- 全局模式与原规则模式的结果已经分别记录。
- 浏览器真实访问和单个应用访问已区分测试。
- 重装或清除数据前已经保存需要的配置。
常见问题
v2rayNG 连接失败，应该先换节点还是先重装？
先换网络并连续测试多个节点，再检查 VPN 权限、其他 VPN、订阅更新和日志。重装会删除本地配置，应保存订阅或配置后再考虑。
v2rayNG 显示已连接，但浏览器打不开网页怎么办？
先确认手机本身能上网，再临时切换全局或全量代理模式复测；同时检查分应用代理、Wi-Fi 手动代理、私密 DNS、系统时间和浏览器自身的安全 DNS。全局模式能用而规则模式不能用时，优先排查路由规则。
节点测速成功，为什么启动后仍然连接失败？
测速只代表某种测试请求得到了响应，不等于真实应用流量一定可用。请启动 VPN 后用浏览器实际访问，再结合日志判断是 DNS、TLS、端口还是路由问题。
Android 上有其他 VPN，会影响 v2rayNG 吗？
可能会。Android 官方文档说明，一个用户或工作资料只能有一个活动 VPN 服务；排查时先停止其他 VPN，再重新启动 v2rayNG。
要不要关闭私密 DNS？
不要直接长期关闭。可以把私密 DNS 临时改为自动或关闭，只做一次对照测试；如果问题消失，再结合日志中的解析错误判断是否需要调整 DNS 或网络配置。
v2rayNG 连接失败时，应该向服务商提供什么？
提供 Android 版本、客户端页面显示的版本、订阅更新时间结果、失败节点范围、网络类型、日志关键词，以及是否有其他 VPN、始终开启 VPN或分应用代理。不要提交完整订阅地址、密钥和账号信息。