客户端使用与排查

V2Ray 常见问题

从订阅、流量入口与连接日志定位问题。以下说明适用于 v2rayN、v2rayNG 与 v2flyNG;菜单名称可能随客户端版本变化,以当前界面为准。

基础认知

先区分客户端、内核和配置来源,再选择安装包与协议。

v2rayN、v2rayNG 与 v2flyNG 应该怎么选?

Windows、macOS 与 Linux 桌面使用 v2rayN,安装时再匹配系统和处理器架构。Android 通常选择使用 Xray 内核的 v2rayNG;已有配置明确依赖 V2Fly 行为时,再考虑 v2flyNG。图形客户端负责导入订阅、选择服务器和管理设置,内核负责实际连接与路由。客户端名称相似不代表功能完全相同,尤其要核对协议、安全层和传输方式。迁移前保留原配置,先用一条已知可用的配置测试,再导入其余分组。

安装客户端以后,还需要准备订阅链接吗?

安装客户端只得到配置与连接工具,不会自动生成可连接的服务器。需要准备自己管理或获授权使用的订阅地址、分享链接,或完整的服务器参数。订阅地址用于获取一组配置;分享链接通常对应单条配置,两者不能在所有导入入口中互换。先确认提供方说明的是哪一种,再选择订阅分组或剪贴板导入。订阅地址可能带访问凭据,应按密码管理,不贴到公开评论、截图或在线转换页面;本网站提供客户端说明,不分发订阅。

VMess、VLESS、Trojan 与 REALITY 是同一层的选项吗?

VMess、VLESS、Trojan 和 Shadowsocks 属于代理协议;REALITY 是安全层方案,不能直接当作另一种代理协议替换。一次连接还涉及传输方式、安全层、服务器地址与认证信息,必须与服务端逐项对应。例如,订阅中的 VLESS 配置可能同时包含 REALITY 参数,导入后应保留其公钥、服务器名称等要求。不能只修改协议下拉框就期待连接恢复。选型先看服务端已有配置与客户端支持范围,再比较功能需求,不按名称推断速度。

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

2015 年后主流安卓手机通常可先考虑 arm64,但最终以系统支持的应用架构为准,不能只看处理器宣传信息。部分设备的硬件支持 64 位,系统却只提供 32 位应用环境,这时 arm64 包仍可能无法安装。架构不确定时可选择 universal,它包含多种架构组件,文件通常更大,但仍受最低系统版本限制。若出现解析失败或应用未安装,先检查系统版本、可用存储和已安装应用的签名冲突,不要反复下载同一个不匹配的包。

相关页面:Android 安装包 · 协议与内核参考

安装配置

保留现有配置,用日志区分导入格式、更新请求与启动权限问题。

从剪贴板导入后没有服务器,应该检查什么?

先判断剪贴板里是分享链接、订阅地址,还是网页正文。分享链接应完整复制,避免混入说明文字、换行造成的截断或聊天工具附带的标点;订阅地址应加入订阅分组,再执行更新,而不是当作单条服务器导入。若导入后列表仍为空,查看客户端日志是否提示格式不支持、字段缺失或解析失败。不要把完整链接发给他人排查,可只描述协议类型和错误摘要。确认客户端支持该配置的协议与安全层后,再向配置提供方索取适用的原始格式。

v2rayN 订阅更新失败,怎样区分地址与网络问题?

打开订阅分组核对地址是否完整,尤其检查末尾参数是否丢失,再对该分组执行一次更新并查看日志。认证失败或访问被拒绝时,应检查订阅权限、有效期和提供方的访问要求;连接超时通常需要检查当前网络和更新请求的代理路径;解析失败则可能是返回了登录网页或不兼容内容。若界面提供通过代理更新的选项,只有当前代理已能工作时才使用,避免依赖失效配置获取新配置。不要先删除原分组;保留现有配置有助于比较更新前后的变化。

TUN 启动失败或提示权限不足怎么办?

TUN 通过虚拟网络接口接管流量,权限要求与普通系统代理不同。先关闭 TUN,确认同一服务器在普通代理方式下可以连接,再按当前 v2rayN 版本和系统的提示完成管理员授权、服务或虚拟接口组件设置。Windows 可检查管理员运行是否解决权限错误;macOS 与 Linux 应按系统授权机制处理,不要直接套用其他平台的步骤。同时退出可能占用虚拟接口或修改路由的其他工具。若启动后立即断网,先关闭 TUN 恢复连接,再记录接口、路由或权限相关的日志。

更新客户端之前需要备份哪些设置?

先使用客户端提供的备份或导出功能,保存订阅分组、手动添加的服务器、路由规则与自定义 DNS 设置,并记录本地监听端口和系统代理模式。备份可能包含订阅凭据与认证信息,应保存在受控位置。桌面版与经典 WPF 版切换、跨系统迁移或跨较大版本更新时,不要直接覆盖未知用途的配置目录。关闭旧客户端后再启动新版,避免端口冲突。新版先验证单条配置和订阅更新,确认规则行为符合预期后,再决定是否清理旧环境。

