HELP / CLIENT CONFIGURATION
V2Ray 常见问题
订阅、系统代理与连接故障。先确认问题发生在哪个环节,再按对应步骤检查;每次只调整一项设置,保留可复现的错误信息。
CONCEPTS
基础认知
先区分客户端、内核、订阅与流量接管方式。
V2Ray、内核和图形客户端分别负责什么?
V2Ray 属于 Project V 代理工具生态,V2Fly 与 Xray 是相关的内核家族。内核负责协议处理、连接建立和路由执行,图形客户端负责编辑配置、管理订阅与启动内核。v2rayN 用于桌面平台,v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核。下载客户端不会自动获得可用的服务器配置;开始前仍需准备有权使用的订阅或节点参数。
桌面与 Android 应该选择哪个客户端?
Windows、macOS 与 Linux 桌面优先按操作系统选择 v2rayN;Android 可先选择 v2rayNG,需要 V2Fly 内核兼容性时再考虑 v2flyNG。Windows 下载区提供 Desktop 与 WPF 两种界面入口,前者采用跨平台界面,后者采用经典 WPF 界面。选型时先看系统、处理器架构和协议支持,不要把另一个客户端能导入同一链接,直接理解为所有传输参数都完全兼容。
订阅链接与单个节点分享链接有什么区别?
订阅链接通常是用于获取一组服务器配置的地址,客户端更新订阅时会重新请求该地址。单个节点分享链接通常以协议名称作为开头,只描述一条连接配置。两者应使用对应的导入入口,不能仅凭链接很长就判断它是订阅。订阅地址可能携带账户标识与访问凭据,应按敏感信息保管。求助时描述错误类型即可,不要公开完整地址、二维码或包含凭据的截图。
系统代理、路由预设与 TUN 模式有什么区别?
系统代理告诉遵循系统设置的应用把请求交给本地代理端口;路由预设决定进入内核的请求走直连、代理还是阻断;TUN 模式通过虚拟网络接口接收流量,覆盖范围与具体实现、权限及路由设置有关。三者处于不同环节,不是互相替代的同一个开关。初次配置建议先关闭 TUN,用系统代理验证基础连接,再根据应用是否遵循系统代理决定是否启用 TUN。
INSTALL / IMPORT
安装配置
从安装包架构开始,依次检查导入、代理与权限。
订阅导入失败或导入后没有节点,怎么检查?
先确认复制的是完整订阅地址,去掉首尾空格、换行和聊天软件附带的标点。v2rayN 中应在订阅分组内保存地址,再执行该分组的更新订阅;Android 客户端则在订阅设置中保存后更新。地址被保存不等于已经取回节点。若仍为空,查看更新日志,区分网络请求失败、返回内容无法解析和有效节点为空。网页登录地址、套餐说明页及已经失效的订阅不能作为节点订阅直接导入。
Android 安装包的 arm64 与 universal 怎么选?
先查看设备处理器与系统支持的应用架构。2015 年后主流手机通常可先考虑 arm64,但处理器支持 64 位不代表当前系统一定能安装 64 位应用,仍应以设备信息为准。无法确认架构时可选 universal,它通常包含多种架构所需的组件,安装文件也相对较大。出现解析安装包失败时,除架构外还要检查系统版本、下载是否中断,以及同名应用是否来自不同签名来源;卸载前先备份配置。
v2rayN 的系统代理设置后为什么没有生效?
先确认内核已经运行、活动服务器已选定,再在 v2rayN 中选择自动配置系统代理。打开系统网络代理设置,核对本地地址和端口是否与客户端一致。浏览器扩展、另一个代理工具或组织管理策略可能覆盖这些设置;部分应用也完全不读取系统代理。先关闭冲突工具,用一个遵循系统代理的浏览器测试。Linux 桌面环境的代理设置入口不同,必要时在 GNOME 或 KDE 网络设置中手动核对。
开启 TUN 提示权限不足,应该怎样处理?
先关闭 TUN,确认普通代理连接可用,再处理虚拟接口权限。Windows 通常需要管理员权限及可用的相关驱动;macOS 与 Linux 按客户端提示完成授权,不要用不明命令替代权限配置。Android 首次启动会请求系统 VPN 授权,拒绝后需重新发起连接并确认。若另一个 VPN 类应用占用系统接口,应先停止它。权限处理完成仍失败时,检查日志中的接口创建或路由写入错误,避免反复切换开关。
ROUTING / MAINTENANCE
使用技巧
验证请求路径,分开管理订阅数据与手动配置。
绕过大陆与全局代理应该如何选择?
先按实际访问需求选择路由预设,再验证具体域名的匹配结果。绕过大陆通常依赖域名和 IP 分类规则,把相应流量交给直连出口;全局代理通常让进入内核的请求优先走代理出口,实际仍受所选规则影响。路由中的全局不等于接管整台设备,未进入内核的应用流量不会因此改变。遇到单个网站异常,可短暂切换预设作对照;确认原因后再调整规则,不宜长期用扩大代理范围掩盖配置问题。
如何确认浏览器请求确实经过代理?
先选择一台已导入的服务器,启动内核并配置系统代理,再访问已知可用的 HTTPS 页面,同时观察客户端连接记录或日志。核对目标域名是否出现,以及匹配到的是代理还是直连出口。节点测试成功只说明某种测试请求可用,不能证明浏览器已经使用代理。若浏览器没有对应记录,先查浏览器自身代理、扩展和系统设置。日志粒度不足时可短时提高日志级别,定位后恢复常规级别并妥善处理日志。
更新订阅后,手动修改的节点为什么恢复了?
订阅分组中的节点通常由远端订阅内容生成,更新时客户端可能按远端数据重新创建或覆盖条目,因此不宜把长期手动调整直接写在订阅节点上。需要保留独立参数时,先备份,再使用客户端支持的复制或手动添加功能建立独立条目,并清楚区分它与原订阅分组。订阅更新还可能改变条目标识,原活动服务器未必继续被选中。每次更新后检查活动项、路由预设与关键传输参数,再进行连接测试。
更换设备或升级客户端前应该备份什么?
优先使用客户端提供的导出或备份功能,保存订阅分组、手动节点、自定义路由和必要的 DNS 设置,并记录本地监听端口与常用模式。备份文件可能包含服务器密码、用户标识和订阅凭据,应保存在受控位置,不要作为普通附件公开发送。跨客户端导入时,先迁移基础连接配置,再逐项重建路由与 DNS;界面设置和配置文件格式未必兼容。恢复后先验证一个节点,确认正常再迁移其余设置。
DIAGNOSTICS
故障排查
分清本地服务启动、远端连接与订阅请求,不把不同错误混为一谈。
节点测试超时,应该按什么顺序排查?
先确认本机网络可用、系统时间准确,再检查节点地址、端口和协议参数是否完整。比较同一订阅中的其他节点,并在条件允许时切换另一种网络作对照。单个节点失败更可能与该服务器或参数有关,全部失败则应检查本地网络、内核启动和订阅状态。注意 TCP 连通不代表 TLS 或协议握手成功。查看日志中的解析失败、连接超时或握手错误,按错误所在环节处理,不要同时修改多个参数导致原因无法追踪。
客户端显示已连接,但网页仍打不开怎么办?
已连接通常表示本地服务或系统接口已经启动,不代表远端连接和域名解析全部正常。先检查当前活动服务器,再确认浏览器流量是否进入内核。若请求进入后失败,查看 DNS 解析、路由出口和握手日志;若完全没有记录,回到系统代理或 TUN 接管范围检查。可以用另一个已知可用的 HTTPS 页面排除单站故障。不要一开始就关闭防火墙或所有安全设置,应先利用日志缩小到应用、解析、路由或服务器中的具体环节。
已有节点还能连接,为什么订阅更新失败?
节点连接使用已保存的服务器配置,订阅更新则请求订阅地址,两条路径可能有不同的 DNS、路由和访问条件。先检查订阅是否到期、地址是否被重置,以及日志中的 HTTP 状态。认证或权限错误应联系订阅提供方确认;网络超时可在客户端支持的情况下对照直连更新与通过代理更新。若代理更新依赖的活动节点本身不可用,会形成更新障碍。短时间反复重试还可能触发请求限制,应保留错误信息后间隔重试。
退出客户端后网络异常,如何恢复本机网络?
先重新打开客户端,关闭 TUN,并选择清除系统代理后正常退出。如果客户端无法启动,到操作系统网络设置中检查是否残留指向本机的手动代理;同时确认没有其他应用正在使用该代理配置,再进行清除。Android 可检查系统 VPN 连接是否仍启用;桌面端还应查看其他 VPN 或虚拟网络工具。恢复后用普通直连页面测试。不要直接删除所有网络适配器或重置全部路由,除非已明确故障来源并准备好恢复原有网络设置。