安装与连接排查
v2rayN 常见问题
先分清问题发生在哪一步:安装包打不开、订阅没有导入,还是应用请求没有进入代理。按当前现象选一类,排查时一次只改一项。
基础认知
先区分客户端、内核和配置。知道每一层负责什么,就能判断该去哪里找设置。
v2rayN、V2Ray 和 Xray 有什么区别?
v2rayN 是桌面图形客户端,负责管理配置、启动内核和设置本地代理。V2Ray 是 Project V 生态中的代理软件,V2Fly 社区继续维护相关实现;Xray 则是独立发展的内核项目。切换图形界面和切换内核是两件事。导入配置前,先确认当前内核支持配置中的协议、传输与安全选项。
订阅地址和单条节点链接有什么区别?
订阅地址指向可定期拉取的配置内容,一次更新可以刷新整组条目。单条节点链接则描述一个连接,通常导入后不会跟随订阅更新。先确认来源交付的是哪一种,再选择订阅分组或单条导入入口。两者都可能含有访问凭据,不要贴到公开截图、工单标题或在线转换页面。
系统代理和 TUN 模式有什么区别?
系统代理为遵循系统设置的应用提供本地代理入口,但有独立网络设置的应用可能不使用它。TUN 通过虚拟接口接收由路由导入的流量,覆盖范围取决于系统路由、排除规则和权限。调试时先选一种方式,确认单个应用能访问,再决定是否需要扩大覆盖范围。
安装客户端后为什么没有可用节点?
客户端负责运行连接配置,不等于提供远端连接。首次打开时,列表为空属于正常情况。取得有权使用的订阅或单条配置后,导入并选中条目,再观察内核是否启动。如果导入后仍看不到条目,先检查当前分组和搜索过滤条件,不必连续导入同一份内容。
安装配置
先按系统和架构选包。客户端能打开后,再分别验证订阅能否读取、虚拟接口能否建立。
Windows 上 v2rayN 桌面版和 WPF 版怎么选?
桌面版采用跨平台界面,WPF 版保留经典 Windows 界面。先核对系统架构和发布说明中的运行要求,再按熟悉的界面选择。已有配置时,切换前备份客户端数据;测试另一版前先退出原客户端,避免两个进程同时修改系统代理或争用同一个本地监听端口。
安卓安装包的 arm64 和 universal 怎么选?
如果设备系统支持 arm64-v8a,优先选 arm64 包;不确定系统支持哪种应用架构时,可先查看设备规格,或选择覆盖多种架构的 universal 包。处理器支持 64 位不代表系统一定能运行 64 位应用。若通用包也装不上,继续核对安卓版本要求以及是否与已安装应用的签名冲突。
订阅导入失败或导入后没有条目怎么办?
先确认复制的是完整订阅地址,没有换行或额外空格,也不是账户登录页。保存到订阅分组后,手动更新该分组并查看日志。收到登录页面或错误提示页时,即使请求成功也无法解析为节点;日志若显示格式不受支持,向配置提供方确认能否提供当前客户端兼容的订阅格式。
打开 TUN 时提示权限不足怎么办?
先看日志报错发生在创建虚拟接口还是写入路由。Windows 上可以退出客户端后按发布说明使用管理员权限启动;macOS 和 Linux 则按对应版本文档确认虚拟接口、辅助进程和授权要求。如果设备受单位管理,先确认相关权限是否允许,不要为启动失败而关闭系统防护。
使用技巧
测试结果要和实际请求对照。端口可达、请求进入内核和规则选中预期出站,是三个不同的检查点。
如何确认一个应用真的使用了代理?
只用一个测试应用发起新请求,查看客户端日志中是否出现对应的目标及出站记录。若没有记录,检查该应用是否使用独立代理设置,或者是否仍在复用先前建立的连接。日志有记录只代表请求进入了内核,还要看实际匹配的出站是代理还是直连。
为什么端口测试成功,真连接测试却失败?
Tcping 成功通常只说明当时可以连接到目标 TCP 端口,并不验证协议握手、身份认证或测试网址能否访问。真连接失败时,可先用同一测试网址比较一个已知可用条目,再看日志是握手报错还是访问测试目标超时。不要只按端口测试结果判断节点可用性。
新增路由规则后,为什么仍命中旧规则?
先确认修改的是当前启用的路由配置,并在保存后重新加载,再发起一条新连接。规则通常按顺序匹配,前面的宽泛规则可能先命中,导致后面的例外没有机会生效。检查目标是以域名还是 IP 进入内核,并结合域名解析策略判断该用哪一类匹配条件。
更新客户端前需要备份哪些内容?
先记下当前版本和使用的内核,退出客户端后按对应版本说明备份其数据目录。重点保留自定义路由、订阅分组和手动配置,不要假定安装目录就是数据目录。备份可能包含凭据,应存放在受控位置。升级后先验证一个已知可用条目,再逐项恢复自定义设置。
故障排查
先确认影响范围:是只有一个应用打不开、只有一条配置超时,还是订阅请求本身失败。记录首次出现的错误,再决定查哪一层。
节点突然超时,应先检查什么?
先确认当前网络能正常访问常用站点,再用同一种测试对照另一个已知可用条目。若只有一个条目失败,查看日志中是域名解析失败、连接超时还是握手失败,并核对服务器地址、端口与当前配置。若所有条目都失败,优先查看内核是否启动以及本地端口是否成功监听。
客户端显示已连接,为什么还是无法上网?
已启动或已选中条目不代表应用请求已走通。先关闭重复启用的代理接入方式,只保留一种,再用浏览器发起新请求并对照日志。没有请求记录就查应用接入与本地端口;有记录则查路由匹配、DNS 和出站错误。如果停用客户端后仍无法访问,检查系统是否还指向已停止监听的代理端口。
系统代理已开启,为什么某个应用不生效?
先用遵循系统代理的浏览器做对照。如果浏览器正常而目标应用没有请求记录,检查该应用是否有独立代理、绕过列表或由其他工具接管了网络设置。手动填写代理时,要让协议和端口同时匹配客户端的实际入站设置。应用若缓存了代理设置,修改后退出重开再试。
订阅之前能用,更新时失败怎么办?
先保留现有分组,手动更新一次并查看错误。401 或 403 优先检查订阅授权或地址是否已更换;连接超时则检查客户端发起订阅请求时采用的网络路径。如果更新设置依赖代理,而当前条目又不可用,先恢复一条可用的连接,或在订阅源允许且可直达时用直连方式更新。