帮助中心 · 配置与排查
客户端常见问题
从订阅导入到连接验证,按现象检查设置。先保留当前配置,再逐项调整;菜单名称可能随客户端版本变化,以实际界面和日志为准。
基础认知
先区分客户端、内核与流量接管方式,再选择配置入口。
v2rayN、v2rayNG 与 v2flyNG 应该怎么选?
Windows、macOS 与 Linux 桌面端选择 v2rayN;Android 通常选择使用 Xray 内核的 v2rayNG,需要匹配 V2Fly 配置时再考虑 v2flyNG。选型先看操作系统,再看服务端要求的协议、传输与安全设置。三个客户端的菜单名称和配置支持并不完全一致,不能只凭名称相近就互换配置。涉及 REALITY 等设置时,应进一步确认所选内核及客户端版本是否提供对应字段。
安装客户端之后,还需要准备什么?
客户端负责读取配置、建立连接和执行路由规则,并不随安装自动获得可用服务端。开始前需要准备有权使用的订阅地址、分享链接或完整服务端参数,确认地址、端口、认证信息以及传输和安全设置齐全。订阅地址和分享链接可能包含访问凭据,不宜贴到公开讨论区,也不要把配置截图中的二维码直接发送给他人。若来源只提供部分参数,应先补齐信息,再尝试导入与连接。
VLESS、REALITY 与 Xray 内核是什么关系?
VLESS 是代理协议,REALITY 属于传输安全方案,Xray 则是执行这些配置的内核;三者不是同一层级的可替换选项。客户端中常见的组合是协议选择 VLESS、安全设置选择 REALITY,再按服务端要求填写传输方式及相关参数。不能仅把协议名称改成 REALITY,也不能只切换内核就补齐缺失字段。遇到配置不支持时,先检查客户端和内核的能力,再核对服务端给出的组合要求。
系统代理、VPN 接口与 TUN 模式有什么区别?
桌面系统代理把代理地址告知愿意遵循该设置的应用,部分程序会忽略它;TUN 通过虚拟网络接口接管符合规则的流量,通常还涉及权限、路由和 DNS 配置。Android 上 v2rayNG 使用系统 VPN 接口建立本地转发通道,首次连接会请求系统授权。这不代表所有流量必然经过远端,最终仍由路由和应用范围设置决定。排查时先选一种接管方式,避免同时启用多个代理工具导致路径交叠。
安装配置
依次确认安装包架构、导入内容、系统权限和配置备份。
Android 安装包选 arm64 还是 universal?
近年的主流 Android 手机通常适合 arm64,但最终要以设备系统支持的应用架构为准,而不只看处理器型号或购买年份。能确认系统支持 64 位 ARM 应用时选择 arm64;不确定架构时可选 universal,它包含多种架构,文件通常更大。若安装提示解析失败,还要检查系统版本要求、下载是否完成以及旧版签名是否冲突。不要立即卸载已有客户端,应先导出需要保留的配置,再决定后续操作。
从剪贴板导入订阅失败,先检查哪里?
先分清复制的是订阅地址还是单条分享链接:订阅地址应添加到订阅分组,分享链接则使用客户端支持的链接导入入口。检查剪贴板内容是否混入说明文字、换行、前后空格或聊天软件附加的标点,再确认应用具有读取剪贴板的条件。若订阅分组已建立但列表仍为空,需要执行更新订阅,单纯保存地址不会自动证明获取成功。仍失败时查看更新日志,区分链接无法访问与返回内容无法解析两类问题。
v2rayNG 首次连接的 VPN 授权或 TUN 权限失败怎么办?
v2rayNG 首次启动连接时,需要在系统弹出的 VPN 连接请求中明确允许;拒绝后应停止连接,再重新启动并确认授权。同时检查是否存在另一款使用 VPN 接口的应用、工作资料策略或始终开启的 VPN 限制。桌面 TUN 则应按客户端提示安装或启用所需服务,并授予必要权限,不能照搬 Android 操作。若仍失败,读取日志中的权限或虚拟接口错误,避免通过反复改协议来处理与协议无关的系统授权问题。
切换客户端或内核前,怎样保留原来的配置?
先使用当前客户端提供的导出或备份入口,保存订阅分组、手动添加的服务器和自定义路由,并记录本地端口、DNS 及应用范围设置。备份中可能含有凭据,应保存在受控位置。导入新客户端后先核对字段,再选择一条已知可用的配置进行验证;不同内核的扩展字段未必能够完整迁移。订阅可重新获取的条目与手动编辑的条目应分开处理,确认迁移成功后再清理旧配置,避免把重装当作第一步。
使用技巧
把路由、系统代理和订阅管理分开检查,减少设置之间的干扰。
怎样设置本地站点直连、其他站点走代理?
先选择符合目标的路由预设,再检查局域网地址、需要直连的域名和默认出口。自定义规则通常按顺序匹配,应将更具体的例外放在宽泛规则之前,并确认引用的 geosite、geoip 数据在当前内核中可用。不要仅凭页面能否打开判断分流结果,应结合客户端日志中的目标地址与出站选择检查。修改规则后重新建立测试连接,必要时关闭应用已有连接,以免连接复用让旧路由结果继续保留。
v2rayN 的系统代理不生效,应该怎么验证?
确认客户端已选择有效配置且内核正常启动,再检查系统代理是否指向实际启用的本地监听地址和端口。SOCKS 10808、HTTP 10809 是常见设置,但应以当前客户端配置为准,不要机械套用。随后检查浏览器扩展、应用自有代理设置和其他代理工具是否覆盖系统设置。可在支持手动代理的应用中指定同一本地端口进行对照:手动代理有效而系统代理无效时,重点排查应用是否遵循系统设置。
订阅更新会覆盖手动修改的服务器参数吗?
订阅条目通常由订阅返回内容管理,更新时可能重新生成或替换,因此不宜把长期保留的修改只写在订阅条目里。需要调整传输、备注或其他参数时,可在客户端允许的情况下复制为独立条目,并清楚标记用途;独立条目也可能因服务端变更而失效。路由规则、订阅分组设置和服务器字段属于不同配置层,备份时应分别确认。更新后检查当前选中的服务器是否仍存在,避免继续使用已被移除或替换的条目。
移动端后台断连或耗电增加,如何调整?
先区分后台被系统停止与连接持续重试:前者常见表现是应用被清理后通道消失,后者通常能在日志中看到重复连接错误。按需允许客户端后台运行,并检查电池优化及自启动限制;不要因此为所有应用关闭节电策略。减少不必要的自动测试、过密的订阅更新和长期开启的详细日志,再观察同一网络下的表现。耗电还受信号质量、传输方式和业务流量影响,不能仅凭协议名称推断某种配置一定更省电。
故障排查
记录现象与日志中的错误类型,每次只改变一个条件。
订阅更新失败或解析后列表为空怎么办?
先看日志是否已经取得响应:连接超时、证书错误与返回内容解析失败是不同问题。确认订阅地址未过期、凭据仍有效,并检查返回内容是否实际为登录页、错误提示页或客户端不支持的格式。若更新需要经过现有代理,应先确认这条代理本身可用,再选择相应更新方式。不要公开粘贴完整订阅地址排查,也不要连续删除分组重建。保留原配置并逐项检查,才能在更新恢复前继续使用已有的有效条目。
节点测试超时,为什么浏览器有时仍能访问?
测试超时只说明该测试流程未在限定时间内成功,可能受测试地址、DNS、连接方式或服务端状态影响,并不等同于所有业务流量均不可用。先确认测试使用的是 TCP 连通性还是实际请求,再用同一条配置访问明确的测试页面并查看日志。若实际请求也失败,依次核对地址、端口、认证、传输与安全字段,并尝试另一网络作对照。不要把多次重复测试的偶然结果当作性能结论,也不要只按一个测试数字选择配置。
显示已连接,但网页仍打不开,怎么排查?
已连接往往只代表本地内核或 VPN 接口已启动,不保证远端连接、DNS 和路由都正常。先查看日志中是否有认证、握手或解析错误,再确认浏览器流量确实进入客户端。若域名解析失败,检查 DNS 设置及其查询路径;若仅部分站点失败,检查路由命中和目标出口;若所有请求都失败,再核对服务端参数与系统时间。每次只调整一类设置并保留原值,避免同时改 DNS、协议和路由后无法判断真正原因。
日志出现证书或握手错误,要关闭验证吗?
不建议把关闭证书验证作为常规解决方法。先检查设备日期和时间、服务器名称、服务端证书配置,以及所用协议对应的安全字段。TLS 的服务器名称与连接地址可能不同,应按服务端提供的信息填写;REALITY 还需核对公钥、short ID 等参数,不能用随意改名替代匹配。保留报错类型和发生阶段,再向配置提供方确认需要的字段。若只是某个网络触发错误,可换网络对照,但仍应先定位问题再修改安全选项。