FAQ / CLIENT CHECKLIST
V2Ray 常见问题与客户端排查步骤
按基础认知、安装配置、使用技巧和故障排查四类整理。遇到问题时先确定发生环节，再按顺序核对网络、客户端、节点参数与系统设置，避免同时修改多项配置。
记录报错、平台和触发操作。
区分网络、节点或客户端问题。
每次只调整一个设置并复测。
BASICS
基础认知
先分清生态、内核、客户端、订阅和节点之间的关系，再进行安装或参数调整。
5 QUESTIONSV2Ray、v2rayN 和 v2rayNG 分别是什么？
V2Ray 通常指 Project V 相关协议、内核与工具生态，不是单一图形客户端。v2rayN 是用于 Windows、macOS 和 Linux 的桌面客户端，v2rayNG 是 Android 客户端；两者负责管理订阅、节点、路由与系统代理，并调用相应内核处理连接。
桌面端和 Android 应该选择哪个客户端？
Windows、macOS 与 Linux 优先选择 v2rayN，Android 优先选择 v2rayNG。若 Android 配置明确依赖 v2fly 内核，也可选择 v2flyNG；不要把不同客户端的安装包或平台配置文件混用。
Xray 内核与 v2fly 内核有什么区别？
两者都源自 Project V 生态，支持范围和功能演进方向并不完全相同。Xray 常用于 v2rayN 与 v2rayNG，v2fly 内核则与 v2flyNG 配套；选择时应以节点协议、传输参数和客户端实际支持情况为准。
VMess、VLESS、Trojan 和 Shadowsocks 应该怎么选？
先选择服务端已经提供且客户端内核明确支持的协议，不要只改协议名称而保留其他参数。VLESS 通常需要与 TLS、REALITY 或其他传输配置配套，VMess 依赖正确的用户标识，Trojan 重点核对密码与 TLS 域名，Shadowsocks 则要核对加密方式和密码。
订阅、节点和配置文件是什么关系？
订阅地址用于批量获取和更新节点，节点记录服务器地址、端口、协议与传输参数，配置文件还可能包含路由、DNS 和入站设置。更新订阅通常会替换订阅分组中的节点，但不一定覆盖客户端的全局路由与界面设置。
INSTALLATION
安装配置
安装包架构、订阅入口和客户端版本需要与设备平台对应，导入后还应执行一次更新验证。
5 QUESTIONS订阅链接导入后没有出现节点怎么办？
先确认导入入口是订阅管理而不是单节点导入，再检查链接是否完整、前后是否混入空格或换行。随后手动执行一次更新订阅并查看日志；若返回内容为空或格式无法识别，需要向订阅提供方确认地址状态与输出格式。
v2rayN 订阅更新失败先检查什么？
先用浏览器确认订阅地址能够访问，再核对系统日期、时间和时区是否准确。之后检查 v2rayN 的订阅分组地址、更新代理设置与日志中的 HTTP 状态；旧地址失效时应替换地址，而不是反复刷新同一条记录。
Android 安装包的 arm64 与 universal 怎么选？
2015 年后发布的大多数主流 Android 手机可优先选择 arm64，包体通常更精简。无法确认处理器架构、设备较旧或 arm64 安装失败时再选择 universal；同一客户端保留一个可正常更新的安装来源即可。
v2rayN 桌面版与经典 WPF 版有什么区别？
桌面版采用新一代跨平台界面，适合希望在不同桌面系统保持相近操作方式的用户。经典 WPF 版面向 Windows，界面和设置路径更接近既有使用习惯；已有稳定配置时不必仅为界面差异频繁切换版本。
macOS 下载时如何判断 Apple Silicon 与 Intel？
打开系统信息或关于本机，芯片字段显示 Apple M 系列时选择 Apple Silicon 版本，处理器字段显示 Intel 时选择 Intel 版本。安装包架构不匹配可能导致无法启动或需要额外兼容层，因此应先确认芯片类型。
USAGE
使用技巧
连接状态只代表客户端已启动链路处理，还需要检查系统代理、TUN、路由规则和应用自身设置。
5 QUESTIONS客户端显示已连接但网页无法打开怎么办？
依次检查当前节点是否可用、系统代理或 TUN 是否真正启用，以及浏览器是否使用了独立代理设置。再切换到规则较简单的路由模式测试，并查看日志中是 DNS 解析失败、连接超时还是 TLS 报错，避免同时修改多个参数。
浏览器可以访问但终端没有走系统代理怎么办？
浏览器通常读取系统代理，许多终端程序则不会自动读取。可为当前终端设置 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY 环境变量，并确认端口与客户端本地入站一致；也可以使用 TUN 模式接管需要覆盖的网络流量。
启用 TUN 模式时提示权限不足怎么处理？
TUN 需要创建虚拟网络接口并调整系统路由，因此通常需要管理员权限或系统的 VPN 授权。桌面端可按系统提示提升权限，Android 端应接受 VpnService 授权；若仍失败，先关闭其他占用虚拟接口的网络工具再重试。
全局、规则和直连模式应该怎么用？
全局模式将匹配流量统一交给代理出站，适合临时验证节点是否工作；规则模式按域名、IP 或进程规则选择出站，适合日常使用；直连模式主要用于排除客户端接管带来的影响。排查时先用全局模式验证链路，再回到规则模式检查匹配顺序。
V2Ray 节点测速结果应该怎么看？
延迟测试只反映探测请求的响应时间，不等同于实际下载速度和持续稳定性。应在相同网络、相近时间和相同测试方式下比较，并结合连接成功率、网页打开情况与连续传输表现判断，不要仅按一次延迟结果排序。
DIAGNOSIS
故障排查
先保留错误现场和日志，再从网络连通、时间、域名、端口、DNS 与系统权限逐层检查。
5 QUESTIONS节点连接超时应该按什么顺序排查？
先确认设备本身可以正常联网，再切换同一订阅中的其他节点判断是单节点问题还是整体链路问题。随后核对服务器地址、端口、协议、传输方式和安全层参数，并检查本地防火墙、路由器或网络环境是否阻断对应连接。
TLS 握手失败或证书错误怎么处理？
先校准设备日期、时间与时区，再核对 serverName 或 SNI 是否与证书域名一致。还要确认节点地址、TLS 开关、传输层和指纹参数来自同一份配置；不要把跳过证书验证作为长期解决办法。
连接后出现 DNS 解析失败怎么办？
先判断是所有域名都失败还是只有特定域名失败，并测试直接访问 IP 是否可行。之后检查客户端 DNS 配置、路由规则对 DNS 请求的处理、系统缓存与本地端口占用；修改后应重启客户端并清理系统 DNS 缓存再验证。
Android 客户端切到后台后经常断开怎么办？
把 v2rayNG 或 v2flyNG 加入系统省电白名单，并允许后台运行与必要的网络活动。部分系统会在锁屏后限制 VpnService，应同时检查应用自启动、后台活动和电池优化设置，完成后重新建立连接并锁屏测试。
客户端启动失败或频繁崩溃如何定位？
先记录发生问题前执行的操作，并查看客户端日志中最后一段错误信息。随后确认安装包架构与系统匹配、配置文件能够解析、磁盘空间充足，再暂时移走最近新增的配置或规则；若旧配置可启动，可逐项恢复以定位具体原因。