FAQ / 配置与排查
v2rayN / v2rayNG 常见问题
按客户端选择、订阅导入、流量接入和连接故障查阅。排查时固定一条配置和一个测试目标,每次只调整一个设置。
基础认知
先区分客户端、内核、协议与订阅,避免在错误的设置入口反复尝试。
v2rayN、v2rayNG 和 v2flyNG 应该怎么选?
桌面端优先查看 v2rayN,适用于 Windows、macOS 与 Linux;Android 优先查看采用 Xray 内核的 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。选择客户端后,还要确认服务端配置所需的协议、传输方式与安全层是否受当前内核支持。三款产品不是同一个程序的不同皮肤,设置位置与配置导入能力可能不同。迁移时建议先导入一条配置并验证,再转移订阅和路由规则,不要直接覆盖另一款客户端的数据目录。
V2Ray、Xray 内核与图形客户端是什么关系?
Project V 是相关代理工具的生态背景,V2Fly 与 Xray 是常见的内核家族;图形客户端负责订阅管理、配置编辑和启动控制,内核负责实际连接、路由与转发。客户端窗口能打开,不代表内核已经成功启动。排查时应分别记录客户端版本、内核类型和启动日志。看到不支持的配置字段,应核对该字段所属内核及适用版本,而不是仅凭客户端名称判断兼容性。内核更新也不等于订阅参数会自动变成正确配置。
VMess、VLESS、Trojan 和 REALITY 如何对应?
VMess、VLESS 与 Trojan 属于代理协议;REALITY 是 Xray 生态中的安全层方案,不是能够独立替代地址、端口和用户标识的节点类型。连接配置还会包含传输方式、TLS 或 REALITY 参数,必须与服务端逐项对应。不能只把协议下拉框从 VMess 改成 VLESS,就期待原配置继续工作。使用 REALITY 时尤其要核对服务端提供的公钥、服务器名称和 shortId 等参数。遇到字段缺失,应向配置提供方确认,不要靠尝试随机值补齐。
分享链接与订阅地址有什么区别?
以 vmess://、vless:// 或 trojan:// 开头的内容通常是单条分享链接,导入后保存一条连接配置;订阅地址通常是一个 HTTPS 地址,客户端访问它后获取一组配置,并可再次更新。浏览器能打开订阅网址,不代表返回内容一定符合当前客户端要求,也可能返回登录页或错误提示。应把单条链接交给剪贴板导入,把订阅地址填入订阅分组。订阅地址可能包含访问凭据,截图、日志和求助内容都应先隐藏完整地址及其查询参数。
安装配置
安装包架构、订阅入口和网络授权分别检查。客户端入口集中在下载页。
Android 安装包的 arm64 与 universal 怎么选?
2015 年后主流 Android 手机通常优先选择 arm64,但最终应以设备支持的应用 ABI 为准,处理器支持 64 位不等于系统一定提供 64 位应用环境。universal 包含多种架构,体积通常更大,适合无法确认架构时尝试。出现解析失败时,还要排查系统版本要求、下载是否完成,以及安装包是否与原应用签名兼容。不要通过反复卸载来试架构;卸载前先备份配置,并注意备份文件可能包含订阅地址和连接凭据。
v2rayNG 订阅导入失败,应该先检查什么?
先区分导入对象:单条分享链接使用剪贴板导入,订阅网址进入订阅分组设置。复制时去掉网址前后的空格、换行和中文标点,确认没有把网页标题一起粘贴。保存分组只是保存地址,通常还需要执行更新订阅才会出现配置。若更新后仍为空,检查地址是否过期、是否要求登录,以及返回格式是否被客户端支持。不要把订阅网址直接当成节点服务器地址填写。需要提交错误信息时,保留错误类型,隐藏订阅凭据和个人配置内容。
桌面系统代理与 TUN 模式需要同时开启吗?
两者是不同的流量接入方式。系统代理主要供遵循操作系统代理设置的应用使用;TUN 通过虚拟网络接口接入流量,覆盖范围还受路由、排除规则和 DNS 配置影响。初次配置建议先单独验证系统代理,再按实际需求测试 TUN,避免同时改动多个变量。部分环境可以组合使用,但不应默认认为同时开启就更完整。切换前记录原有设置,退出客户端后确认系统代理和网络路由已恢复,尤其是在多个网络工具并存的设备上。
TUN 启动提示权限不足或虚拟网卡失败怎么办?
先查看启动日志,确认失败发生在权限申请、虚拟接口创建还是路由写入阶段。桌面端按客户端提示完成必要的系统授权,Windows 可能需要管理员权限或服务模式,其他桌面系统也可能要求授权安装网络组件。Android 上应确认允许建立 VPN 连接,并检查是否有其他 VPN 应用占用连接。不要关闭全部安全机制来绕过错误,也不要随意删除系统网卡。若启用 TUN 后网络中断,先停用 TUN 恢复网络,再逐项核对冲突工具、接口设置和路由。
使用技巧
测试方法、规则命中和 DNS 解析应分开验证,避免把单项测试结果当作整体连接结论。
V2Ray 延迟测试有结果,为什么应用仍然连接失败?
测试结果取决于测试方法。TCP 测试通常只说明目标端口能够建立连接;实际请求测试还涉及代理握手、目标站点和 DNS。某种测试成功不能证明所有应用都经过代理,也不能证明所有目标都可访问。先查看客户端采用哪种测试,再用同一条配置访问一个明确的 HTTPS 目标,观察连接日志是否出现对应请求。不要仅按测试数值排序判断可用性。测试超时也可能来自测试目标本身,应结合正常业务请求和日志定位,而不是反复切换配置。
规则模式、全局代理与直连应该怎样验证?
客户端中的模式名称可能不同,应以实际生成的路由规则为准。规则模式按域名、IP 或其他条件选择出站;全局代理通常把接入的流量交给代理出站;直连则不通过远端代理转发。全局代理并不意味着未接入客户端的应用也会自动被接管。验证时固定同一个目标,先确认应用流量进入客户端,再查看命中的出站标签。若全局可用而规则模式失败,优先检查规则顺序、规则数据文件和 DNS,不要立即修改服务器地址或用户标识。
更新订阅前怎样保护自定义配置?
先确认需要保留的是订阅生成的节点、手动添加的节点,还是客户端级别的路由与 DNS 设置。订阅更新可能重建所属分组中的条目,直接修改订阅节点的参数可能在下次更新后丢失。可把需要长期维护的配置复制到独立分组,并使用客户端提供的导出或备份功能保存设置。备份后检查文件是否实际生成,不要只依赖成功提示。恢复时先在少量配置上验证兼容性。导出内容往往包含敏感参数,应存放在受控位置,不要作为公开附件发送。
DNS 设置应该在哪里修改,如何避免越改越乱?
先区分系统 DNS、浏览器安全 DNS 与内核 DNS,它们可能服务于不同阶段。应用自行解析域名时,内核未必能按预期的域名规则处理请求;TUN 模式还可能涉及 DNS 接管。先记录原值,每次只调整一处,再使用同一目标验证并查看日志。不要简单认为填入某个公共 DNS 地址就能修复所有问题。修改 domainStrategy 或 queryStrategy 前,应确认当前内核支持的取值及其作用阶段,路由解析策略与查询地址族策略不是同一个设置。
故障排查
按设备网络、流量接入、域名解析和远端握手的顺序缩小范围。记录错误类型比反复重装更有帮助。
节点持续超时,怎样区分网络问题与配置问题?
先检查设备能否正常访问普通网站,再确认当前配置的服务器地址、端口、协议与安全层参数没有复制错误。若只有一条配置失败,优先检查该条配置和服务端状态;若全部失败,检查本地网络、内核启动状态和系统时间。日志中的连接超时、认证失败与证书错误含义不同,应保留具体错误类型。更换网络可帮助判断问题范围,但一次只改变一个条件。不要通过关闭证书验证掩盖握手错误,也不要把端口可达误当成代理连接已经建立。
客户端显示已连接,但网页打不开怎么办?
已连接通常只表示客户端服务或本地接口启动,并不保证远端连接成功。先打开日志,再发起一次网页请求:没有请求记录时,检查应用是否使用系统代理、本地端口是否正确,以及是否被其他代理插件接管;有请求记录时,继续查看 DNS、握手和出站错误。先关闭 TUN,仅用一种接入方式完成验证,减少路由冲突。如果只有域名访问失败,应重点检查解析链路。不要用直接访问 HTTPS 站点的 IP 地址作为唯一判断依据,因为证书与站点选择可能依赖域名。
v2rayN 系统代理对浏览器或命令行不生效怎么办?
先确认内核已运行,并核对客户端实际监听的地址、HTTP 或 SOCKS 端口;不要照搬教程中的端口数字。浏览器检查代理扩展、独立代理设置和已有连接,必要时重启浏览器后复测。命令行程序不一定读取系统代理,可能需要该程序的代理参数或 HTTP_PROXY、HTTPS_PROXY 等环境变量,并检查 NO_PROXY 是否排除了目标。协议前缀必须与监听服务相符。终端中的旧环境变量也可能覆盖预期设置,应分别测试浏览器和终端,不要把一方成功当成另一方已经生效。
订阅更新失败或返回空列表,如何排查?
先保留现有可用配置,记录更新时的错误提示。连接超时应检查网络路径和客户端是否支持通过代理更新订阅;HTTP 401 或 403 通常需要确认授权、有效期或访问限制;成功返回但列表为空,则应检查内容格式和订阅本身是否仍有条目。部分地址会返回网页而不是配置文本,浏览器显示页面不代表订阅有效。若订阅必须经代理访问,应先确认用于更新的配置可以连接,避免依赖一个尚未成功更新的分组。不要连续删除并重建分组,以免丢失定位问题所需的信息。