帮助中心 · 按问题定位

V2Ray 常见问题

从订阅入口到连接异常,先确认问题发生在哪一层,再修改对应设置。每次只改一项,保留可恢复的配置。

v2rayNG v2rayN v2flyNG

基础认知

区分客户端、配置来源与流量接管方式。

v2rayN、v2rayNG 与 v2flyNG 应该怎么选?

Windows、macOS 与 Linux 桌面设备选择 v2rayN;Android 优先选择使用 Xray 内核的 v2rayNG,已有 v2fly 配置需求时再考虑 v2flyNG。客户端负责配置管理和连接控制,内核负责协议处理,两者不是同一个概念。Project V 是相关开源生态的起点,V2Fly 与 Xray 是不同的内核家族。选择前先核对配置要求的协议、传输方式与安全参数,尤其不要仅凭名称相近就认为配置可以直接互换。

安装客户端后,为什么还需要订阅或服务器配置?

客户端是连接工具,不会随安装自动提供可用服务器。建立连接至少需要服务器地址、端口、身份验证信息,以及与服务端一致的传输和安全设置。这些内容通常通过订阅地址、分享链接或配置文件导入。请从有权使用的服务提供方或自建服务取得配置,并确认服务状态有效。不要把订阅地址、完整分享链接或含身份信息的日志贴到公开页面;它们可能包含能够直接使用服务的访问凭据。

订阅地址与 vmess://、vless:// 等分享链接有什么区别?

订阅地址通常是用于获取配置列表的 HTTPS 链接,更新订阅会重新获取该来源提供的内容;vmess://、vless://、trojan:// 和 ss:// 通常描述单条服务器配置。订阅接口可能返回 Base64 编码的分享链接集合,也可能返回客户端不支持的其他格式。单条分享链接应使用从剪贴板导入等入口,订阅地址则应保存到订阅设置。网页管理地址和订阅地址也不是一回事,复制浏览器地址栏内容前要确认来源说明。

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

v2rayNG 的 VPN 模式通过 Android 的 VPN 接口接管符合条件的应用流量;仅代理模式主要提供本地代理监听,需要应用主动配置代理。v2rayN 的系统代理修改桌面系统的代理设置,但并不是所有程序都会读取它。TUN 使用虚拟网络接口处理流量,覆盖范围取决于路由、权限和排除项。不要把这些模式同时开启当作通用修复方法;先确定目标应用如何发送流量,再选择一种接管方式并测试。

查看三款客户端选型说明 →

安装配置

先选安装包,再确认订阅格式与连接权限。

Android 安装包选 arm64 还是 universal?

设备运行 64 位 ARM 系统时选择 arm64;无法确认系统架构时,可先选择 universal 通用包。通用包包含多种架构支持,通常体积更大,并不代表连接更快。部分设备的处理器支持 64 位,但系统仍为 32 位,因此不能只凭购买年份判断。可在设备信息中核对系统架构,或参考设备厂商说明。更新已有客户端时,还要注意应用来源和签名是否一致;出现安装冲突时先导出配置,再决定是否卸载旧应用。

订阅链接导入失败,应该检查哪些入口与格式?

先确认复制的是完整订阅地址,去掉首尾空格、换行和聊天软件附加的标点。v2rayNG 通常在侧栏的订阅分组设置中添加备注与地址,保存后返回列表执行更新订阅;v2rayN 在订阅分组设置中添加地址,再更新对应分组。不同版本的菜单文字可能略有差异。若复制的是单条协议分享链接,应改用从剪贴板导入入口。仍然失败时查看错误信息,区分地址无法访问、响应为空和格式无法解析,不要反复更换无关开关。

订阅更新失败,或更新后服务器列表为空,怎么办?

先确认订阅地址是否过期、被重置或需要重新获取,再检查当前网络能否访问订阅服务。若客户端提供经代理更新与直连更新选项,可按当前可用连接分别尝试,但经代理更新需要已有可工作的配置。更新成功却没有内容时,先清空该分组的服务器关键词过滤,再确认订阅响应格式受客户端支持。不要立即删除整个分组,以免丢失备注与已有配置。记录更新报错即可,分享记录前应遮住订阅路径中的访问凭据。

开启 TUN 提示权限不足,Android 的 VPN 授权又在哪里处理?

v2rayN 的 TUN 模式需要创建或使用虚拟网络接口。出现权限不足时,先停止连接,再按客户端提示授予所需权限;Windows 可按提示以管理员权限重启,macOS 与 Linux 则核对相应授权提示及客户端日志。Android 上的 v2rayNG 通常使用系统 VPN 接口,首次启动连接需确认系统弹出的 VPN 授权,而不是照搬桌面 TUN 步骤。另一款 VPN 应用可能占用同类连接,应先停止它,再重新授权与启动。

查看 Android 安装包入口 →

使用技巧

