CLIENT HELP / FAQ

V2Ray 常见问题
配置与连接排查

按问题所在环节查找:先确认配置类型,再检查流量接入,最后看路由、DNS 与远端连接。

v2rayN v2rayNG v2flyNG

BASICS

基础认知

区分客户端、内核与协议,明确每个设置负责什么。

V2Ray、Xray 与 v2rayN 是什么关系?

V2Ray 属于 Project V 生态,V2Fly 延续相关内核的开发;Xray 是另一条内核发展路线。内核负责协议连接、路由与 DNS,v2rayN 则提供桌面图形界面来管理这些配置。Android 上,v2rayNG 常用 Xray 内核,v2flyNG 采用 v2fly 内核。客户端能导入某种链接,不代表当前内核支持其中所有参数;选型时应同时核对协议、传输方式、安全层及实际内核版本。

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

客户端负责读取配置并建立连接,安装完成并不会自动生成可用的服务端信息。需要准备有权使用的订阅地址、分享链接,或完整的服务器配置。手动填写时,服务器地址、端口、用户标识或密码,以及 TLS、传输方式等参数必须与服务端一致。先确认设备能正常访问基础网络,再导入一条来源明确的配置进行测试;不要把客户端安装成功与服务端连接成功混为一谈。

系统代理、TUN 与路由分流有什么区别?

系统代理让遵循系统代理设置的应用把请求交给客户端,不遵循该设置的程序可能继续直连。TUN 通过虚拟网络接口接入流量,覆盖范围通常更广,但依赖系统权限、路由与 DNS 配置。路由分流则是在流量进入内核之后,决定请求走代理、直连还是阻断。三者处在不同环节;排查时先确认应用流量是否进入客户端,再检查路由选择,不能仅凭开启 TUN 就判断全部请求都会走代理。

VLESS、VMess、Trojan 应该选哪一种?

先按服务端提供的类型选择,不能仅在客户端里改一个协议名称就完成转换。VLESS、VMess 与 Trojan 的认证字段和安全配置不同;REALITY 通常是与 VLESS 等协议搭配的安全层配置,不是可以任意替换的协议名称。比较时还要看 TLS、传输方式及内核支持情况。没有脱离部署环境的固定速度排名;优先采用服务端明确支持、参数完整且客户端内核兼容的组合,再结合实际连接表现判断。

查阅协议与客户端术语 →

INSTALL & CONFIGURE

安装配置

从安装包架构、订阅格式到启动授权,逐项确认。

订阅地址或分享链接导入失败怎么办?

先区分导入内容:分享链接通常以 vmess://、vless://、trojan:// 或 ss:// 开头,订阅地址通常是 HTTPS 地址。删除复制时附带的说明文字、换行与两端空格,并使用对应的剪贴板导入或订阅分组入口。若提示不支持,核对客户端与内核是否支持该传输配置。网页地址、登录页和原生 JSON 文件不能都当作分享链接处理;包含复杂出站或路由的 JSON,也未必能转换成单个节点。

Android 安装包的 arm64 与 universal 怎么选?

多数较新的 Android 手机可优先选择 arm64,但最终应以设备系统支持的 ABI 为准,不能只看处理器宣传型号。universal 包通常包含多种架构,体积较大,适合不确定架构时使用;具体包含哪些架构仍以该客户端发行包为准。出现解析失败或不兼容提示时,还应检查系统版本、安装文件是否下载完成,以及旧版应用的签名是否一致。切换不同客户端前先备份配置,不要直接卸载唯一可用的配置副本。

导入配置后,怎样确认已经开始代理?

在 v2rayN 中选择需要使用的服务器,确认内核正常启动,再按需求设置系统代理或启用 TUN;仅选中列表中的一行不等于应用流量已经接入。Android 客户端需要启动服务,并在使用 VPN 模式时同意系统连接授权。随后用实际浏览器访问测试,结合日志确认请求进入内核以及使用的出站。界面中的连接状态或延迟结果只反映部分环节,不能单独证明浏览器、DNS 与目标网站都工作正常。

启用 TUN 提示权限不足,应该检查哪些设置?

桌面端先查看日志中的具体失败项:创建虚拟接口、写入路由或绑定端口失败,对应的处理方式不同。Windows 可按客户端要求使用管理员权限;macOS 与 Linux 应按当前版本说明完成系统授权或辅助组件安装,不要直接放宽所有文件权限。Android 的 VPN 授权与桌面 TUN 的权限机制不同,通常还需停止其他占用 VPN 接口的应用。授权后重新启动服务,并确认系统没有被旧虚拟接口或其他网络工具的路由占用。

按步骤完成首次配置 →

