客户端问题索引
V2Ray 常见问题
从订阅导入到连接排查。先找到出错的环节,再检查对应设置。
客户端与内核
基础认知
先分清配置来源、内核兼容与流量入口,避免在错误的环节反复调整。
v2rayN、v2rayNG 和 v2flyNG 应该怎么选?
Windows、macOS 和 Linux 桌面先选 v2rayN;Android 通常先选使用 Xray 内核的 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。客户端负责订阅管理、界面操作和代理开关,内核负责处理连接,两者不是同一个概念。选择前还要看订阅说明中的协议与传输方式,不能只凭名称相似就认定兼容。换客户端前先保留原订阅和路由设置,在新客户端完成导入、选择活动配置并验证访问后,再清理旧配置,避免同时运行多个代理程序造成端口冲突。
安装客户端后,还需要准备什么才能连接?
客户端本身不附带可用的远端连接配置。需要准备有权使用的订阅地址、单条分享链接,或服务端提供的完整参数。订阅地址用于定期获取配置列表,分享链接通常只描述一条配置;普通网页地址不能直接当作订阅导入。首次使用先确认系统时间准确,再导入配置、选中一条活动配置,最后开启系统代理或应用要求的连接模式。订阅地址可能包含访问凭据,不要贴到公开评论、截图或在线解析页面。只有客户端安装成功,并不代表远端服务已经可用。
系统代理、路由预设和 TUN 分别控制什么?
系统代理告诉遵循系统设置的应用,把请求交给本地代理入口;路由预设决定已进入内核的请求走代理还是直连;TUN 则通过虚拟网络接口接收流量,适合需要接管更多应用连接的场景。三者处在不同环节,切换路由不能让忽略系统代理的应用自动接入。新手可以先关闭 TUN,用系统代理确认浏览器能够访问,再按应用需要启用 TUN。Android 客户端通常通过系统 VPN 授权建立接管通道,具体开关和桌面客户端不完全相同,不必逐项照搬桌面菜单。
配置写着 VLESS、REALITY,为什么换内核后不能用?
协议、传输方式与安全层需要客户端和内核同时支持。REALITY 是安全层机制,不是导入任意地址就能启用的独立节点类型;服务端要求的公钥、服务名称等参数也必须匹配。遇到配置在一个客户端可用、换内核后报错时,先检查订阅说明和当前内核类型,再查看日志是否提示不支持的字段或传输方式。V2Fly 与 Xray 的功能集合并不完全相同,升级界面程序也不一定等于内核已经更新。不要为了消除报错随意删除参数,应使用与服务端要求相符的客户端和内核组合。
安装包与订阅入口
安装配置
确认安装包架构,再区分订阅地址与分享链接;授权问题单独处理。
Android 安装包的 arm64 与 universal 怎么选?
2015 年后发布的主流 Android 手机通常优先考虑 arm64 包,但最终要以设备处理器和系统支持的应用架构为准。部分设备虽使用 64 位处理器,系统仍可能限制应用架构,不能只看处理器名称。无法确定时可选择 universal 通用包,它通常包含多种架构,体积也更大。安装时若提示与设备不兼容,先确认下载平台和架构;若提示签名冲突,则是另一类问题。不要直接卸载旧应用,先备份订阅、分组和自定义规则,再核对是否选错客户端或安装来源。
v2rayN 订阅地址应该粘贴到哪个位置?
在 v2rayN 中打开“订阅分组”或“订阅分组设置”,新增分组,为它填写便于识别的名称,再把完整订阅地址粘贴到地址栏并保存。随后回到主界面的订阅菜单,更新该分组;仅保存地址不会自动生成配置列表。若拿到的是单条分享链接,应使用“从剪贴板导入分享链接”,不要把两种入口混用。菜单名称会随版本略有变化,判断依据是窗口里是否有订阅地址和分组字段。更新后检查当前分组筛选,再选中一条配置作为活动配置,最后设置系统代理。
分享链接导入失败或导入后没有条目,先检查哪里?
先确认剪贴板里是完整分享链接,而不是订阅管理网页、二维码图片或被聊天软件截断的文字。复制时不要带上前后的引号、说明文字和空格;多条链接按客户端支持的格式分行导入。若提示不支持协议或字段,记录原始错误,检查客户端版本与内核支持范围,不要反复更改加密或安全层参数碰运气。没有报错却看不到条目时,清空搜索关键词并切回全部分组。有些导入操作会把配置放到当前分组,列表为空可能只是筛选结果,并不代表配置真的丢失。
开启 TUN 提示权限不足,应该怎样处理?
先关闭 TUN,确认普通系统代理可以正常访问,再处理权限问题。Windows 按客户端提示使用管理员权限或安装所需服务;macOS 在系统设置中核对相关网络扩展、VPN 或辅助服务授权;Linux 按安装方式检查客户端所需的网络权限和辅助服务。不同版本实现不同,不要照搬其他平台的授权步骤。Android 需要接受系统 VPN 连接请求,并检查是否已有其他 VPN 应用占用通道。授权后若仍失败,查看日志中的接口创建或路由错误,不要通过关闭系统安全功能来代替定位问题。
代理状态与日常维护
使用技巧
把接管流量、路由分流和配置维护分开操作,升级与更新也更容易回溯。
v2rayN 的系统代理三种状态应该怎么用?
“自动配置系统代理”会把系统代理指向客户端的本地入口,适合日常浏览器接入;“清除系统代理”会移除系统代理设置,但不一定停止内核运行;“不改变系统代理”保留当前系统设置,适合已有手动代理安排的情况。切换后还要确认本地入口和活动配置正常。系统代理并不等于全局路由,哪些目标直连仍由路由规则决定。排查时避免让另一款代理软件同时改写系统设置。准备退出客户端时,可先清除系统代理,再退出,减少系统仍指向已关闭本地端口的情况。
多个订阅怎样分组,更新后怎样避免选错配置?
为每个订阅建立独立分组,名称用来源或用途区分,不要把访问凭据写进名称。更新前先选中需要维护的分组,确认操作是更新当前分组还是更新全部订阅;更新完成后先清空搜索条件,再检查配置列表。关键词过滤只是缩小显示范围,不应被当成删除或停用配置的操作。订阅更新可能改变条目顺序或移除旧条目,因此更新后要重新确认活动配置仍然存在。自动更新间隔可按订阅提供方的建议设置,不必频繁刷新;也应单独备份手动配置和自定义路由,避免与订阅条目混淆。
“绕过大陆”和“全局代理”应该怎样选择?
“绕过大陆”通常让匹配中国大陆域名或地址规则的请求直连,其他流量按预设处理;“全局代理”通常让进入内核的大部分请求走代理,但具体仍以客户端展示的规则为准。它们都不能保证接管没有进入客户端的应用流量。日常使用先选符合访问需求的预设,排查单个网站时可以暂时换预设对照,但一次只改一个设置。若全局可用而分流不可用,重点检查规则顺序、规则资源和 DNS 解析。不要一开始就删除所有直连规则,局域网设备和本地服务可能依赖这些规则。
升级客户端前要保留哪些设置?
先在客户端的备份、导出或设置入口保存现有配置,重点保留订阅分组、自建配置、路由规则、DNS 设置和本地监听端口。备份文件可能包含订阅凭据,应放在可信的本地位置。升级前记录正在使用的客户端与内核类型,并正常退出程序;升级后先核对活动配置和代理状态,再测试一个已知可用的网站。图形客户端可能重新生成 config.json,直接修改生成文件的内容不一定能保留,优先在界面支持的自定义设置中调整。不要同时升级、换内核和改路由,否则出现问题时难以确定原因。
从现象定位环节
故障排查
记录错误原文,区分订阅获取、本地接管和远端连接,不把所有失败都归为节点问题。
订阅更新失败、返回空列表或解析报错,如何区分?
先看更新提示:连接超时通常指向网络可达性;认证失败或权限错误要核对订阅状态与地址;解析错误则要检查返回内容是否真是客户端支持的订阅格式。重新从提供方页面复制完整订阅地址,确认没有多余空格,也没有把管理页面当成订阅地址。若客户端提供直连更新与通过代理更新,可在已有可用配置时分别尝试;没有可用配置时,依赖代理更新可能形成循环。更新成功但列表为空,再检查分组筛选、关键词过滤和订阅是否已到期。不要把含凭据的地址提交给公共解析工具。
节点测试超时,是否一定是服务器失效?
不一定。不同测试入口可能测的是端口连通性或实际请求耗时,测试失败不能单独证明服务器已经失效。先确认系统时间和当前网络正常,再选中该配置尝试真实访问,同时查看日志是否有域名解析失败、连接超时或握手错误。用同一网络下另一条已知可用配置作对照,能够帮助区分本机问题与单条配置问题。不要短时间反复批量测试,以免增加请求负担。只有一条配置失败时核对服务端参数;所有配置同时失败时,优先检查本地内核是否启动、网络是否切换以及是否存在其他代理冲突。
显示已连接,但浏览器或其他应用无法上网怎么办?
“已连接”往往只说明本地服务或 VPN 通道已启动,不代表远端请求一定成功。先确认活动配置,再用浏览器访问一个已知可用的网站,并观察日志是否出现对应请求。没有请求记录时,重点检查系统代理是否开启、浏览器是否设置了独立代理,以及应用是否遵循系统设置;有请求但失败时,再查 DNS、路由与远端握手错误。若只有某个应用异常,先处理该应用的代理设置,不要立即重装客户端。最后可关闭其他代理程序作对照,避免多个程序争用本地端口或重复接管网络。
退出客户端后仍打不开网页,怎样恢复普通连接?
先检查系统代理是否仍指向本地地址和客户端端口。重新打开 v2rayN,选择“清除系统代理”,正常退出后再测试;也可在操作系统的网络代理设置中核对手动代理和自动配置脚本。若曾启用 TUN 或 VPN,先在客户端关闭对应开关,再检查系统是否仍有活动连接。Android 可在系统 VPN 页面确认连接已经断开。企业或校园设备可能由组织管理代理,不要删除不属于客户端的设置。基础网页访问恢复后,再逐步重新启用客户端,避免一边残留旧设置、一边建立新的代理通道。