V2Ray 疑难解答
先确定故障发生在哪一步。导入失败查订阅请求,启动失败查内核日志,连上却无法上网则检查应用是否进入代理。
基础认知
v2rayN、v2rayNG 和 v2flyNG 怎么选?
Windows、macOS 和 Linux 选 v2rayN。Android 通常先选使用 Xray 内核的 v2rayNG;配置提供方明确要求 V2Fly 内核时,再考虑 v2flyNG。换客户端前,先核对节点使用的协议、传输方式和安全层。能导入同一份订阅,只说明客户端读到了内容,不代表所有节点都能由当前内核运行。
订阅地址和单节点链接有什么区别?
订阅地址用于获取一组节点,通常填入订阅分组设置,再执行更新;单节点链接描述一条连接,通常通过剪贴板导入。若收到的是账户页面,先找到页面内明确标注的订阅地址,不要把登录页填入分组。订阅地址可能带有访问凭据,发送截图或日志前应遮盖完整地址和查询参数。
系统代理和 TUN 模式接管的流量一样吗?
不一样。系统代理主要影响读取系统代理设置的应用;TUN 通过虚拟网卡接收被系统路由送入该接口的流量,也能覆盖部分不读取系统代理的应用。TUN 不等于所有请求都走代理,客户端的分流规则仍可让请求直连。排查时先只启用一种模式,避免把两套入口的结果混在一起。
客户端显示已启动,是否说明节点可用?
不能。已启动通常只表明内核进程已经运行,或 Android 的 VPN 会话已建立。远端握手和目标网站访问往往要等请求发出后才会发生。选定节点后,用一个已知正常的站点发起实际请求,再对照同一时间的日志。单凭托盘图标或 VPN 标志,无法判断应用是否进入代理,也无法确认远端连接是否成功。
安装配置
Android 安装包选 arm64 还是 universal?
设备和 Android 系统明确支持 arm64-v8a 时,优先选 arm64 安装包。无法确认系统支持的应用架构时,先选通用版。芯片支持六十四位并不意味着设备运行的是六十四位 Android 系统。通用版通常包含多种架构的组件,体积可能更大,也不能代替对最低系统版本和安装来源权限的检查。
首次导入订阅失败,应该先检查哪一步?
先区分请求失败和解析失败。请求失败时,核对地址是否复制完整、有无多余空格,并检查当前网络能否访问订阅服务;若返回未授权或禁止访问,核对账户状态和链接是否已更换。请求成功却未导入节点时,确认返回的是客户端支持的订阅内容,而不是登录页、错误页或单节点链接。
v2rayN 启动后立即退出怎么办?
先确认安装包与系统架构匹配,再查看启动日志或系统错误信息。若提示缺少运行库,按所选构建的要求安装对应运行环境;若提示拒绝写入,确认实际配置目录可写。升级后才出现故障时,先备份配置,再用独立目录测试干净的配置环境,不要直接删除原有订阅和路由规则。
开启 TUN 时提示权限不足怎么办?
先看日志指出的是创建虚拟网卡失败,还是写入系统路由失败。Windows 可按客户端提示以管理员权限重新启动;macOS 和 Linux 按所用构建的提示授权相关组件。Android 则需要确认系统弹出的 VPN 连接请求,并检查是否已有其他 VPN 占用会话。设备受组织管理时,先向管理员确认策略,不要为排查关闭系统保护。
使用技巧
配置路由分流时怎样确认规则生效?
先选定一个目标域名,确认正在使用的是预期路由配置,再发起一次新请求并查看命中的规则或出站记录。若结果与预期不同,检查是否有更靠前的通用规则先匹配,以及应用传入的是域名还是已解析的地址。一次只调整一条规则,保留修改前的配置,便于对比结果和回退。
怎样区分节点延迟测试和实际访问结果?
先看测试类型。TCP 测试主要判断到指定端口能否建立连接,不能验证代理认证、传输安全层或网页加载。通过代理发起的测试更接近真实请求,但仍取决于测试地址及其路由。若测试结果与浏览器表现不一致,用同一节点复测实际目标,并核对两次请求是否使用了相同的代理入口。
更改本地监听端口后,要同步修改哪些设置?
先重启内核并确认新端口正在监听,再更新手动填写了旧端口的浏览器扩展、终端代理变量和应用代理设置。若此前由客户端写入系统代理,重新应用该模式并核对系统中的地址。不要把 HTTP 和 SOCKS 端口互换;若当前内核使用混合端口,也应按调用方支持的代理类型填写。
提交故障描述时应该保留哪些信息?
记录客户端和内核版本、操作系统、代理模式,以及问题出现的具体步骤。保留故障前后几行日志,注明是首次安装、升级后出现,还是只在某个网络复现。对外分享前遮盖订阅地址、节点链接、认证字段及不便公开的地址。通常不需要发送完整配置;错误类别和发生顺序更有助于定位。
故障排查
V2Ray 节点测试超时,怎样判断问题范围?
在相同客户端、网络和测试方式下,比较一个已知可用节点和出现问题的节点。仅个别节点超时,先检查地址、端口、传输参数以及服务状态;所有节点同时超时,先确认本地网络和内核是否正常,再查看测试时的日志。若日志显示证书或认证错误,优先处理对应参数,不要只延长超时时间。
客户端连上后仍无法上网,先排查什么?
临时停用代理,用平时可直连的站点确认基础网络正常。恢复代理后重试同一地址,并查看该时刻的内核日志。没有请求记录时,先检查应用是否进入代理,或相关日志级别是否已启用;有请求但解析失败时,检查 DNS 路径;有出站但连接失败时,再核对路由选择和远端握手。每次只改一个设置。
为什么系统代理不生效,浏览器和终端表现不同?
先确认系统代理地址与客户端实际监听地址一致。浏览器可能跟随系统,也可能被扩展或独立代理设置覆盖;可临时停用相关扩展并重开浏览器验证。终端程序未必读取系统设置,应查该命令是否支持代理环境变量,并在当前会话核对地址、端口和协议。一个应用可用,不代表整个系统都在走代理。
已有节点还能用,为什么订阅更新失败?
已有节点来自此前保存的配置,能连接并不代表订阅服务现在可访问。先保留现有分组,执行一次手动更新并查看错误。域名解析失败时检查 DNS,出现超时时检查更新请求使用的网络路径,返回未授权时检查链接是否轮换或账户是否到期。手动更新成功但定时失败时,再核对分组更新开关、间隔和客户端运行状态。