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

按问题所在的层次检查:先看订阅和服务器配置,再看应用代理入口,最后检查路由与远端连接。展开对应问答,一次调整一个设置,并保留修改前的值。

基础认知

先区分客户端、内核和服务器配置,避免把界面状态当作连接结果。

V2Ray、Xray 与三款图形客户端是什么关系?

Project V 是相关代理工具的生态背景,V2Fly 与 Xray 是不同的内核项目。内核负责协议连接、路由和流量转发,图形客户端负责订阅、服务器选择及设置界面。桌面平台可选 v2rayN,Android 可选使用 Xray 的 v2rayNG,或使用 V2Fly 内核的 v2flyNG。协议能否使用取决于实际运行的内核及其版本,不能只根据客户端名称判断。遇到兼容性问题,先记录客户端和内核信息,再核对服务器所需功能。

安装客户端后,为什么服务器列表还是空的?

客户端提供本地代理界面和内核运行环境,服务器配置需要另行导入。订阅地址通常返回一组配置,分享链接通常描述单个配置,两者应放到对应的导入入口。安装完成后,先准备有权使用的订阅地址或分享链接,再执行导入和服务器选择。列表为空不代表安装失败,也不能通过开启系统代理自动生成服务器。请勿把订阅地址粘贴到公开截图或求助内容中,其中可能包含可直接访问订阅的凭据。

系统代理、路由模式与 TUN 分别控制什么?

系统代理告诉遵循系统代理设置的应用,将请求交给本地监听端口;它不保证接管每个程序。路由模式处理已经进入内核的流量,决定使用代理、直连或阻断出口。TUN 通过虚拟网络接口接收符合接管条件的流量,涉及路由、DNS 和权限设置。这三项处在不同层次。排查时先确认应用流量是否进入客户端,再看匹配了哪条路由,最后检查出口连接,避免把开启系统代理等同于全部流量使用代理。

延迟测试有结果,是否就能正常访问网页?

不能直接等同。TCP 测试主要检查目标地址和端口是否能建立连接,不能完整验证认证、传输参数和网页访问。真连接测试更接近实际请求,但结果也受测试地址、DNS、当前路由和网络状态影响。判断可用性时,应选择服务器后通过实际应用访问,并查看同一时刻的客户端日志。不要只按最低延迟排序就认定连接正常;测试成功而网页失败时,优先检查应用代理入口及域名解析,再核对服务器参数。

安装配置

导入失败先看输入内容,启动失败先看运行环境和权限。客户端入口集中在下载页。

分享链接导入失败,应该先检查哪些内容?

先确认复制的是完整分享链接,包含 vmess://、vless://、trojan:// 或 ss:// 等协议前缀,而不是网页地址或订阅地址。清理首尾空格、聊天软件附加的说明文字及被插入的换行,再使用从剪贴板导入的入口。仍然失败时,查看导入提示,区分格式无法解析与协议暂不兼容。不要为了通过导入而随意修改编码内容、认证字段或传输参数;应重新取得原始链接,并核对当前客户端和内核是否支持该配置。

订阅地址应该怎样添加,为什么添加后没有服务器?

在 v2rayN 的订阅分组设置中新增分组,填写便于识别的名称和完整订阅地址,保存后执行该分组的订阅更新。Android 客户端也应先保存订阅,再执行更新,而不是只添加一个分组名称。添加地址不等于已经取得配置。更新结束后检查结果提示、分组筛选和服务器列表;如果返回内容是登录页、错误页或普通网页,客户端就无法生成有效配置。此时应核对地址是否过期,以及返回内容是否为客户端支持的订阅格式。

Android 下载时,arm64 与 universal 怎么选?

2015 年后主流 Android 手机通常优先选择 arm64,但最终应以设备实际支持的应用架构为准。universal 包含多种架构组件,通常体积更大,适合无法确定设备架构时使用;它不意味着协议功能更多。若 arm64 安装时提示不兼容,先核对系统版本和架构,再尝试通用版。更新已有客户端时应保持应用来源和签名一致。不要直接卸载来绕过更新错误,先备份必要配置,避免丢失订阅分组与手工添加的服务器。

TUN 无法启用或提示权限不足,如何处理?

桌面端先查看日志,确认失败发生在权限申请、虚拟接口创建还是路由设置阶段,再按当前客户端要求授权;需要提升权限时,通过系统提供的授权流程操作。Android 首次建立连接通常需要确认系统 VPN 连接请求,同时检查是否有其他应用占用该连接。不要反复开关多个接管工具。先关闭冲突项,确认普通代理连接可用,再单独启用 TUN。授权通过后仍失败,应检查虚拟接口、服务组件和路由错误,而不是继续更换节点。