DAILY SETTINGS

使用技巧

订阅分组、路由规则与后台运行的日常设置。

怎样更新订阅,又保留手动添加的配置?

将订阅内容和手动配置分别放入不同分组,更新前先确认当前操作针对哪个订阅分组。订阅刷新通常会依据远端内容重建或调整该组节点,因此不宜把长期保留的手动修改只放在订阅节点上。需要修改时,可复制为独立配置再编辑;涉及凭据更新时仍要同步核对服务端。定期使用客户端提供的导出或备份功能,并妥善保存文件。订阅地址和导出的配置可能包含访问凭据,不能作为普通截图或附件公开分享。

怎样设置分流,避免所有请求都走同一出站?

先使用客户端内置的路由方案,再逐项增加自定义规则,避免一次替换整套配置。核对规则匹配顺序、域名策略与默认出站:例如 geosite:category-ads-all → block 表示匹配该域名集合后阻断,但前提是所选内核和规则资源支持此写法。不同内核的规则格式并不通用。修改后分别测试应当直连与应当代理的目标,并查看日志;IPIfNonMatch 涉及域名未匹配时的解析判断,不是强制所有域名走代理的开关。

v2rayNG 后台容易断开或耗电偏高怎么办?

先区分服务被系统停止与服务仍在运行但连接失效。前者可检查系统电池优化、后台运行权限及厂商的应用休眠设置,按需要允许客户端持续运行;后者应查看网络切换、订阅配置与内核日志。耗电排查时关注长时间传输、反复重连和不必要的后台请求,必要时使用分应用代理缩小接入范围。VPN 模式本身不代表必然异常耗电,也不建议为保活同时关闭所有应用的电池限制。每次只调整一项,观察是否改善。

分享日志或截图前,需要隐藏哪些内容?

订阅地址可能包含访问令牌,分享链接和二维码可能包含完整连接凭据。提交排查材料前,应隐藏订阅路径中的敏感部分、用户标识、密码、私人服务器地址,以及日志中不希望公开的访问域名。保留客户端名称、实际版本、系统类型、报错原文与触发时间,通常更有助于定位。不要为了保留上下文直接公开完整配置;可以使用脱敏后的字段说明,指出协议、传输方式和安全层,并说明近期修改过哪些设置。

继续阅读安卓后台与耗电设置 →

CONNECTION CHECK

故障排查

按日志区分本地接入、远端连接和证书错误。

节点测试超时,应该从哪里开始排查?

先确认设备基础联网正常,再检查服务器地址能否解析、端口是否正确、订阅是否过期,以及服务端是否仍在运行。客户端的 TCP 测试与实际代理请求不是同一种测试:端口可连接不等于协议认证成功,单次超时也不能直接认定配置失效。可用同一配置在另一种网络下复测,并查看认证、TLS 或传输相关日志。若只有某一配置失败,优先核对该配置;若全部失败,优先检查本机代理冲突、DNS 和当前网络状态。

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

先观察浏览器发起访问时客户端是否出现请求日志。没有日志时,检查系统代理是否启用、浏览器是否使用了独立代理设置,以及应用是否被分应用规则排除。有日志但访问失败时,再区分 DNS 解析失败、路由出站错误与远端连接失败;如果只有域名访问失败,可重点检查 DNS,但不要把直接访问 HTTPS 网站的 IP 当作通用验证方式。暂时回到一套已知配置逐项测试,避免同时修改 DNS、路由与传输参数后无法判断原因。

v2rayN 系统代理不生效,如何检查端口与冲突?

在客户端设置中确认实际本地监听端口,再检查系统代理指向的地址和端口是否一致。部分配置使用 socks 10808 与 http 10809,但这些不是所有版本和所有配置的固定值,应以当前界面及日志为准。浏览器扩展、其他代理软件或企业管理策略可能覆盖系统设置;不读取系统代理的应用需要单独配置或采用合适的 TUN 接入方式。退出其他代理工具后重新设置系统代理,并检查端口是否被占用,不要反复更换节点来解决本地接入问题。

订阅更新失败或出现 TLS 握手错误,怎样区分原因?

订阅更新失败先核对地址是否完整、访问令牌是否有效,以及响应是否变成登录页或错误页;连接超时与返回内容格式错误应分别处理。如果通过代理更新,当前代理必须先能工作,必要时改用客户端支持的其他更新方式。TLS 握手错误则要核对系统时间、证书有效期、SNI 与服务端要求,不能把订阅域名和节点的 serverName 混用。不建议长期启用 allowInsecure 跳过证书验证;修正时间、域名或服务端证书后再重新测试。

查看 TLS 握手错误专项说明 →
V2Ray客户端下载