操作步骤:订阅导入与首次连接教程

使用技巧

系统代理、内核路由与分应用规则各管一层,调整时逐项验证。

自动配置系统代理后,为什么有些应用仍然直连?

系统代理只影响会读取该设置的应用,不等于设备上的全部流量都会经过客户端。先确认客户端仍在运行、内核正常启动,并检查系统代理地址和端口是否对应当前监听端口。浏览器扩展、应用自己的代理设置和企业策略可能覆盖系统配置,可用一个没有独立代理设置的浏览器进行对照。需要手动填写代理时,应匹配 HTTP 或 SOCKS 类型,不要只照抄端口数字。若目标应用不支持系统代理,再评估 TUN;不要在尚未验证普通代理时同时开启多种接管方式。

路由模式与系统代理模式有什么区别?

系统代理模式决定应用是否把请求交给客户端,路由模式决定已经进入内核的请求走代理、直连还是被阻止。因此,选择代理路由并不能让忽略系统代理的应用自动进入客户端;清除系统代理也不一定停止 TUN 或手动配置的应用流量。排查时先固定流量入口,再改变路由规则,观察同一目标的结果。绕过大陆等预设依赖具体规则与域名解析结果,自定义规则还可能优先匹配。修改前记录当前模式,避免同时改入口、路由和 DNS 后无法判断哪一步生效。

v2rayNG 的分应用代理应该怎样设置?

在 v2rayNG 的分应用代理设置中,先确认当前是仅代理选中的应用,还是绕过选中的应用,再勾选需要处理的程序。两种列表含义相反,只看勾选状态容易造成误判。保存后按界面提示重新建立连接,并用目标应用实际发起请求验证;应用已存在的长连接可能需要退出后重开。系统组件、共享服务或应用调用的外部程序也可能影响结果。若发现其他应用意外直连,先检查列表模式与选择范围,再检查路由,不要立即更换服务器或清空全部配置。

安卓锁屏后断开,如何调整后台与省电设置?

先确认断开是否只在锁屏、后台停留或切换网络后发生。检查系统是否限制 v2rayNG 的后台运行、电池使用和移动数据权限,按设备设置允许必要的后台活动;部分系统还提供自启动或后台锁定选项。调整后锁屏一段时间再验证,避免一次修改所有省电策略。持续连接会产生一定耗电,分应用代理可缩小处理范围,但不能保证降低所有场景的消耗。如果前台也频繁断开,应转查线路、服务器和日志,而不是继续扩大后台权限。

进一步阅读:v2rayNG 耗电与后台运行设置

故障排查

连接状态只是入口信息;实际请求结果与日志才能帮助缩小故障范围。

服务器测试超时,是否就说明节点失效?

单次超时不足以判断服务器失效。先区分 TCP 连通性测试与真连接测试:前者主要检查目标端口能否建立连接,后者还依赖代理握手、测试地址和相关解析。选择同一服务器重复少量测试,再用另一条已知可用配置作对照。如果只有某一条失败,检查地址、端口、认证信息及安全层参数;如果全部失败,优先检查本地网络、内核启动和测试目标是否可访问。系统时间偏差也可能影响认证或证书验证,应先同步时间,再根据日志判断故障所在。

显示已连接,但浏览器无法上网怎么排查?

已连接往往只说明本地代理服务或安卓 VPN 接口已启动,不代表远端握手成功。先确认选择了正确服务器,执行真连接测试并查看日志。随后检查浏览器是否确实使用当前代理、系统代理端口是否匹配,以及是否同时运行其他接管流量的工具。若部分网站可用而部分不可用,再检查路由规则和 DNS;若全部不可用,先换一条已知可用配置对照。每次只改一个设置,并保留原值。退出客户端后仍无法直连时,检查系统中是否残留了指向已关闭端口的手动代理。

日志提示 DNS 解析失败,应该先改哪里?

先区分无法解析的是服务器域名,还是通过代理访问的目标域名。前者会阻止建立远端连接,应检查本地网络解析是否正常、服务器域名是否填写正确;后者则需要检查内核 DNS 设置、路由规则及解析请求的出口。TUN 场景还要考虑系统 DNS 是否被接管,以及其他网络工具是否同时改写设置。不要把所有解析器一次替换,也不要随意用 IP 代替需要服务器名称验证的域名。记录具体错误和涉及的域名类别,恢复到可工作的设置后再逐项调整。

v2rayN 提示本地端口被占用怎么办?

先退出重复启动的客户端,并检查是否有其他代理工具正在监听相同端口。Windows 可在资源监视器的网络页面查看侦听端口和对应进程;其他系统可使用其端口查看工具。确认进程用途后再决定关闭,不要终止不明系统服务。也可在 v2rayN 参数设置中改用空闲的本地端口,然后重启相关服务。端口变化后,重新应用系统代理,并同步浏览器、终端或其他应用中手动填写的代理地址。HTTP 与 SOCKS 监听项应按当前版本界面核对,不能假定所有版本都使用同一端口。

相关笔记:定位端口冲突 · 连接速度分层排查