v2rayN 使用教程 · 问题索引

v2rayN 常见问题

按出现问题的环节找答案。先记下报错和当前设置,每次只改一项,再用同一个应用复测。

基础认知

区分配置来源、内核和代理入口,再决定从哪项设置查起。

查阅术语表 →
订阅地址和单节点分享链接有什么区别?

订阅地址通常以 HTTPS 开头,客户端更新订阅时会从该地址获取一组配置;vmess:// 或 vless:// 开头的分享链接通常只描述一个节点。拿到订阅地址就打开「订阅分组设置」,填入「地址(url)」后再更新订阅;拿到单节点链接就从剪贴板导入。普通网页也可能以 HTTPS 开头,不能只凭前缀判断;先确认复制的是订阅入口,而不是服务面板的页面地址。

客户端、内核和节点分别是什么?

v2rayN 是图形客户端,用来导入配置、选择节点和调整设置;Xray、V2Fly 这类内核负责读取兼容的配置并处理连接;节点则是客户端尝试连接的远端入口及其参数。排查时先分层:窗口打不开,先看安装与启动记录;窗口打开但日志报告内核启动失败,先看内核配置;内核正常运行但只有一个节点失败,先对照那个节点的参数和测试结果。

系统代理、路由规则和 TUN 有什么区别?

「自动配置系统代理」让遵循系统代理设置的应用有一个可用的代理入口;应用自己的代理设置可能优先,也可能完全不读系统设置。路由规则决定进入内核的流量走代理、直连还是阻断。TUN 通过虚拟网络接口接管路由覆盖的流量,但不保证每条连接都走代理。只测浏览器时先用系统代理;需要判断某个应用是否绕过系统代理时,再单独测试 TUN。

桌面和 Android 应该选哪款客户端?

Windows、macOS 和 Linux 用 v2rayN;Android 优先选使用 Xray 内核的 v2rayNG,需要使用 V2Fly 内核时再考虑 v2flyNG。先按设备选客户端,再核对配置依赖的协议和传输方式。不能只因为名称相近就假定配置互通;如果打算换客户端,先保留现有配置,只导入一条已知可用的配置试连,确认启动、访问和断开都正常后,再迁移整组订阅。

安装配置

从安装包、首次启动和订阅导入查起。只在报错指向权限时再处理授权。

查看客户端与安装要求 →
Android 安装包选 arm64 还是 universal?

设备明确支持运行 arm64-v8a 应用时,优先选 arm64;不确定系统支持哪些 ABI 时,选包含多种架构的 universal,安装包通常会大一些。注意处理器是六十四位,不代表设备上的系统也能安装六十四位应用。如果安装时报错,先记下提示:若提示架构不匹配,换通用包重试;若提示签名冲突或系统版本不满足要求,换架构通常不能解决。

添加订阅时提示导入失败,先查哪里?

先看用的是哪个入口。订阅地址不走单节点的剪贴板导入,打开「订阅分组设置」,填好「备注」和「地址(url)」,保存后执行订阅更新。若保存时就报错,检查地址是否夹带引号、换行或说明文字,确认问号后的查询参数也复制完整。若更新成功但列表仍为空,切回对应订阅分组,检查「过滤」是否排除了全部条目,再确认订阅内容是否包含客户端可识别的配置。

开启 TUN 提示权限不足怎么办?

先看失败的是创建虚拟网卡、修改路由,还是内核启动。Windows 上若日志明确提示权限不足,可关闭客户端,再对已有的 v2rayN 程序选择「以管理员身份运行」作一次对照。macOS 和 Linux 的授权方式取决于安装包及版本,按客户端提示处理,不要整体放宽系统权限。Android 使用的是系统 VPN 授权;若已有 VPN 在运行,先断开它,再回到客户端发起连接并确认授权。

Windows 解压后点开 v2rayN 没反应怎么办?

不要在压缩包预览窗口里双击程序。先把整包解压到当前账户可写的目录,再从解压后的目录启动;若已启动过,先看通知区域是否已有图标。弹窗如果指向缺少运行库,就记录提示中的运行库名称、版本和架构,按所选发行包的要求安装。若没有弹窗,可查看 Windows「事件查看器」里的「应用程序」日志,以启动时间为线索找对应错误,不要先覆盖旧配置。

