FAQ / 客户端问题索引
V2Ray 常见问题
按配置阶段查找问题。先确认流量是否进入客户端,再检查远端连接、路由与 DNS;每次只改一个条件,保留可回退的配置。
概念 / 客户端 / 接入范围
基础认知
先分清客户端、内核与配置,再选择适合设备的接入方式。
V2Ray、内核与图形客户端是什么关系?
V2Ray 通常指 Project V 相关的代理技术与工具生态;V2Fly 与 Xray 是其中常见的内核家族。内核负责协议连接、路由匹配与数据转发,图形客户端负责订阅管理、设置界面与进程启动。排查时要分别记录客户端名称和实际运行的内核,不能只写使用了 V2Ray。某项协议或传输能否工作,还取决于内核版本、客户端配置生成方式与服务端参数是否一致。
v2rayN、v2rayNG 与 v2flyNG 应该怎么选?
Windows、macOS 与 Linux 桌面环境优先查看 v2rayN;Android 设备通常选择使用 Xray 内核的 v2rayNG,需要 V2Fly 内核方案时再评估 v2flyNG。选择依据是设备系统、订阅所需协议与路由需求,而不是名称是否相近。导入前确认配置与所选客户端兼容,已有可用配置时先保留备份。更换客户端后需要重新检查系统代理或连接授权,原客户端的接入状态不会自动迁移。
系统代理、全局与绕过大陆模式有什么区别?
系统代理是应用接入客户端的一种方式,主要影响遵循系统代理设置的软件。全局与绕过大陆属于路由策略,决定已经进入内核的连接走哪个出站。选择全局不代表设备上所有应用都会自动接入;选择绕过大陆也不保证每个目标都直连,仍要看具体规则、规则顺序与数据库。测试时先确认应用流量确实进入客户端,再检查路由结果,避免把接入问题误判为分流问题。
安装客户端后,是否还需要订阅或服务器配置?
客户端提供配置与连接能力,安装本身不会生成可用的远端服务器。使用远端代理出站需要合法取得的订阅地址、单条分享链接或完整服务器参数。订阅是配置集合的更新入口,不等于某个协议,也不等于客户端账号。拿到配置后先核对地址来源、有效期与支持的客户端,再执行导入。本站提供客户端入口与技术说明,不分配节点;订阅相关的授权或额度问题应向对应服务提供方确认。
安装包 / 导入 / 权限
安装配置
安装错误与连接错误分开处理。先确认系统架构,再导入配置和授予必要权限。
订阅导入失败,应该先检查什么?
先区分订阅地址与单条分享链接:前者应添加到订阅分组,后者使用从剪贴板导入分享链接一类入口。复制地址时去掉首尾空格、换行和聊天软件附带的标点,并确认没有复制成介绍页面的网址。随后查看导入提示;若返回网页或格式不支持,需确认提供方输出的订阅类型与客户端兼容。不要把完整订阅地址发到公开讨论区,其中可能含访问凭据。导入后还要更新分组并确认条目已经出现。
Android 安装包选 arm64 还是 universal?
大多数较新的 Android 手机使用 arm64,但最终应以设备操作系统支持的应用架构为准,不能只根据处理器型号或购机年份判断。已确认支持 64 位应用时优先选 arm64;架构不明确时可选 universal,代价是安装包通常更大。若出现解析失败或无法安装,还要检查系统版本、安装来源权限,以及是否已有签名不同的同名应用。需要卸载旧应用时,先导出配置并确认备份可用,避免丢失自定义规则。
v2rayN 安装包如何匹配系统与芯片?
先在系统信息中确认操作系统与处理器架构,再到对应平台入口选择。Windows 下载区区分桌面版与经典 WPF 版;macOS 区分 Apple Silicon 与 Intel;Linux 则同时考虑发行版的软件包格式和 x64、arm64 架构。deb 与 rpm 是包管理体系的差异,不是代理协议差异。安装报错时记录包名和系统提示,先核对支持环境与依赖条件,不要通过随机更换内核或覆盖程序目录处理安装层面的错误。
TUN 模式提示权限不足,怎么处理?
TUN 需要创建虚拟网络接口并修改路由,桌面端通常需要管理员权限、提权服务或相应网络能力。先关闭 TUN,确认普通代理可以连接,再按当前客户端提示完成授权;Linux 还应确认系统提供 TUN 设备及所需权限。Android 使用的是系统 VPN 授权,需要在连接确认框中允许。若已有其他 VPN 或网络接管软件运行,先停止后重试。授权后仍失败应查看接口创建日志,不要直接关闭整套防火墙或长期放宽全部权限。
验证 / 分流 / 日常维护
使用技巧
通过实际请求确认效果。规则改动、后台设置与内核切换都保留对照条件。
怎样验证代理已经生效,而不只看连接图标?
先选择一条配置并启动连接,再让一个明确遵循系统代理的浏览器访问已知可达的网站。同步查看客户端连接记录或日志,确认测试请求进入内核并使用预期出站。连接图标通常只说明进程或本地服务已启动,不能证明远端握手成功。测试时可以临时简化路由,完成后恢复日常策略。若浏览器可用而其他软件不可用,应检查该软件的代理设置与接入方式,不要立刻更换整套服务器参数。
路由分流规则为什么没有按预期命中?
路由通常按配置顺序匹配,较宽泛的规则放在前面可能遮住后续精细规则。先确认请求进入的是当前配置,核对 domain、ip 与 outboundTag 的条件和标签是否对应,再查看命中记录。域名规则需要内核获得域名信息;只有目标 IP 时,不一定命中 geosite 条目。geoip 与 geosite 数据也需要与配置兼容。每次只修改一项并重启或重载配置,保留修改前的规则,便于比较结果和回退。
v2rayNG 后台断连,分应用代理又该怎么设置?
后台断连先检查系统是否限制 v2rayNG 的后台活动,在电池设置中按需允许后台运行,并确认系统 VPN 授权仍有效。部分设备还需要单独允许自启动,菜单名称取决于系统版本。分应用设置中要先分清名单表示仅代理所选应用,还是绕过所选应用,保存后重新建立连接再测试。系统 VPN 图标存在不代表每个应用都会进入代理;名单方向选反时,浏览器与其他应用可能表现完全不同。
切换内核或更新客户端之前需要备份哪些内容?
至少保存订阅分组、自定义服务器、路由规则、DNS 设置与本地监听端口;使用导出功能后,确认备份文件确实生成且保存在可找回的位置。不同内核支持的协议字段和路由语法可能不同,切换后先用单条已知可用配置测试,再恢复复杂规则。订阅重新更新不一定能恢复手工添加的条目。备份中可能包含订阅凭据与服务器认证信息,应限制访问,不要作为普通截图或日志附件公开上传。
更新失败 / 超时 / 网络恢复
故障排查
记录错误阶段,不只记录“连不上”。先恢复基础网络,再逐项验证代理链路。
订阅之前可用,为什么现在更新失败?
先读取更新日志,区分域名解析、连接超时、证书错误、授权失败与内容解析失败。确认订阅未过期、设备日期准确,且地址没有被提供方更换。如果更新需要经过代理,而当前选中的节点已经失效,会形成无法更新也无法连接的循环;可按客户端提供的更新方式尝试直连,或切换到另一条已知可用配置。返回授权错误时应核对订阅状态,不要连续重复请求,也不要靠关闭证书验证掩盖问题。
节点测试超时,怎样定位是配置还是网络问题?
先看超时发生在连接地址、协议握手还是实际请求阶段。核对服务器地址、端口、传输方式、TLS 或 REALITY 相关字段是否与提供方一致,并检查设备时间。再用同一条配置更换本地网络测试,或在同一网络比较另一条已知可用配置,一次只改变一个条件。ICMP 测试失败不能直接证明代理不可用,TCP 连接成功也不能证明协议认证成功。日志若显示认证或握手错误,应优先核对参数,而不是反复调整本地路由。
显示已连接但无法上网,或系统代理不生效怎么办?
先暂停 TUN 和复杂分流,用普通系统代理测试一条已知可用配置。确认内核运行正常、本地监听地址和端口与系统代理一致,并检查浏览器扩展或其他代理工具是否覆盖设置。若日志里没有测试请求,优先排查应用是否遵循系统代理;有请求但解析失败则检查 DNS,有握手失败则核对远端配置。命令行工具与部分桌面应用需要单独配置代理。退出客户端后仍无法联网时,检查是否残留指向已停止端口的系统代理设置。
DNS 错误与 TUN 冲突造成断网,如何安全恢复?
先在客户端中正常关闭 TUN 并退出其他 VPN,恢复自动获取 DNS 或此前可用的网络设置,再测试基础网络。若基础网络正常,只在开启客户端后失败,检查 DNS 请求所走出站、解析服务器可达性及其是否依赖尚未建立的代理,避免解析循环。需要重启时先保存日志与配置,重启后只启动一个网络接管工具。恢复连接后逐项启用路由、DNS 与 TUN,确定触发项;不要一次重置全部参数,否则难以定位原因。