设置路径与问题定位

客户端常见问题

v2rayN / v2rayNG 操作笔记。先按症状找到检查入口,再改动设置;一次只调整一项,保留可回退的配置。

排查顺序

从入口到访问结果

  1. 本地网络与客户端状态
  2. 订阅内容与服务器配置
  3. 系统代理、VPN 或 TUN 权限
  4. 目标应用、路由与 DNS

“已连接”与“访问成功”分开确认。

基础认知

先区分客户端、内核与远端配置,避免从错误的入口开始排查。

v2rayN、v2rayNG 与 v2flyNG 应该怎么选?

先按设备系统选客户端。Windows、macOS 与 Linux 桌面优先看 v2rayN;Android 优先看采用 Xray 内核的 v2rayNG,采用 V2Fly 内核的 v2flyNG 可作为备选。客户端负责导入、选择配置和管理代理,内核负责实际连接与转发。能否使用某份配置,还取决于所装版本支持的协议与传输组合,不能仅凭名称相似判断兼容。已有可用配置时,先核对协议字段,再决定是否更换客户端。

安装客户端后,为什么还需要订阅或服务器配置?

先看客户端的服务器列表是否已有配置。安装程序只提供图形界面和运行所需组件,不会自动生成远端服务器的地址、端口与认证信息。订阅是批量获取这些配置的入口,单条分享链接则通常对应一份配置。导入前应确认信息来源、有效期限及适用客户端。客户端可以免费使用,但远端服务的费用与使用条件由服务提供方决定。不要把软件下载完成,误当作远端服务也已经准备完成。

系统代理、TUN 模式和安卓 VPN 模式有什么区别?

先区分流量入口。系统代理把代理地址写入系统设置,主要影响愿意读取这些设置的应用;TUN 模式通过虚拟网络接口接收匹配的网络流量,涉及路由、DNS 与额外权限。v2rayNG 的 VPN 模式使用 Android 的 VPN 接口在本机接收流量,授权提示是建立该接口的必要步骤。这几种方式并不等于同一种全局开关,也不保证所有流量都转到远端。实际走向仍由路由规则、应用范围和例外项共同决定。

VMess、VLESS 等协议不同,会影响导入和连接吗?

先核对配置中的协议、传输方式和安全设置,再看当前内核是否支持对应组合。VMess 与 VLESS 是不同协议,不能只把协议名称改掉就互相转换;TLS、REALITY、WebSocket 等字段也需要与服务端一致。分享链接能够导入,只说明客户端识别了内容,不代表远端参数一定正确。遇到不支持的字段时,优先使用与当前客户端兼容的订阅格式,或向配置提供方确认,避免凭印象改动认证信息。

查看三款客户端的选型对比 →

安装配置

安装包架构、订阅地址与系统授权,分别确认,不混在一起处理。

安卓安装包的 arm64 与 universal 应该怎么选?

先在设备规格或可信的系统信息页面确认处理器架构。多数较新的安卓手机适合 arm64 包,它只包含对应架构的组件,文件通常更小;universal 包覆盖多种架构,适合架构不明确且安装条件允许的设备。购买年份只能作为线索,不能替代架构确认。若提示无法安装,还要核对系统兼容性、存储空间以及是否存在签名不同的同名应用。不要为尝试安装而直接卸载旧版,先备份配置和必要设置。

订阅链接导入失败,应该先检查哪里?

先到订阅分组设置,确认粘贴的是完整订阅地址,而不是购买页面、说明页或单条分享链接。检查复制时是否带入空格、换行、引号,或丢失地址末尾的参数。再区分报错发生在保存地址还是拉取内容:前者多与格式有关,后者还可能涉及网络、授权或返回内容。若地址能访问却返回登录页面,客户端仍无法把它当作订阅解析。分享排查记录前,应遮住完整订阅地址中的认证参数。

v2rayNG 首次连接为什么要求 VPN 授权?

先确认 v2rayNG 当前选择的是 VPN 模式。此模式需要系统允许客户端创建本地 VPN 接口,才能接收应用流量并交给内核处理;仅代理模式则需要其他应用主动填写本地代理地址。阅读系统授权提示后再决定是否允许。若授权窗口没有出现或连接立即停止,检查是否已有其他 VPN、工作资料策略或设备管理限制占用接口。不要反复切换多个 VPN 应用,先断开现有连接,再单独启动 v2rayNG 验证。

v2rayN 的 TUN 模式提示权限不足,怎么处理?

先关闭 TUN 模式,确认普通代理连接可以工作,再按当前版本提示检查权限与虚拟网络接口。Windows 可能需要提升运行权限或启用客户端提供的服务功能;macOS 与 Linux 的授权方式取决于具体安装包和版本。以界面提示与对应版本说明为准,不要照搬另一系统的命令。若提权后仍失败,查看日志中关于接口创建、路由或端口占用的首条错误。修改前记录原设置,每次只调整一个项目,便于判断原因。