使用技巧

日常配置应能复查和恢复。调整代理模式、端口或规则前,先记下原来的选项。

日常使用应怎样组合系统代理与路由模式?

主要使用遵循系统代理的浏览器时,可先启用自动配置系统代理,再选择符合需求的路由规则,例如绕过大陆。需要验证某个目标是否被分流影响时,可以临时切换到代理出口更集中的规则进行对照,完成后恢复原设置。模式名称可能随版本变化,应以实际规则为准。所谓全局通常指进入内核后的路由选择,不代表自动接管全部应用。对不读取系统代理的程序,应单独配置本地代理地址,或在确认兼容性后使用 TUN。

怎样配置应用的本地代理端口?

先打开客户端参数设置,读取当前 HTTP、SOCKS 或混合监听端口,再在应用中选择相应代理类型,地址通常填写 127.0.0.1。不要把服务器的远端连接端口填成本地端口,也不要假设所有版本都使用同一个默认值。修改监听端口后,应确认内核重新加载成功,并同步更新应用设置。仅在本机使用时,保持局域网连接选项关闭;确需让其他设备接入时,还要核对监听地址、防火墙和访问控制,避免向不受信任的网络开放入口。

订阅更新会不会覆盖手工修改的配置?

订阅内服务器通常由远端内容管理,更新时可能被替换、删除或重建,手工修改不一定保留。需要长期保存的自定义配置,应在客户端支持的独立分组中另行保存,并记录修改原因。更新前确认订阅范围,避免误操作到其他分组。若某个参数每次更新都会恢复,不要持续在订阅条目上重复修改,应检查是否存在客户端提供的本地覆盖设置,或向配置提供方确认原始参数。备份文件也可能包含订阅凭据,应妥善保存。

如何检查一条路由规则是否生效?

先确认请求已进入内核,并检查当前启用的路由配置,而不是只看编辑窗口里的规则。规则通常按顺序匹配,前面的宽泛规则可能让后面的细分规则没有机会执行。用单一目标发起请求,再结合日志中的目标、匹配规则和出口信息判断;日志提供的信息取决于内核及日志级别。还要核对规则资源是否可用、域名策略是否符合预期。调整时每次只改一项,记录原值,测试后恢复不必要的调试日志,避免积累含访问记录的文件。

故障排查

从本地网络、代理入口、DNS、路由到服务器参数逐层检查,不用反复重装代替定位。

订阅更新失败,直连与代理更新应该怎样排查?

先核对订阅地址是否完整、是否已过期,以及设备时间是否正确,再查看更新日志。超时、证书错误、认证失败和内容解析失败是不同问题。如果当前代理本身不可用,代理更新也可能失败,此时可在客户端提供相应选项时尝试直连更新;直连无法访问订阅地址时,则需要可用的连接路径。不要把同一地址反复粘贴到第三方转换页面。若服务器已经返回内容但解析失败,应确认返回格式,而不是继续调整本地监听端口。

节点一直超时,应该按什么顺序检查?

先确认本地网络能正常访问常用直连服务,再核对设备时间、服务器地址、端口和配置有效期。将 TCP 测试与真连接测试分开看:前者失败时,优先检查地址解析、网络路径及远端端口;前者成功而后者失败时,再检查认证、TLS、SNI、传输路径和内核兼容性。使用同一网络对少量配置逐一测试,不要同时批量测试大量服务器,以免干扰判断。需要求助时保留错误类别和发生时间,分享日志前隐藏地址、订阅及认证信息。

显示已连接,但网页仍然打不开怎么办?

已连接可能只表示本地内核或 VPN 接口已经启动,不代表远端请求成功。先检查应用请求时日志是否出现对应连接;没有记录时,核对系统代理、应用独立代理或 TUN 接管情况。有记录时,再区分 DNS 失败、连接超时、认证错误与路由选错出口。若仅个别域名失败,应检查该域名的解析和规则,而不是重装客户端。临时停用其他代理工具并用单个应用复测,每次只改变一个设置,才能确定故障位于入口、解析还是远端出口。

v2rayN 系统代理不生效,退出后还断网怎么办?

先确认 v2rayN 正在运行,内核没有启动错误,系统代理中的本地地址和端口与客户端一致。浏览器可能使用独立代理或扩展设置,应检查是否覆盖了系统配置。退出后无法联网时,打开操作系统代理设置,查看是否仍指向已经关闭的本地监听端口;清除不再使用的代理设置后再试。若其他软件正在写入系统代理,应先明确由哪一个工具管理。以后退出前可先使用客户端的清除系统代理选项,但不遵循系统代理的应用仍需分别检查。