V2Ray 常见问题
订阅与连接排查

先区分内核与界面。V2Ray 属于 Project V 技术生态；V2Fly 与 Xray 是相关的内核家族，负责协议处理、路由和网络连接。v2rayN 是桌面图形客户端，v2rayNG 是 Android 图形客户端，负责导入配置和管理连接。v2flyNG 则是采用 V2Fly 内核的 Android 备选。安装客户端并不等于已经取得服务器配置，仍需导入有权使用的订阅或分享链接，再按服务提供方要求连接。

先看内容用途，不要只看链接外观。安装包用于安装客户端；节点分享链接描述一条服务器配置；订阅地址用于获取并更新一组服务器配置。把订阅地址粘贴到单节点导入入口，可能提示格式不识别；把网页登录地址当订阅地址，也可能只取得网页内容。应从服务提供方取得适配当前客户端的订阅链接，再在订阅分组设置中填写。订阅地址可能包含访问凭据，不要发到公开讨论区或提交到不熟悉的转换服务。

先分清流量在哪一层被处理。系统代理通知遵循系统设置的应用，把请求交给客户端的本地监听端口；路由分流决定进入内核的请求使用直连、代理还是阻断；TUN 通过虚拟网络接口接管匹配的流量。开启系统代理，不代表所有程序都会使用代理；开启 TUN，也不代表所有目标都走代理，内核路由仍会生效。排查时先关闭 TUN，确认普通系统代理能够访问，再单独测试 TUN，避免同时改动多层设置。

先确认已有有效配置。客户端用于管理连接，不会因为安装完成就自动获得可用服务器。延迟测试也只是某种测试方法在当时网络下的结果，不等于实际网页、下载或视频一定正常。TCP 测试主要反映端口连通情况，真实连接测试还会经过协议握手和测试目标。遇到数字正常但网页打不开，应继续检查服务有效期、系统时间、DNS 与路由。不要单凭一个延迟值反复切换内核，先保留同一配置做对照测试。

先查看设备处理器与系统架构。较新的主流 Android 手机通常可选 arm64 包，体积一般比包含多种架构的 universal 包小；不确定架构、使用较旧设备或遇到架构不匹配时，可尝试 universal。处理器支持 64 位不一定代表设备运行的是 64 位系统，应以设备系统信息和安装结果为准。如果仍提示无法安装，再检查 Android 系统要求、剩余空间以及是否存在不同签名的同名应用。更换签名前先导出配置，不要直接卸载唯一可用的客户端。

先选操作系统，再选处理器架构。Windows 桌面版采用跨平台界面，WPF 版保留经典 Windows 桌面界面，菜单布局和部分功能入口可能不同，不要混用两版的设置截图。macOS 在关于本机中查看芯片，Apple Silicon 选 arm64，Intel 选 x64。Linux 按发行版选择 deb 或 rpm，再确认设备是 x64 还是 arm64。安装包格式不能替代架构判断；出现无法启动时，先核对下载类型及当前版本的系统要求，再考虑重新安装。

先打开订阅分组设置，确认订阅地址已保存到正确分组，再执行该分组的更新订阅。仅保存地址不一定会立即填充服务器列表。检查地址是否夹带空格、换行或聊天软件附加的标点，同时确认当前列表没有筛选到其他分组。若返回内容是登录页、到期提示或网页错误信息，重复导入也不会生成节点，应先处理订阅权限。只有单条分享链接时，使用从剪贴板导入入口；仍不识别时，向提供方确认链接格式与客户端支持范围。

先关闭 TUN，检查普通系统代理能否连接，避免把服务器故障误判为权限问题。Windows 按客户端当前版本要求使用管理员权限或服务方式启动；Linux 检查所需权限和 TUN 设备是否可用；macOS 按系统提示授权。不要为排查而直接关闭整套系统防护。若虚拟网卡仍创建失败，退出其他接管网络的工具，再查看日志中的具体错误。不同系统、安装方式与内核的权限处理不完全相同，修复后应重新启动客户端并再次确认路由是否恢复正常。

