客户端配置参考 / FAQ

V2Ray 常见问题
订阅、代理与连接排查

面向 v2rayN、v2rayNG 与 v2flyNG。先区分配置获取、内核连接和应用接管,再按错误发生的位置检查。

首次配置:查看使用指南
概念与边界

基础认知

区分客户端、内核和服务端,明确各层负责的工作。

查阅术语表 →
V2Ray、Xray 与三款客户端是什么关系?

Project V 是相关代理工具的生态背景,V2Fly 与 Xray 是有共同历史的内核项目。内核负责协议处理、路由和连接,客户端负责订阅管理、界面与系统集成。v2rayN 用于桌面平台,具体内核能力取决于所选核心及其版本;v2rayNG 采用 Xray 内核,v2flyNG 采用 V2Fly 内核。排查时应同时记录客户端和内核信息,只看客户端名称不足以判断某项配置能否使用。

安装客户端后,还需要准备什么?

客户端是配置和运行代理连接的工具,安装完成并不会自动生成可用服务器。还需准备有权使用的订阅地址、分享链接,或完整的服务器参数。手动配置至少要核对地址、端口、协议与认证信息,涉及 TLS 或 REALITY 时还要核对对应安全参数。订阅地址通常包含访问凭据,应按敏感信息保存;截图、日志和求助内容中都应遮去完整地址、用户标识与认证字段。

VMess、VLESS、Trojan 与 REALITY 应怎样区分?

VMess、VLESS 和 Trojan 是客户端中可选的代理协议类型,REALITY 则是与 VLESS 等协议配合的传输安全方案,不是可直接替代前三者的同层选项。配置必须与服务端一致,不能为了更换名称而只改协议下拉框。选型先看服务端实际提供的参数,再看当前内核是否支持;VLESS 的加密字段也不等于整条链路的安全状态,还需结合 TLS、REALITY 等设置判断。

订阅地址、分享链接和配置文件有什么区别?

订阅地址用于向来源获取一组服务器配置,可随来源内容变化而更新。分享链接通常描述单个服务器,导入后并不因此具备自动更新关系。配置文件可能包含更多内容,例如出站、DNS 和路由,但能否完整导入取决于客户端支持的文件格式。浏览器能打开某个地址,不代表返回内容就是兼容订阅;网页、登录页和错误提示页都不能当作服务器列表导入。

系统代理、TUN 和 Android VPN 模式是否相同?

系统代理向遵循系统设置的应用提供代理入口,不保证接管每个程序。TUN 通过虚拟网络接口接收流量,通常还涉及路由、DNS 和较高权限。Android 客户端的 VPN 模式利用系统提供的虚拟网络接口接管选定应用的流量,出现 VPN 标识只说明接口已建立。三者都不代表所有请求一定走代理,最终去向仍受路由规则、绕过列表和分应用设置影响。

安装与接管

安装配置

从安装包架构到代理入口,先建立最小可用配置。

查看客户端选项 →
订阅导入失败,先检查格式还是网络?

先区分导入动作:单个分享链接应从剪贴板或分享链接入口导入,订阅地址应添加到订阅分组后执行更新。检查复制时是否混入空格、换行、说明文字,或误把管理后台网页当成订阅。随后查看提示是连接失败、认证失败,还是内容解析失败,分别对应网络、授权和格式问题。不要反复修改服务器协议来修复订阅解析错误,两者处在不同处理阶段。

Android 安装包的 arm64 与 universal 怎么选?

优先根据设备支持的应用 ABI 选择,而不只看处理器宣传名称。较新的主流设备通常可选 arm64;确认不了架构时,可选择包含多种架构的 universal 包,但它通常占用更多存储空间。部分设备虽然使用支持 64 位的芯片,系统仍可能只允许安装 32 位应用。若安装失败,还应检查系统版本、可用空间,以及已有应用的签名是否与待安装包一致,避免直接卸载导致配置丢失。

v2rayN 的桌面版与经典 WPF 版如何选择?

桌面版采用跨平台界面,经典 WPF 版面向 Windows 的传统界面使用习惯。先按下载页说明核对操作系统与架构,再选择界面版本,不要把界面差异理解成协议性能的直接差异。两种界面的菜单位置、备份内容和配置目录可能不同,迁移前应导出配置并记录自定义路由、DNS 和本地监听端口。遇到启动问题时,按该安装包提示检查运行环境,不要混用不同安装目录中的文件。

启用系统代理后,为什么有些程序仍然直连?

先确认客户端内核已运行,本地监听地址和端口与系统代理一致,再检查目标程序是否遵循系统代理。部分命令行工具、下载工具和具有独立网络设置的应用需要单独配置,浏览器扩展也可能覆盖系统设置。可先用一个明确遵循系统代理的应用测试,再检查路由是否把目标域名设为直连。确需接管更多流量时再评估 TUN,避免同时堆叠多个代理入口造成回环。

TUN 无法启动或提示权限不足,怎样处理?

先查看日志中失败发生在虚拟接口创建、权限申请还是路由写入阶段。Windows 按客户端提示授予所需权限;macOS 和 Linux 则按对应平台说明完成授权,不要照搬其他系统的驱动操作。暂时退出其他占用虚拟网络接口或修改默认路由的工具,再重新测试。不要通过长期关闭防火墙解决权限问题;如果只需要浏览器代理,可先使用系统代理验证服务器本身是否可用。