使用技巧

切换节点后用新连接验证。比较两种设置前,先记下原值,方便恢复。

查看完整配置教程 →
怎么确认切换节点后用的是新节点?

在 v2rayN 节点列表中选中新项,再执行「设为活动服务器」;仅高亮一行不等于已经切换。确认当前活动项已经变更,再发起一条新连接。浏览器可能复用之前的连接,测试时可以退出并重新打开浏览器,用同一个已知可访问的页面对照。若主界面显示新节点但访问仍异常,查看切换后的日志,找活动配置启动时的第一条错误,不要只看最后一行。

怎么判断异常来自分流还是节点?

保持节点和代理入口不变,先记下当前路由预设。用同一个应用分别访问一个正常目标和一个异常目标,再临时切到「全局」测试异常目标。如果只在原预设下失败,优先检查规则命中情况、规则顺序及 DNS 解析;如果两套预设下表现相同,再查应用有没有进入代理以及节点能否连接。测试完切回原预设,不要一次同时改节点、路由和 DNS。

「不改变系统代理」会清除已有设置吗?

不会。这个选项是不主动修改当前系统代理,不表示直连,也不等同于「清除系统代理」。如果先前已经配置了指向本机的系统代理,切到「不改变系统代理」后,它可能继续保留。要取消由 v2rayN 写入的设置,使用「清除系统代理」,再到系统网络设置确认结果。受单位管理的设备如果原本就有代理配置,测试前先记下原设置,不要直接覆盖。

更新订阅前怎样保留手动修改的节点?

订阅分组的条目可能在更新时被重新生成,直接改其中某条配置不适合长期保留。先把要保留的条目作为独立配置导入到不绑定订阅地址的分组,再修改副本。随后只更新原订阅分组,确认副本还在,并检查原来的活动节点是否仍可用。若通过分享链接转移条目,其中可能包含连接凭据,不要把链接发到公开群聊,也不要在求助截图里展示完整订阅地址。

故障排查

先区分是单个节点、单个应用还是全部连接失败,再对照日志。

查看按症状排查的手册 →
节点测速一直超时,怎样缩小范围?

先只测一个节点,记下使用的是连接测试还是真连接测试;能连上端口,并不代表后续协议握手一定成功。再在同一网络、同一种测试方式下测另一个已知可用的节点。如果只坏一个,检查服务器地址、端口和传输参数,并查看是否有握手报错。如果全部超时,先确认内核已启动,再看日志里最早的解析、连接或认证错误;测速目标不可达也可能造成误判。

客户端显示已连接,为什么网页还是打不开?

已连接不等于目标网页已经连通。先用原浏览器打开一个平时能够直连的页面,再与打不开的页面对照。如果两类页面都失败,在允许直连的网络上暂时清除系统代理或关闭 TUN,只做一次对照;直连也失败就先查本地网络。若只在开启代理后失败,检查活动节点和日志:解析失败先查 DNS,连接拒绝先查本地代理端口,握手失败再核对远端配置。

选择「自动配置系统代理」后,应用为什么没走代理?

先到系统网络设置确认代理已经启用,地址和端口与 v2rayN 的本地监听配置一致。再用遵循系统代理的浏览器发起新请求,同时查看客户端是否出现对应连接记录。浏览器能走代理而目标应用不行,就检查该应用是否有内置代理设置,或是否明确不使用系统代理。浏览器也不行时,先查内核启动和端口占用;如果日志显示流量已进入内核但被直连,再去检查路由规则。

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

保留现有分组和节点,先看更新日志,不要删除后重建。若返回四零一或四零三,核对订阅是否仍有效、地址是否已更换;若返回成功却解析失败,检查响应是不是登录页或错误页。若提示超时,在允许的网络条件下对照两种更新路径:当前节点可用时试「通过代理」更新,节点本身不可用时试「不通过代理」更新。一次只更新有问题的分组,便于对照结果。