v2rayN · v2rayNG · v2flyNG

V2Ray 常见问题

订阅导入、代理设置与连接排查。先确认报错发生在哪一步,再按对应问题检查;客户端版本不同,菜单名称可能略有差异。

首次配置可先阅读入门指南;需要安装包时,前往客户端安装包页面按平台选择。

基础认知

先区分客户端、内核与连接配置,再选择安装包。

V2Ray、内核和图形客户端分别是什么?

V2Ray 通常指 Project V 相关的代理技术与工具生态;内核负责协议处理、路由匹配和实际连接,图形客户端负责订阅管理、参数设置及启动内核。使用 v2rayN、v2rayNG 或 v2flyNG 时,通常从客户端界面完成配置,不必先手写完整配置文件。排查问题要区分界面操作失败与内核连接失败:前者查看导入提示,后者查看启动后的日志。客户端名称相近,并不代表所用内核与协议支持完全一致。

v2rayN、v2rayNG 和 v2flyNG 怎么选?

Windows、macOS 与 Linux 桌面使用 v2rayN;Android 通常先选使用 Xray 内核的 v2rayNG,需要 V2Fly 配置兼容性时再考虑 v2flyNG。选择前先确认服务端协议、传输方式与安全参数,尤其是 REALITY 等功能,不能仅凭订阅能导入就判断可以连接。遇到不支持的字段,应检查客户端及内核的功能说明,而不是反复改端口。更换客户端后要重新核对路由与 DNS,界面设置不会随订阅链接完整迁移。

安装客户端后,还需要准备什么配置?

客户端安装完成后,需要有效的订阅地址、分享链接,或由服务端维护者提供的完整连接参数。安装包本身不包含可直接使用的服务器。手动填写时,应逐项核对地址、端口、用户标识、协议、传输方式以及 TLS 或 REALITY 参数;这些字段必须与服务端对应。不要从无关教程里拼接不同示例的字段,也不要把网站登录密码当作协议密码。订阅地址往往包含访问凭据,截图、求助或复制日志前应隐藏其中的敏感部分。

Android 安装包选 arm64 还是 universal?

先在设备的系统信息或处理器说明中确认架构。支持 ARM64 的设备优先选择 arm64 包;不确定架构,或 arm64 包提示不兼容时,可选择包含多种架构的 universal 包。两者主要区别是所含原生组件与包体大小,并不代表通用版连接更快。若安装仍失败,还应检查系统版本要求、剩余空间和已有应用的签名是否一致。需要卸载重装时,先导出必要配置并妥善保存,避免订阅分组与自定义路由随应用数据一同删除。

安装配置

从订阅格式与更新路径开始,再检查系统代理和 TUN 权限。

复制链接后,为什么订阅导入失败?

先分清复制的是订阅地址还是单条分享链接。v2rayN 可在“订阅分组”中新增分组并填写订阅地址,再执行更新;v2rayNG 可在“订阅分组设置”中添加地址后更新订阅。单条分享链接则使用“从剪贴板导入”等对应入口。检查复制内容前后是否带有空格、换行、说明文字或中文标点。如果导入后列表为空,查看提示是否为格式不支持,并向配置提供方确认输出格式;网页登录地址不能直接作为订阅地址使用。

订阅更新失败或更新后列表为空,怎么检查?

先确认本地网络能正常访问订阅服务,再检查地址是否过期、被撤销或缺少查询参数。若客户端提供直连更新与通过代理更新两种入口,应根据订阅服务的可达性选择;当前代理本身不可用时,通过代理更新也可能失败。出现列表为空时,再检查分组过滤条件与服务端返回格式,登录页或错误页不能解析成配置。更新前保留现有可用配置,排查时不要连续清空分组。仍有问题可查看更新日志,但分享日志前应遮盖完整订阅地址。

v2rayN 的系统代理为什么对部分应用不生效?

先启动可用配置,再在主窗口或托盘菜单的“系统代理”中选择“自动配置系统代理”。系统代理只影响遵循系统代理设置的应用,并不接管所有流量。浏览器如安装了代理扩展,应检查是否覆盖了系统设置;终端、游戏或其他应用可能使用自己的代理选项。还要核对应用填写的本地代理端口是否与 v2rayN 实际监听端口一致。确认系统代理路径可用后,再评估是否需要 TUN,不要把两种接管方式同时开启作为默认排错步骤。

启用 TUN 提示权限不足或虚拟网卡失败,怎么办?

先关闭“启用Tun”,确认普通代理连接正常,再处理权限问题。Windows 可退出客户端后以管理员身份重新启动;macOS 与 Linux 则按客户端提示完成所需授权或服务设置,不要直接照搬其他系统的命令。检查是否有其他 VPN、虚拟网卡或安全软件占用相关资源,必要时先退出冲突程序。修改后重新启用 TUN,并在日志中确认虚拟网卡和路由是否成功建立。管理员权限只解决启动条件,路由、DNS 或服务端参数错误仍需分别排查。