先判断更新请求使用哪条网络路径。当前节点已经失效，而订阅更新又经过这个节点时，更新会被连接故障阻断，可尝试更新订阅(不通过代理)。如果订阅服务在当前直连网络下无法访问，则应先选择仍可用的节点，再使用通过代理的更新方式。两种方式都失败时，检查订阅有效期、设备时间、服务端响应及日志，不要不断重建分组。设置自动更新间隔前，先手动更新成功一次；间隔过短不能修复无效地址，还可能触发服务端请求限制。

先查看程序是否遵循系统代理。支持手动代理的程序，应填写客户端当前监听的协议、地址和端口；同一设备通常使用 127.0.0.1，端口以参数设置中的本地混合监听端口为准，不要默认所有版本都是 10808。终端工具可能读取 HTTP_PROXY、HTTPS_PROXY 或自身配置，需要单独核对，修改后重新启动终端再测。无法设置代理的应用才考虑 TUN。不要为了让本机程序连接而开启允许来自局域网的连接，这会扩大监听范围。

先确认请求确实进入当前客户端，再检查启用的是哪套路由规则。规则通常按顺序匹配，前面的宽泛规则可能先命中；域名、IP 和进程规则的作用对象也不同。使用 IPIfNonMatch 时，域名规则未匹配才会解析目标 IP 并继续尝试 IP 规则，不能把它理解为所有域名都强制先解析。保存后按需要重启服务，并关闭目标应用的旧连接再测。若应用使用自带代理或绕开系统代理，单改内核路由不会改变它的实际出口。

先使用客户端提供的导出或备份方式，记录订阅分组、本地监听端口、路由选择、DNS 设置和自定义配置。备份含有敏感信息，应保存在个人可控的位置。更新时先退出客户端，保留原配置与可回退的安装方式，再检查新版本是否能够读取配置。切换 Xray 或 sing-box 内核前，确认节点协议及自定义参数是否兼容；同一字段在不同内核中可能有不同要求。先测试一项改动，连接正常后再恢复自动更新、TUN 等附加功能。

先关闭客户端代理，确认普通网络能够访问，再核对订阅是否到期、设备时间是否自动同步。用同一节点对比当前网络与另一条可用网络，判断是否与接入网络有关；只测试一个节点，避免批量测试掩盖具体错误。随后查看日志，区分域名解析失败、连接超时、连接被拒绝和握手失败。端口可达并不代表协议参数正确，应核对地址、端口、传输方式及 TLS 设置。不要通过关闭证书验证来掩盖时间或证书问题，也不要把单次超时直接判定为客户端损坏。

先确认选中了有效服务器，并在 v2rayN 中选择自动配置系统代理。检查本地监听端口是否与系统代理中的端口一致，再暂时停用浏览器代理扩展，避免它覆盖系统设置。浏览器正常而终端失败时，单独检查终端环境变量；两者都失败时，查看客户端是否收到请求。日志没有请求，多半应继续查入口与代理设置；已有请求但报错，再查节点、DNS 和路由。退出客户端后仍无法直连时，重新打开客户端执行清除系统代理，再检查系统中是否残留手动代理。

先按日志中的错误类型分开处理。端口占用时，检查是否重复运行客户端或同时启动了其他代理程序；在 Windows 可用 netstat -ano 查找对应端口的进程号，确认进程用途后再退出，不要直接结束未知系统进程。也可在参数设置中修改本地混合监听端口，并同步更新手动代理配置。若错误是 DNS 解析失败，先确认服务器域名能够解析，再检查内核 DNS 与路由是否形成循环。不要同时修改端口、DNS 和节点参数，每次只改一项并保留前后日志。

先查看系统是否限制了 v2rayNG 的后台活动与电池使用，按设备设置允许必要的后台运行，并检查连接状态通知。Android 的 VPN 连接可能被另一个同类应用替换，应确认当前接管连接的应用。切换无线网络与移动网络后，先断开再重新连接，观察日志是否重新建立连接；若只在某条网络失败，继续查该网络的 DNS 和连通性。不要一开始就清除应用数据，先导出配置。持续掉线时，记录发生时间、网络类型和脱敏后的错误信息，再做进一步定位。