// CLIENT FAQ

V2Ray 客户端常见问题

从现象出发检查配置。内容覆盖基础概念、安装配置、订阅与分流操作,以及 v2rayN、v2rayNG 常见连接故障。

// 01 · CONCEPT

基础认知

先分清客户端、内核、协议与订阅,后续配置和排查才不会混在一起。

V2Ray 是协议、内核还是图形客户端?

V2Ray 通常指 Project V 相关的代理技术生态,不是某一个固定安装程序。V2Fly 与 Xray 属于常见内核家族,负责解析配置、建立连接和执行路由规则;v2rayN、v2rayNG 与 v2flyNG 则是图形客户端,负责订阅管理、配置选择、系统代理和日志查看。排查问题时要分清故障发生在客户端界面、内核启动、配置内容还是本地网络。

v2rayN、v2rayNG 和 v2flyNG 应该怎么选?

Windows、macOS 与 Linux 桌面平台优先使用 v2rayN;Android 平台通常选择采用 Xray 内核的 v2rayNG,需要 V2Fly 内核时再选择 v2flyNG。三者的菜单位置和可用内核不同,但订阅导入、配置选择、路由模式与连接测试的基本流程相近。先按操作系统选客户端,再确认订阅提供的协议是否被当前内核支持。

Xray 与 V2Fly 内核有什么区别?

两者都源自 Project V 技术生态,基础配置概念相近,但协议扩展、传输能力、路由实现和更新节奏并不完全一致。Xray 常用于需要 VLESS、REALITY 等能力的配置,V2Fly 则保持自身的功能路线。订阅中如果包含特定协议或传输参数,应先确认所选内核能够识别;遇到配置解析失败时,切换兼容内核通常比反复修改节点名称更有效。

订阅链接与单个节点链接有什么区别?

订阅链接用于一次获取一组配置,并可在客户端中定期更新;单个节点链接只包含一条 vmess、vless、trojan 或 shadowsocks 配置。导入订阅后通常会生成独立分组,后续应通过更新订阅刷新内容,不要把订阅地址当作单节点链接粘贴。若服务方同时给出多个订阅格式,应优先选择明确标注适配当前客户端的格式。

VMess、VLESS、Trojan 与 REALITY 应该如何选择?

协议选择应以订阅实际提供的配置和当前内核兼容性为准。VMess 配置成熟且常见;VLESS 将认证与传输配置分离,常与不同传输方式组合;Trojan 使用自身的认证结构;REALITY 是与特定传输和安全参数配套的能力,通常需要较新的 Xray 内核。不要只改协议名称,地址、端口、用户标识、传输方式和安全参数必须作为完整配置一起匹配。

// 02 · SETUP

安装配置

导入、更新、安装包架构与系统权限是首次配置阶段最常见的阻塞点。

订阅链接导入失败,应该先检查什么?

先确认复制内容是完整订阅地址,没有前后空格、换行或被聊天工具截断;再用浏览器访问该地址,观察是否能返回订阅内容或明确错误。随后检查系统日期时间、客户端网络权限和当前网络能否访问订阅服务器。若地址可访问但客户端仍提示解析失败,应确认订阅格式适配 v2rayN 或 v2rayNG,并尝试新建订阅分组后重新导入。

订阅更新失败或一直提示超时怎么办?

先区分是只有某一条订阅失败,还是所有订阅都无法更新。单条失败通常与地址失效、授权过期或订阅服务器异常有关;全部失败则优先检查网络、DNS、系统时间和客户端是否错误地通过失效代理请求订阅。可以暂时关闭系统代理后更新,也可以在客户端设置中切换订阅更新所用的代理方式。更新成功后再重新选择分组中的配置。

Android 下载时 arm64 与 universal 怎么选?

2015 年后发布的主流 Android 手机通常使用 arm64 架构,优先选择 arm64 安装包,文件更精简。无法确认设备架构、安装时提示不兼容,或设备使用其他处理器架构时,再选择 universal 通用版。两种安装包的客户端功能基本一致,区别主要是包含的处理器架构范围;已经安装并正常运行时,没有必要只为更换包类型反复重装。

v2rayN 桌面版与经典 WPF 版怎么选?

桌面版采用新一代跨平台界面,适合希望在 Windows、macOS 与 Linux 之间保持相近操作逻辑的用户;经典 WPF 版面向 Windows,界面与既有教程中的菜单结构更接近。首次安装可以优先尝试桌面版,若运行环境、界面兼容性或已有操作习惯更适合 WPF,再改用经典版。两版不要解压到同一目录,避免配置文件互相覆盖。

开启 TUN 模式为什么需要系统权限?

TUN 模式需要创建虚拟网络接口并调整系统路由,这些操作通常超出普通用户权限。桌面端应按客户端提示授予管理员权限,Android 端则需要确认系统弹出的 VPN 连接授权。若开关打开后立即关闭,先查看客户端日志,再检查安全软件、旧虚拟网卡和其他网络工具是否占用相关能力。修改权限后应完整退出客户端再重新启动。