使用技巧

分流、分组与 DNS 分别调整,每次变更后进行实际访问测试。

路由模式应该选“绕过大陆”还是全局代理?

“绕过大陆”通常按预设域名与 IP 规则分流,命中的直连目标不经过代理出站;全局代理则将相应接管范围内的请求交给代理出站。具体覆盖范围仍取决于当前路由规则,不能仅看模式名称判断所有应用都已被接管。日常使用可先选择符合需求的预设,再针对个别域名添加规则。排查某个网站时,可临时切换模式观察结果;测试结束后恢复原设置。切换模式只能改变出站选择,无法修复错误的服务器地址或失效凭据。

多个订阅怎样分组,才不容易误删或混用?

在“订阅分组”或“订阅分组设置”中,为不同来源分别建立分组,并使用能辨认用途的名称。每个分组单独保存地址、更新方式和过滤条件,不要将多个订阅地址粘贴到同一个地址栏。手动添加的配置建议与自动更新的订阅分开,避免刷新时被覆盖。更新后先检查目标分组与当前选中的配置,再进行连接测试。导出备份时也要确认是否包含订阅凭据;备份文件适合个人迁移使用,不应直接作为公开求助附件上传。

v2rayNG 的 Fake DNS 需要一直开启吗?

不必默认开启。Fake DNS 使用映射地址应答部分域名查询,并在后续连接中还原域名,是否适用取决于内核、DNS 设置与流量接管路径。建议先在关闭状态下确认连接和分流正常,再按需要到“设置”的 DNS 相关项目中启用并逐项测试。“启用本地 DNS”与“Fake DNS”不是同一个开关,不能只改其中一项就假定配置完整。若出现局域网域名异常或部分应用无法解析,先恢复原设置、重新建立连接,再检查 DNS 与路由规则的配合。

延迟测试有结果,就代表网页一定能打开吗?

不能。TCP 连通性测试通常只能说明目标端口可以建立连接,无法证明协议认证、TLS 握手、域名解析与最终出站都成功。客户端的实际连接测试也依赖测试地址,单个地址可达不等于所有网站可达。应先查看测试项目名称,再选中配置启动连接,用浏览器访问明确的目标网站,同时查看日志是否有握手、解析或路由错误。测试失败时按连接阶段排查,不要只依据一个结果批量删除配置;测试成功后也要确认浏览器实际使用了客户端的代理路径。

故障排查

先看请求是否进入客户端,再区分解析、连接与握手阶段。

节点连接超时,应该先检查哪几项?

先确认设备本身能够联网,再核对服务端地址、端口与订阅有效性。打开客户端日志,区分连接目标端口超时、域名解析失败和协议握手失败,三者处理方向不同。只在某个网络出现问题时,可换一个可信网络进行对照;所有网络都失败时,应向服务端维护者确认服务状态与访问条件。不要同时修改协议、端口、DNS 和路由,否则难以定位是哪项变化产生影响。每次只调整一个设置,保留报错原文及发生时间,并隐藏用户标识等敏感字段。

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

先确认“已连接”表示的是内核已启动,还是已经完成实际网络测试;启动成功并不保证服务端可用。随后检查浏览器的代理扩展、系统代理设置和客户端本地监听端口,确定请求确实进入客户端。查看日志时,如果没有对应请求,优先检查接管路径;如果出现 DNS 错误,检查解析设置;如果请求已匹配到出站却握手失败,核对服务端参数。使用 TUN 时还要检查虚拟网卡与路由状态。按这条顺序排查,比直接重装客户端更容易保留问题线索。

出现 x509 或 TLS 证书错误,可以跳过验证吗?

不应把“跳过证书验证”作为常规解决办法。先在系统设置中校准日期、时间与时区,再检查配置中的服务器名称或 SNI 是否与服务端证书对应。连接地址与证书域名可以不同,但 SNI 必须按服务端实际配置填写,不能随意改为其他网站域名。若证书过期、证书链不完整或服务端配置异常,应由维护者修复。REALITY 连接还需按其参数要求检查公钥、指纹与服务器名称,不能套用普通 TLS 的修改方式。保留准确报错有助于区分这些情况。

退出客户端后断网,或同时运行多个代理程序怎么办?

先只保留一个代理程序运行,避免多个程序反复写入系统代理或争用虚拟网卡。准备退出 v2rayN 时,先关闭 TUN,再在“系统代理”中选择“清除系统代理”,最后退出程序。若程序已异常结束,可到系统网络设置检查是否仍指向已停止的本地代理端口,并恢复符合当前网络要求的设置。工作网络原有代理不要直接删除,应先记录原值。恢复后先测试普通联网,再逐个启用客户端功能;仍无法联网时,再检查 DNS、残留路由与其他 VPN 服务。