v2rayN 订阅导入后无法连接怎么办？按日志排查
简答：v2rayN 订阅导入成功，只代表客户端解析出了配置，不代表节点一定可用。最快的处理顺序是：先确认普通网络，再更新订阅并检查节点数量，随后运行真连接测试，最后检查系统代理、时间、协议参数和本地端口。
定义：“订阅导入后无法连接”是指 v2rayN 已保存订阅或显示节点，但节点真连接失败、延迟测试失败，或连接成功后浏览器仍无法访问网络。
先用 5 分钟判断故障在哪一层
本站是第三方使用指南站，不是 v2rayN 或任何订阅服务的官方页面。v2rayN 官方 Wiki 将订阅地址定义为可正常访问的 URL，并列出 VMess、Shadowsocks、SOCKS、VLESS、Trojan、Hysteria 2、TUIC、WireGuard 和 AnyTLS 等支持类型；实际可用范围还取决于当前版本和内核。查看 v2rayN 订阅功能说明
| 现象 | 优先判断 | 先做什么 |
|---|---|---|
| 订阅分组存在，但没有节点 | 订阅获取或内容解析失败 | 重新检查订阅地址，查看更新日志和返回内容 |
| 有节点，但全部真连接失败 | 订阅失效、核心、时间、网络或公共参数问题 | 换同一分组的另一个节点，再看核心日志 |
| 只有一个节点失败 | 该节点参数或线路问题 | 先保留其他节点，不要立即删除整个订阅 |
| 节点显示可用，但浏览器打不开 | 系统代理未启用或浏览器未遵循系统代理 | 选择节点、启动核心，再检查系统代理状态 |
| 更新后节点突然消失 | 返回内容为空、格式变化或筛选规则排除了节点 | 检查订阅分组的过滤条件和更新结果 |
- 断开 v2rayN，确认普通网页能否打开；如果直连网络本身异常，先处理 Wi-Fi、网线、路由器或系统网络。
- 在 v2rayN 的订阅分组菜单中执行更新，确认更新结果不是“成功下载但解析失败”。
- 确认列表中仍有节点，并单独选择一个节点运行客户端提供的真连接测试；不要只根据节点列表或延迟数字判断可用性。
- 确认当前节点已被选中，核心已经启动，并启用了系统代理；然后重新打开浏览器测试。
订阅更新失败：先检查地址和返回内容
订阅地址能被保存，不等于更新时返回了正确的订阅内容。v2rayN 官方说明订阅更新会下载内容、解析内容，并在成功后处理当前分组；因此“分组存在”“更新完成”“节点被解析”和“节点实际连接成功”是四个不同阶段。查看 v2rayN 界面与订阅更新逻辑
- 打开订阅分组编辑窗口，检查 URL 是否完整，尤其是复制时有没有漏掉末尾字符、换行或必要的参数。
- 在浏览器中打开订阅地址时，不要把返回内容发布到公开页面。重点观察它是否返回登录页、验证码页、普通 HTML 错误页、空内容或提示订阅失效。
- 如果更新后列表为空，暂时关闭别名正则过滤、订阅转换和其他可选处理，只保留原始订阅地址再次更新。
- 如果浏览器能看到内容，但 v2rayN 报 Base64 或解析错误，保留错误原文，并记录客户端版本、内核类型和更新时间，不要反复删除订阅。
官方 GitHub 中曾记录过一种可复现情况：订阅服务器返回 gzip 压缩内容时，客户端显示已获取内容，但后续 Base64 解析失败；同一内容复制到剪贴板后可以正常导入。该案例针对特定版本和返回头，不能直接推断所有订阅都存在同一问题。查看 v2rayN 订阅压缩内容解析案例
按日志关键词处理节点连接失败
| 日志关键词或现象 | 常见含义 | 可操作处理 |
|---|---|---|
timeout、i/o timeout | 目标地址或端口在规定时间内没有完成连接 | 换同分组的另一个节点；确认本机网络正常；暂时关闭可能接管网络的其他工具后复测。 |
connection refused | 目标端口拒绝连接，或本地服务端口没有监听 | 分别测试其他节点；如果日志指向本机地址，检查 v2rayN 本地端口是否被其他程序占用。 |
TLS handshake、tls: internal error | TLS 参数、SNI、证书或协议协商不匹配 | 不要凭感觉改参数；重新更新原始订阅，核对地址、端口、传输方式、SNI、REALITY 公钥、shortId 和 flow 是否被截断。 |
NotTimeValid | 证书有效期校验与本机日期时间不一致 | 打开 Windows“设置”→“时间和语言”→“日期和时间”，启用自动设置时间和自动设置时区，再点击立即同步，重启核心后复测。 |
Base64、invalid base64 | 返回内容不是预期编码，或内容被网页、压缩数据、错误页替代 | 检查订阅 URL 的实际返回内容；不要把 HTML 错误页当成节点列表导入。 |
address already in use、port already in use | 本机监听端口已被其他进程占用 | 关闭重复运行的 v2rayN 或其他代理程序，再启动；仍冲突时在客户端本地端口设置中改用未占用端口。 |
如果所有节点都同时失败，优先检查订阅更新、系统时间、核心启动和本机网络；如果只有一个节点失败，优先把它视为单节点参数或线路问题。一次只改一个变量，并在每次修改后重新运行真连接测试，这样才能知道哪一步产生了变化。
连接成功但网页打不开：检查系统代理和 DNS
- 在 v2rayN 中选择一个节点并启动核心，确认托盘或主界面显示运行状态。
- 启用客户端的系统代理开关，再关闭浏览器后重新打开。部分应用使用自己的代理设置，不一定遵循 Windows 系统代理。
- 如果浏览器仍打不开，检查浏览器是否单独设置了手动代理、扩展代理或代理自动配置脚本；先恢复为跟随系统代理，再测试。
- 如果仅部分域名打不开，查看客户端的路由和 DNS 设置。v2rayN Wiki 说明，Xray 与 sing-box 对直连 DNS、远程 DNS 和代理目标解析的用途并不完全相同，改 DNS 前先确认当前使用的核心。查看 v2rayN DNS 设置说明
- 如果启用了 TUN、FakeIP 或其他网络接管功能，先关闭它们进行一次对照测试；能够恢复访问时，再逐项启用并观察是哪一项造成冲突。
不要把“延迟有数字”当成“浏览器一定能访问”。延迟测试、节点真连接、系统代理接管和具体应用是否遵循代理，是四个不同的验证环节。
最后再检查协议参数是否被转换或截断
如果订阅经过转换服务、复制粘贴或格式迁移，重点核对以下字段：服务器地址、端口、UUID 或密码、传输方式、TLS 开关、SNI、REALITY 公钥、shortId、flow，以及使用的核心类型。v2rayN 官方订阅说明列出了多种标准分享链接和 v2rayN 内部格式；字段能否完整保留取决于来源格式和当前解析实现。查看官方支持格式说明
- 优先用原始订阅重新生成节点，不要把多个转换结果叠加。
- 保留原订阅分组，另建一个测试分组验证，避免覆盖仍可用的配置。
- 记录“更新前后节点数量、所选节点名称、核心类型、完整错误关键词”，联系订阅提供方时只提交必要信息，并遮盖订阅地址中的身份信息。
- 如果只有某一类协议失败，而其他协议可用，先确认当前核心是否支持该协议，再查看该协议的具体字段。
排查完成后的复测清单
- 直连网络正常，且断开 v2rayN 后能打开普通网页。
- 订阅地址完整，更新结果没有登录页、空内容或解析错误。
- 节点列表仍存在，且至少有一个节点通过真连接测试。
- 客户端核心已启动，节点已选中，系统代理已启用。
- 本机日期、时间、时区正确，没有证书时间错误。
- 没有其他网络接管软件、重复客户端或本地端口占用。
- 浏览器没有覆盖系统代理的独立设置。
- 每次只修改一个设置，并保留修改前后的日志。
如果完成以上检查仍无法连接，最有价值的信息不是“连不上”，而是：所有节点还是单个节点失败、订阅是否能在浏览器返回正常内容、真连接测试的错误关键词，以及使用的核心类型。用这些信息继续定位，比直接重装客户端更有效。
常见问题
v2rayN 导入订阅成功，为什么还是无法连接？
导入成功只说明订阅内容被保存或解析出了配置，不代表节点已经通过真实连接测试。请依次检查节点是否存在、核心是否启动、节点是否选中、真连接测试结果以及系统代理是否启用。
v2rayN 更新订阅后节点全部消失怎么办？
先不要删除分组。检查订阅地址是否完整、浏览器返回的是否为正常订阅内容，并暂时关闭别名过滤、订阅转换等可选设置后重新更新。如果日志出现 Base64 或 Failed to import subscription content，保留完整错误信息。
只有一个节点连不上，是订阅失效吗？
不一定。单个节点失败更像是该节点地址、端口、TLS、SNI、REALITY 或 flow 参数异常，也可能是单条线路不可达。先用同一订阅中的其他节点进行对照，不要立即重装客户端。
出现 NotTimeValid 应该怎么处理？
这通常表示证书有效期校验与本机时间不一致。打开 Windows“设置”→“时间和语言”→“日期和时间”，启用自动设置时间和时区并立即同步，随后重启 v2rayN 核心再测试。
节点延迟正常，为什么浏览器还是打不开？
延迟测试不等同于浏览器流量已经经过代理。确认已选择节点、核心已启动、系统代理已启用，并检查浏览器是否设置了独立代理或代理扩展。