V2RAY TROUBLE INDEX
V2Ray 常见问题与配置排查
按基础认知、安装配置、使用技巧与故障排查分类，处理订阅导入、节点超时、系统代理、TUN、路由和 DNS 等高频问题。
QUESTION CATEGORIES
按问题类型定位
先选择最接近当前现象的分类。无法确定时，从故障排查开始，按日志与流量路径逐层缩小范围。
01 / BASICS
基础认知
先分清客户端、内核和流量接管方式，避免在错误的配置层反复修改。
v2rayN、v2rayNG 与 v2flyNG 应该怎么选？
Windows、macOS 与 Linux 桌面环境优先使用 v2rayN；Android 通常先选采用 Xray 内核的 v2rayNG，需要 v2fly 内核时再考虑 v2flyNG。选择客户端时先按操作系统筛选，再确认订阅提供方要求的协议、传输方式与内核兼容性，不要仅根据界面名称判断。
V2Fly 内核与 Xray 内核有什么区别？
两者都属于 Project V 相关生态，基础配置概念相近，但协议扩展、传输能力、配置字段与发布节奏并不完全一致。v2rayNG 通常使用 Xray 内核，v2flyNG 使用 v2fly 内核。导入配置前应确认客户端内核能否识别对应协议和传输参数，遇到不支持字段时不要直接删除字段，应先核对配置来源的要求。
订阅、节点与配置文件分别是什么？
订阅是用于批量获取和更新节点信息的地址；节点是一组具体的服务器、端口、认证与传输参数；配置文件则可以同时包含入站、出站、DNS 和路由规则。订阅更新会改变分组内的节点列表，但通常不会自动替换全部本地路由设置，排查时需要分开确认订阅内容与客户端本地设置。
系统代理、全局代理、规则分流与 TUN 模式有什么区别？
系统代理是把代理地址写入操作系统设置，主要影响遵循系统代理的程序；全局代理表示匹配到的流量统一交给代理出站；规则分流会按域名、IP 或进程决定直连、代理或拦截；TUN 模式通过虚拟网络接口接管更广范围的流量。排查时先明确当前使用哪一层，否则容易把路由问题误判成节点问题。
arm64 与 universal 安装包应该怎么选？
近年的主流 Android 设备通常使用 arm64 架构，优先选择 arm64 包可减少不需要的架构文件。无法确认设备架构，或 arm64 包提示不兼容时，再使用 universal 通用包。通用包覆盖的架构更多，文件通常更大，但客户端功能与同版本 arm64 包基本一致。
02 / SETUP
安装配置
导入问题先检查链接与返回内容，代理问题先检查本地监听和操作系统设置。
v2rayNG 怎样导入订阅链接？
打开 v2rayNG 的订阅分组设置，新建分组并粘贴完整订阅地址，保存后返回主界面执行更新订阅。更新完成后，从对应分组选择节点并启动连接。若列表没有变化，先确认更新的是刚创建的分组，再检查地址前后是否带有空格、链接是否完整，以及日志中是否出现网络或解析错误。
粘贴订阅链接后提示导入失败怎么办？
先删除链接首尾的空格和换行，确认没有把网页说明文字一起复制。随后用浏览器测试该地址是否能正常返回内容，并核对设备日期、时间与时区。地址可访问但客户端仍失败时，查看日志中是证书连接失败、响应为空还是内容格式无法识别，再分别检查网络环境、订阅状态或客户端版本。
订阅更新失败或一直显示旧节点怎么处理？
确认当前更新目标是正在使用的订阅分组，而不是另一个同名分组；检查订阅地址是否过期、是否被误删参数，并查看更新日志的响应状态。若服务端已经更新而本地仍显示旧内容，可先备份必要的自定义节点，再删除并重新创建该订阅分组。不要在未备份时直接清空全部配置。
单个分享链接可以导入，但订阅地址无法导入是什么原因？
单个分享链接与订阅地址的处理流程不同：前者直接解析一个节点，后者需要先请求远端内容，再识别订阅格式并批量写入。单节点可用只能说明协议参数能够解析，不能证明订阅接口正常。应继续检查订阅地址的访问结果、返回内容格式、访问权限以及客户端日志中的订阅解析错误。
v2rayN 已启动，但系统代理没有生效怎么办？
先在 v2rayN 中确认系统代理模式不是关闭状态，再打开操作系统代理设置，核对地址是否指向本机以及端口是否与客户端本地监听端口一致。若设置会自动恢复，检查是否有其他代理工具或管理策略反复改写。修改后重新打开浏览器测试，同时通过客户端日志确认请求是否进入本地入站。
03 / USAGE
使用技巧
测速用于筛选，日志用于确认；路由模式与流量接管方式需要配套设置。
节点测速应该看 ping、真连接延迟还是下载速度？
ping 主要反映 ICMP 网络往返时间，可能不经过完整代理握手；真连接延迟会建立实际代理连接，更适合判断节点能否工作；下载测速还会受到出口带宽、测试服务器和并发策略影响。选择节点时先用真连接延迟排除不可用项，再用实际网页或下载任务观察稳定性，不应只按单次 ping 排序。
怎样设置 V2Ray 全局代理？
先选择可正常连接的节点，再把客户端路由模式切换到全局或将默认出站设为代理，随后根据程序类型启用系统代理或 TUN 模式。全局模式会让更多流量经过代理，排查结束后如需恢复分流，应切回规则模式并确认规则集已加载。仅切换路由模式但没有启用流量接管方式，程序仍可能直连。
TUN 模式提示权限不足或无法创建接口怎么办？
桌面端先退出客户端，再使用具备相应权限的方式启动，并确认系统没有阻止虚拟网络接口或相关服务。Android 端需要允许客户端创建 VPN 连接，同一时间通常只能由一个此类连接接管流量。若接口创建后立即停止，查看日志中的驱动、路由表或端口占用信息，并暂时关闭其他网络接管工具后重试。
路由规则为什么没有按预期直连或代理？
路由通常按规则顺序匹配，先命中的规则决定出站。先检查目标域名或 IP 实际匹配了哪一条，再核对该规则引用的出站标签是否真实存在。域名规则还会受到解析结果与嗅探设置影响。修改规则后应重新加载配置，并从日志确认命中的规则和最终出站，而不是只观察网页是否打开。
开启代理后 DNS 应该怎样检查？
先判断问题发生在域名解析还是代理连接：直接访问已知 IP 能通而域名不通时，优先检查 DNS。核对客户端 DNS 服务器、查询策略、域名规则与出站标签，避免解析请求被送到不存在的出站。若系统缓存了旧结果，可在修改配置后清理系统 DNS 缓存并重启客户端，再从日志确认查询是否成功返回。
04 / DIAGNOSE
故障排查
从是否有日志开始判断，再沿本地入站、路由、DNS、节点握手和远端出站逐层检查。
所有节点都显示超时应该从哪里开始排查？
先确认设备本身可以正常联网和获取订阅，再检查系统时间、客户端内核是否启动、本地端口是否被占用。随后任选一个节点查看完整日志，区分域名解析失败、TCP 连接超时、TLS 握手失败和认证失败。若所有节点在同一阶段失败，优先排查本地网络、DNS 或客户端设置，而不是逐个修改节点。
客户端显示已连接，但浏览器无法上网怎么办？
已连接只表示客户端进程或虚拟接口处于运行状态，不代表节点握手和流量转发已经成功。先确认选中了具体节点，再检查系统代理或 TUN 是否真正接管浏览器流量。打开一个网页的同时观察访问日志：没有新记录说明流量未进入客户端；有记录但出站失败，则继续检查节点、路由与 DNS。
浏览器可以访问，但其他程序不走代理是什么原因？
浏览器可能单独使用了系统代理或自身代理设置，而目标程序可能忽略系统代理、只使用 UDP，或拥有独立网络配置。先检查该程序是否支持手动填写 HTTP 或 SOCKS 代理；需要接管更多程序时可评估 TUN 模式。启用后仍无流量记录，应检查进程分流规则、虚拟接口路由和程序是否绕过了本地网络栈。
V2Ray 连接速度慢或时快时慢怎么排查？
先用真连接延迟排除握手不稳定的节点，再在相同时间、相同目标下对比多个节点，避免把目标网站波动当成代理问题。检查是否启用了不必要的全局代理、复杂规则或重复 DNS 查询，并观察日志是否频繁重连。若小文件正常而大文件慢，还应考虑出口带宽、传输参数和本地网络丢包。
导入配置后客户端崩溃或内核反复退出怎么办？
先记录日志中的首个配置错误，而不是只看最后一行退出提示。常见原因包括当前内核不识别某个字段、端口冲突、路由规则引用了不存在的标签，或配置内容在复制时被截断。可暂时切换到一个已知可用的基础配置验证客户端本身，再逐段恢复 DNS、路由和高级传输设置，以定位具体配置段。
DEEP TROUBLESHOOTING
按症状继续排查
需要完整流程时，故障排查页按无法上网、节点超时、订阅失败、速度慢、DNS、系统代理、客户端退出与移动端问题分章说明。