// 03 · USAGE

使用技巧

先使用内置模式建立稳定连接,再逐步增加订阅分组、内核切换和自定义规则。

系统代理模式、PAC 模式与 TUN 模式有什么区别?

系统代理模式通过操作系统代理设置接管遵循该设置的应用,配置简单,适合浏览器和常见桌面软件;PAC 模式根据规则决定哪些请求进入代理,但应用仍需支持系统代理;TUN 模式通过虚拟网络接口处理更广泛的流量,覆盖能力更强,同时需要额外权限。日常使用先从系统代理开始,只有应用不读取系统代理或需要统一接管时再考虑 TUN。

V2Ray 路由模式应该选全局、直连还是绕过局域网与大陆?

全局模式会让更多流量进入所选代理,适合临时验证配置是否可用;直连模式主要用于暂停代理或排查本地网络;绕过局域网与大陆会根据规则让局域网地址和常见国内目标直连,其余请求按规则处理,通常更适合日常使用。路由结果还会受 geosite、geoip 和自定义规则影响,模式名称相同并不代表每个客户端的规则内容完全一致。

如何给不同订阅建立独立分组?

添加订阅时为每个来源设置清晰的备注或分组名,更新后只在对应分组中选择配置。不要把多个订阅反复导入同一个临时分组,否则节点名称相似时很难判断来源,也容易在更新后留下重复项。删除订阅前先确认是否需要保留手动配置;更新完成后检查当前活动配置是否仍存在,若已被订阅移除,应重新选择有效配置。

切换内核后原有配置一定可以继续使用吗?

不一定。VMess、VLESS、Trojan 等基础字段可能相近,但不同内核对传输参数、路由字段、DNS 配置和实验性能力的支持范围不同。切换内核后若出现启动失败,应先查看日志中的未知字段、协议不支持或配置解析错误,不要直接判定节点失效。订阅配置优先使用其推荐内核,手动配置则应按目标内核的字段要求重新核对。

什么时候应该使用自定义 V2Ray 分流规则?

内置路由模式已经满足大多数场景,只有特定域名需要固定直连、代理或拦截时才需要自定义规则。规则可按 domain、geosite、ip、geoip 等对象匹配,并按客户端规定的优先级执行。添加前先用少量明确目标测试,不要一次导入大量来源不明的规则。若结果与预期不符,应检查匹配顺序、域名后缀范围和最终出站动作。

// 04 · TROUBLESHOOTING

故障排查

按订阅、内核、代理入口、路由和 DNS 的顺序检查,避免同时修改多个变量。

节点测试超时,但订阅更新正常是什么原因?

订阅服务器可访问只说明配置列表能够下载,不代表其中每个节点都能建立连接。先校准系统时间,再检查节点地址、端口、用户标识、传输方式和安全参数是否完整;随后换一个节点和网络环境交叉测试。若所有节点同时超时,应查看本地防火墙、DNS 和内核日志;若只有单个节点超时,通常应联系配置提供方确认该节点状态。

客户端显示已连接,但浏览器仍然无法上网怎么办?

已连接只表示内核已经启动,不等于目标请求成功。先确认当前选中的是有效配置,再检查系统代理是否已经开启、浏览器是否使用独立代理设置,以及路由模式是否把目标错误地送往直连或拦截。随后访问普通网站测试基础网络,并查看日志中的 DNS、连接拒绝或握手错误。若关闭客户端后也无法访问,应先修复本地网络再继续排查。

v2rayN 系统代理已经开启但不生效怎么办?

先检查 Windows 系统代理页面中的地址和端口是否与 v2rayN 当前本地监听端口一致,再确认浏览器或应用没有启用独立代理、扩展代理或固定直连设置。部分应用只在启动时读取系统代理,修改后需要完全退出并重新打开。若端口一致但请求没有进入日志,可临时关闭其他代理软件,并使用 TUN 模式验证是否属于应用不读取系统代理的问题。

启动时提示本地端口被占用怎么处理?

端口冲突表示另一个进程已经监听客户端准备使用的本地端口,常见于重复启动客户端、旧进程未退出或其他代理软件使用相同端口。先彻底退出相关程序并在任务管理器中确认残留进程,再重新启动。若必须修改本地 SOCKS 或 HTTP 端口,系统代理、浏览器手动代理和依赖该端口的其他程序也要同步更新,否则内核虽然启动,应用仍会连接旧端口。

只有部分网站打不开,是否与 DNS 有关?

有可能。部分网站失败而其他网站正常时,先检查路由规则是否把目标域名分到错误出站,再观察日志中是否出现域名解析失败、返回地址异常或连接到错误 IP。可以切换客户端支持的 DNS 方案并清理系统 DNS 缓存后复测。若启用了 TUN,还要确认 DNS 请求是否由 TUN 配置接管;不要同时叠加多套互相冲突的系统 DNS、浏览器安全 DNS和客户端 DNS 规则。