按导入、连接、验证的顺序配置 →

使用技巧

连接可用以后,再收窄应用范围、调整路由或启用局域网共享。

首次连接时,怎样确认代理确实生效?

先选中准备使用的服务器,执行客户端提供的真连接测试,再确认系统代理或 VPN 模式已启用。随后在目标应用中访问已知可用的 HTTPS 页面,并检查客户端连接日志是否出现对应请求。测试成功只代表测试目标可达,不能代表所有应用与网站都正常。验证时不要同时改变节点、路由和 DNS;先保留一组配置作为基准。若浏览器可用而其他应用不可用,转去检查应用是否读取系统代理,而不是立即更换订阅。

分应用代理里的绕过与仅代理应该怎样理解?

先在 v2rayNG 设置中进入分应用代理,阅读当前模式的说明,再选择应用。绕过所选应用通常表示名单中的应用不进入代理接口,其余应用按当前规则处理;仅代理所选应用则把范围收窄到名单中的应用。不同版本的标签可能有差异,应以界面实际含义为准。应用进入接口后,流量仍可能被路由规则分为代理或直连。修改名单后重新连接,并完整退出目标应用再测试,避免旧连接让判断失真。

路由规则修改后,为什么访问结果没有立刻变化?

先确认修改的是当前正在使用的路由配置,并检查规则是否启用、顺序是否正确。较早命中的宽泛规则可能让后面的精细规则没有机会执行。保存后按客户端要求重新加载或重连,再关闭目标应用的旧连接重新测试。浏览器缓存、已有连接和 DNS 缓存都可能保留此前的访问结果。不要仅凭出口地址页面判断所有域名的走向;结合目标域名、命中规则和日志观察,才能区分规则未生效与测试方法不合适。

允许局域网连接开启后,其他设备还需要设置什么?

先在 v2rayN 参数设置中核对允许来自局域网的连接、实际监听端口及其支持的代理类型。其他设备要填写运行客户端那台电脑的局域网地址,不能填写代表设备自身的回环地址。再确认两台设备处于可互通的网络,防火墙仅对可信网络放行对应端口。访客网络隔离也可能阻止连接。共享只适合受控的局域网,不应把监听端口暴露到公共网络;停止使用后关闭共享,并恢复不再需要的放行规则。

查看局域网共享设置笔记 →

故障排查

先记录失败发生在哪一层,再用一组已知可用的设置做对照。

节点一直超时,如何区分本地网络与服务器问题?

先关闭代理,确认本地网络能完成普通访问,再在同一客户端中测试另一份已知可用配置。若只有单个节点超时,重点核对地址、端口、服务有效期以及传输参数;若全部超时,优先检查网络连接、系统时间、DNS 与本地安全软件。真连接测试失败并不单独证明服务器离线,也可能是测试目标不可达。保留错误发生时间和日志中的首条连接错误,再换一种网络复测,避免连续改动多个参数掩盖最初原因。

显示已连接却无法上网,或系统代理没有生效,怎么排查?

先在客户端确认当前服务器已选中,再检查系统代理是否为自动配置系统代理,并核对系统设置中的代理地址与实际监听端口是否一致。已连接通常只表示本地服务启动,不等于远端可达。若所有应用都失败,检查服务器测试与日志;若只有部分应用失败,检查其独立代理设置以及是否支持系统代理。不要在未排除端口错误前就开启 TUN。若退出客户端后仍无法访问,应检查并清除系统中遗留的本地代理设置。

以前能更新的订阅,现在更新失败了怎么办?

先保留现有可用配置,不要为了重试删除整个订阅分组。查看更新提示,区分解析失败、请求超时和授权失效:解析失败要确认返回的是订阅内容;超时要检查当前网络能否访问订阅入口;授权失效则需向提供方确认地址与有效期。若客户端提供通过代理更新的选项,应先确认所用代理本身可用,避免形成更新依赖。还要检查系统时间与证书错误。恢复更新后核对分组内容,再处理旧的重复条目。

安卓锁屏后断连,或只有域名访问失败,应该怎样记录问题?

先区分后台进程被结束与域名解析失败。锁屏后连接图标消失、客户端需要重新启动时,检查系统电池设置中的后台运行与省电限制,并留意其他 VPN 是否接管接口;图标仍在但域名请求报错时,查看日志中的解析错误,再核对 DNS 与路由设置。不要直接把所有问题都归为省电或 DNS。记录锁屏前后状态、发生时间、网络类型和具体错误,分享时删除订阅地址与认证字段,再按对应症状逐项复测。

进入按症状分章的故障排查文档 →

下载客户端