V2Ray 常见问题与配置排查

V2Ray 通常指 Project V 代理生态及相关内核能力。v2rayN 是面向 Windows、macOS 与 Linux 的桌面图形客户端，v2rayNG 是面向 Android 的图形客户端。客户端负责订阅、节点、路由和系统代理设置，内核负责实际建立连接与处理流量。

先以订阅提供方标注的协议和客户端建议为准。需要 VLESS、XTLS 或 REALITY 等能力时，通常选择 Xray 内核；已有配置明确依赖 V2Fly，或希望沿用原版配置体系时，可选择 V2Fly 内核。切换后应重新测试节点，不能只看导入是否成功。

协议不能只按名称判断速度。优先使用订阅已经提供且客户端内核完整支持的类型，再比较同一网络下的连接稳定性。VLESS 常与 TLS、REALITY 等传输方案组合，VMess 配置兼容面较广，Trojan 依赖正确的 TLS 参数，Shadowsocks 的配置相对直接。

订阅链接通常包含一组节点，并允许客户端按地址重新拉取更新；单个节点链接只描述一项连接配置。长期使用应保存订阅分组并执行更新，临时测试可以导入单个节点。删除订阅分组前先确认其中节点是否仍需保留。

系统代理模式主要接管遵循操作系统代理设置的应用，配置简单，适合浏览器和常见桌面程序。TUN 模式从虚拟网络接口接管更广范围的流量，适合不读取系统代理的应用，但需要额外权限。初次配置先用系统代理确认节点可用，再按需要启用 TUN。

先确认复制内容完整，开头和结尾没有空格、换行或中文标点。再用客户端的订阅管理功能新增地址，不要把订阅地址当作单个节点链接导入。若仍失败，记录客户端提示，检查系统时间、网络连接以及订阅地址是否已经失效。

导入成功有时只代表订阅地址已经保存，不代表内容已经下载。进入订阅分组后手动执行更新，并查看状态栏或日志中的返回提示。若分组仍为空，检查订阅是否选错、内容是否为空，以及客户端是否能识别返回的订阅格式。

先确认当前网络本身可以访问订阅地址，再暂时关闭异常的系统代理设置后重试。核对订阅地址是否过期，并检查系统日期、时间和时区。若客户端支持通过代理更新订阅，应只在已有可用节点时启用，避免更新请求被失效节点反复转发。

2015 年后发布的主流 Android 手机通常优先选择 arm64，安装包更精简。无法确认处理器架构、设备较旧，或 arm64 包提示不兼容时，再选择 universal 通用版。两个安装包的主要功能一致，不需要同时安装。

桌面版采用新一代跨平台界面，适合希望与 macOS、Linux 保持相近操作方式的用户。经典 WPF 版沿用 Windows 常见界面与操作路径，适合已有使用习惯的用户。两者不要放入同一配置目录混用，切换版本前应先导出必要配置。

先确认客户端处于运行状态，并且已选中一个可连接节点。随后检查系统代理开关是否确实开启，代理端口是否与客户端本地监听端口一致。部分应用会缓存启动时的代理设置，应完全退出后重新打开；仍不生效时，再检查应用是否使用了独立代理配置。

按顺序区分节点、代理和 DNS 三个环节。先切换另一个节点，再确认系统代理已开启，然后分别测试域名与直接连接能力。若只有域名访问失败，重点检查 DNS 设置；若所有请求都失败，查看日志中的握手、拒绝连接或超时提示。

确认修改的是当前启用的路由配置，而不是未选中的规则集。保存后重新加载配置，必要时重启客户端，使已有连接重新建立。检查规则顺序时要注意更宽泛的规则是否提前匹配；测试目标也应关闭旧连接，避免继续复用修改前的会话。

先保持配置简单，只设置一个明确可用的 DNS 方案，并确认系统时间正常。出现域名打不开但直接连接正常时，再检查 DNS 查询走直连还是代理、是否命中分流规则，以及系统缓存是否保留旧结果。修改后应清理缓存并重新建立连接。

TUN 需要创建虚拟网络接口，因此必须完成操作系统要求的授权。桌面端按客户端提示提升权限或安装所需服务，Android 端接受首次连接时的 VPN 服务授权。授权后仍失败，应退出其他占用虚拟接口的网络工具，再重新启动客户端。

先在同一订阅中测试多个节点。如果全部超时，优先检查本地网络、系统时间、客户端内核和防火墙；如果只有单个节点超时，通常应更换节点或更新订阅。测试结果只反映当次连接，切换网络后需要重新测试。

先校准系统日期、时间和时区，再核对节点地址、端口、SNI 与 serverName 是否和证书对应。不要把跳过证书验证作为常规处理方式，因为这会掩盖配置错误。若同一订阅的多个 TLS 节点同时报错，应优先检查系统环境和内核版本。

先确认下载的是与系统匹配的版本，并把程序放在当前账户可读写的普通目录。随后检查所需运行库是否已经安装、旧进程是否仍在后台，以及安全策略是否阻止程序启动。保留启动日志中的首条错误，比反复点击启动更容易定位原因。

先退出重复运行的客户端实例，再检查配置中的 HTTP、SOCKS 和 API 监听端口是否相互冲突。若其他程序已经使用该端口，可以结束对应进程，或把客户端改为一个未占用的本地端口。修改后同步检查系统代理中记录的端口。

先定位失败操作对应的时间段，再看第一条明确错误。timeout 多与连接路径或节点状态有关，connection refused 表示目标或本地端口拒绝连接，certificate 类提示应检查时间、SNI 和证书参数。连续重复信息通常是同一错误的后续结果。