分组与策略

使用技巧

保持订阅与本地策略分离,减少更新和迁移时的意外变化。

阅读协议手册 →
订阅更新会覆盖手动添加的服务器吗?

更新通常作用于对应订阅分组,但替换、保留和去重行为会随客户端与设置变化。手动配置应放入独立分组,不要直接修改订阅生成的条目并假定下次更新仍会保留。更新前先备份重要配置,更新后检查当前分组、筛选条件和默认服务器是否变化。列表暂时看不到某条记录,也可能只是分组或过滤条件改变,应先取消过滤确认,不要立刻清空全部配置重新导入。

规则模式与全局代理应在什么情况下切换?

日常按规则模式运行,可让不同目标分别使用直连、代理或阻断出站。全局代理可作为短时间的对照测试,用来判断问题是否来自分流规则,但它不一定改变未进入客户端的应用流量。若全局代理可用而规则模式失败,应检查规则顺序、域名匹配与最终出站,不必先更换服务器。测试结束后恢复原模式,并确认局域网服务和本地设备访问仍符合预期。

Android 分应用代理怎样避免漏选?

先确认当前列表表示仅代理已选应用,还是绕过已选应用,两种逻辑相反。修改后按客户端要求重新建立连接,让新的应用范围生效。应用可能通过独立组件、工作资料中的副本或系统服务发起请求,仅勾选主应用不一定覆盖全部相关进程。测试时先缩小到一个目标应用,确认分流方向后再扩展名单;不要同时频繁更改分应用范围、DNS 和服务器,以免无法定位差异。

Mux 多路复用是否应该一直开启?

Mux 尝试在较少的底层连接上承载多个逻辑连接,但收益取决于协议、传输、服务端与使用场景,并不是固定的加速选项。某些组合不支持或不建议使用,尤其应按当前内核对 VLESS 流控等组合的说明设置。排查卡顿时先关闭 Mux 建立基线,再单独开启比较相同任务的表现。移动端电量还受信号、持续传输和后台唤醒影响,不能只凭开关状态判断续航。

桌面与 Android 之间怎样同步配置更稳妥?

由同一来源维护的服务器优先通过订阅地址分别导入,两端各自更新。单个手动配置可用分享链接或二维码迁移,但应检查协议和传输字段是否都被保留。客户端备份文件不一定跨端兼容,桌面路由、DNS、监听端口和 Android 分应用设置也不会自动对应。迁移时先验证一个服务器,再逐项重建本地策略;通过受控方式传递订阅和备份,不要把包含凭据的文件上传到公开位置。

按请求路径检查

故障排查

从应用入口、DNS、路由到远端握手,逐层缩小范围。

查看专题文章 →
服务器测试超时,应该按什么顺序排查?

先确认设备的普通网络可用,再检查服务器地址、端口、认证信息和设备时间。区分 TCP 连通测试与实际代理请求测试:端口可达不代表协议握手和目标访问成功,某项探测超时也不一定代表所有应用都不可用。查看日志是否出现域名解析、连接拒绝或握手失败,再对照相应参数。可换一个已知可用配置做对照,保持其他设置不变,避免同时切换网络和多项安全参数。

客户端显示已连接,但网页打不开怎么办?

已连接可能只表示内核或虚拟网络接口启动,并不保证远端链路成功。先查看一次真实网页请求是否进入日志:没有记录时检查应用代理入口、VPN 授权和分应用范围;有记录但失败时检查出站选择、DNS 和握手信息。再用不同目标测试,区分单个站点问题与普遍失败。若只有浏览器异常,还要检查扩展、自定义安全 DNS 与缓存;不要一开始就清除全部客户端数据。

订阅更新失败,但已有服务器还能用,是什么原因?

订阅获取和服务器连接是两条独立路径,已有配置可用并不保证订阅来源可访问。检查订阅是否过期、授权是否变化,以及日志中是否出现 HTTP 状态错误、证书错误或解析失败。更新路径支持直连与代理选择时,可按实际网络条件做对照,但要避免通过失效服务器更新而形成依赖。不要先删除现有分组;保留可用配置与备份,确认来源返回兼容内容后再更新。

怎样判断是 DNS 问题,还是服务器连接问题?

先看日志中的失败发生在域名解析前后:解析失败、返回空结果或解析器不可达,应从 DNS 路径查起;已得到地址后出现连接拒绝或握手错误,则继续检查远端连接。分别核对本地 DNS、远程 DNS 的请求去向,以及客户端是否接管系统解析。浏览器安全 DNS 可能独立发送请求,也应纳入检查。不要用直接访问 IP 的结果替代完整判断,HTTPS 仍可能依赖正确的域名与证书。

退出客户端后网络异常,如何恢复?

先检查系统是否仍指向客户端的本地代理端口,进程已退出而代理设置未清除时,应用会继续连接一个不存在的入口。使用客户端的清除系统代理功能,或在系统网络设置中恢复原先配置。使用过 TUN 时,还要检查虚拟接口、默认路由和 DNS 是否正确恢复,必要时按系统方式重新连接网络。操作前记录原有企业代理或自定义 DNS,避免把本来需要的网络设置一并删除。