把代理入口、路由规则与 DNS 分开检查。

v2rayN 已启动,为什么系统代理没有生效?

启动 v2rayN 并不等于已经设置系统代理。先选定服务器并确认内核运行,再通过托盘菜单设置系统代理,核对系统代理地址与端口是否指向客户端当前的本地监听。随后检查浏览器是否使用系统代理,是否被扩展或独立代理设置覆盖。部分应用不会读取系统代理,需要单独填写本地代理,或在明确需求后使用 TUN。测试时先关闭其他代理工具,避免它们反复改写系统设置;退出客户端后也要确认残留代理已清除。

如何设置路由分流,避免所有连接都走同一出口?

先使用客户端已有的路由方案建立可工作的基线,再按目标域名、IP 或应用需求添加规则。v2rayNG 可从路由设置进入,v2rayN 则检查路由设置与当前启用的方案。规则通常按顺序匹配,较具体的条件应放在宽泛条件之前,最后再由默认出站处理未命中的连接。使用 geosite 或 geoip 条目时,要确保对应资源可用,且出站标签确实存在。每次只修改一组规则,重启连接后用同一目标验证,避免同时修改 DNS 导致判断混乱。

DNS 与 FakeDNS 应该什么时候调整?

先保留能够正常工作的 DNS 配置;只有出现域名解析失败、分流结果异常或特定网络下解析不一致时,再逐项调整。检查 DNS 服务器是否可达,以及查询所走的出站是否符合预期。FakeDNS 会把域名映射为合成地址,通常需要与流量接管和域名还原机制配合,并不是开启后就能改善所有连接。启用后若部分应用异常,可先关闭 FakeDNS,重启连接并刷新相关应用的解析缓存。具体设置项随客户端与内核变化,不能只复制其他客户端的字段。

v2rayNG 分应用代理的名单应该怎么选?

在 v2rayNG 设置中启用分应用代理后,先确认当前名单表示仅代理所选应用,还是绕过所选应用;两种含义相反,不能只看勾选状态。明确目标后先加入一个需要测试的应用,保存并重启 VPN 连接,再完全关闭并重新打开该应用。若应用通过其他组件发起网络请求,还要结合实际调用关系检查。分应用名单决定流量是否进入客户端,进入后的连接仍受路由规则影响,因此勾选某个应用不代表它的所有请求必然使用代理出站。

深入阅读路由、DNS 与分组配置 →

故障排查

按解析、连接、握手与应用接管的顺序定位。

服务器连接超时,怎样区分网络问题与配置问题?

先确认服务仍有效,并核对服务器地址、端口、协议、传输方式与安全设置。不要把订阅更新成功当成服务器一定可达,它们可能使用不同地址。随后切换到另一种可用网络复测同一配置,再用同一网络测试其他已知可用配置,以缩小问题范围。查看日志时区分解析失败、连接超时和握手失败:前者先查 DNS,中间检查网络路径与服务端监听,后者核对安全参数。客户端重启无法修复已失效的服务器,也不应通过随意关闭安全验证来尝试连接。

显示已连接,但网页和应用仍然无法上网,先查哪里?

已连接通常只说明本地代理或 VPN 接口已启动,不代表远端连接和 DNS 都正常。先查看日志是否持续出现解析或握手错误,再确认当前服务器有效。桌面端核对系统代理或 TUN 是否真正接管目标应用;Android 检查分应用代理是否把该应用排除。若只有域名访问失败,重点检查 DNS;若只有部分目标失败,检查路由规则与对应出站。每次测试前先恢复一个已知可工作的配置,暂时关闭新增的自定义规则,避免在多个未知设置上继续叠加修改。

TLS 握手失败或出现 x509 证书报错,如何处理?

先打开系统的自动日期与时间,确认时区和实际时间正确。随后核对服务端要求的 serverName 或 SNI,不能把它与连接地址、WebSocket Host 等字段直接混为一谈。证书可能签发给域名,即使连接地址填写的是 IP,TLS 校验仍需正确的名称。若配置使用 REALITY,还应核对其专用参数,不要只调整普通 TLS 字段。不要把允许不安全连接设为长期解决办法;证书过期、名称不匹配或服务端配置变化时,应向服务提供方确认正确参数。

v2rayN 报本地端口被占用,或关闭后网络异常,怎么办?

先停止其他代理客户端,再查看 v2rayN 日志中报错的具体监听地址与端口;不要假定每个版本都使用相同端口。确认占用来自不再需要的程序后,正常退出该程序,或在 v2rayN 参数设置中修改本地监听端口。修改后必须同步检查系统代理、浏览器独立代理及其他手动填写的代理地址。若关闭客户端后无法联网,先在系统网络设置中清除仍指向本地监听的代理,再重新测试。不要直接结束不认识的系统进程,也不要只改端口而保留旧代理设置。

查看本地端口冲突定位步骤 →