帮助中心 / 设置与排查

v2rayN 常见问题

从订阅导入到连接故障,按出现问题的环节查找。先确认哪里失败,再改对应设置;一次只改一项,保留原值方便恢复。

基础认知

客户端、订阅与代理模式

先分清配置从哪里来、请求从哪里进入,以及内核如何处理连接。

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

V2Ray 通常指 Project V 代理生态中的相关技术与程序。内核负责处理协议、连接和路由,图形客户端则提供导入订阅、选择服务器和修改设置的界面。V2Fly 与 Xray 是相关的内核家族,支持范围和配置细节并不完全相同。遇到协议不支持时,需要确认客户端实际调用的内核及其版本,而不是仅看窗口上的客户端名称。

v2rayN、v2rayNG 与 v2flyNG 应该怎么选?

Windows、macOS 和 Linux 桌面环境优先查看 v2rayN。Android 优先考虑使用 Xray 内核的 v2rayNG;需要匹配 V2Fly 内核配置时,再考虑 v2flyNG。先按操作系统选择,再核对服务端要求的协议和传输方式,不要只根据名称相似就互换配置。客户端与内核的支持范围会随版本变化,旧版无法识别的字段不一定是订阅地址有误。

订阅地址与单个节点分享链接有什么区别?

订阅地址通常是一条用于获取配置集合的网址,更新订阅会重新拉取服务端提供的条目;单个节点分享链接通常只描述一份连接配置。两者对应的导入入口可能不同,不能把普通网页地址当作订阅地址使用。订阅网址里的令牌可能代表账户访问权限,应当像密码一样保存。需要向他人求助时,隐藏完整地址和凭据,只提供错误信息与必要的设置说明。

系统代理、TUN 和路由分流分别负责哪一段?

系统代理告诉愿意遵循系统设置的应用,把请求交给本地代理端口;TUN 通过虚拟网络接口接管符合条件的网络流量,通常需要额外权限。路由分流则在流量进入内核后,决定直连、代理或阻断。三者不是同一个开关。浏览器能用而其他程序不能用时,应先确认那个程序是否遵循系统代理,再决定是否需要 TUN,而不是直接把路由改成全局。

安装客户端后,为什么还需要订阅或服务器配置?

客户端提供本地配置管理和连接能力,不等于已经具备可用的远端服务。建立代理连接仍需要有效的服务器地址、端口和认证参数,通常由订阅或单个配置提供。安装成功只说明程序能够运行,不能据此判断远端连接可用。首次使用先取得有权使用的配置,再完成导入、选择活动服务器和设置流量入口;没有配置时,反复切换系统代理不会补齐这些参数。

查看术语解释 →
安装配置

安装包、订阅导入与权限

先让客户端和内核正常运行,再处理订阅与流量接管。界面入口名称可能随版本略有变化。

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

能够确认设备支持 arm64 时,优先选择对应安装包,体积通常更小。多数较新的手机符合这一条件,但芯片支持 64 位并不必然代表系统提供了对应运行环境,应以设备系统信息或安装结果为准。无法确定架构时,可尝试覆盖多种架构的 universal 包。若提示安装失败,还要检查系统版本、剩余空间以及同名应用签名是否一致,不能把所有安装错误都归因于架构。

订阅导入失败或导入后列表为空,先检查什么?

先确认复制的是完整订阅地址,没有换行、前后空格或聊天软件附加的标点,再使用订阅分组的地址输入入口。保存分组后执行更新,部分版本不会在保存时立即获取内容。如果返回的是登录页面、错误页面或空内容,列表也可能为空。接着核对订阅是否有效、输出格式是否适合当前客户端;若提示解析失败,记录错误类型并向配置提供方确认格式,不要随意删改地址参数。

v2rayN 系统代理不生效,应该按什么顺序检查?

先确认内核已正常启动,并且已经选中一个有效服务器,再将系统代理设为自动配置系统代理。随后查看操作系统的代理地址和端口,是否与客户端本地监听设置一致;这里没有适用于所有安装的固定端口。浏览器扩展、其他代理工具或单位设备策略可能覆盖设置,需要分别排除。若只有某个应用不生效,确认它是否读取系统代理;它也可能需要在自身设置里指定代理。

开启 TUN 提示权限不足或虚拟网卡创建失败怎么办?

先关闭 TUN,确认普通系统代理能否工作,再按客户端提示授予所需权限。Windows 可能需要管理员权限及相应网络组件,macOS 需要处理相关网络授权,Linux 需要满足虚拟网络接口与权限要求。不同版本的实现并不相同,应以当前错误信息为准。不要为此关闭全部安全防护;先检查是否被其他 VPN 或虚拟网卡占用,再查看内核启动日志中的第一条相关错误。

macOS 打开 v2rayN 被系统拦截,如何处理?

先确认安装包与芯片匹配,Apple Silicon 与 Intel 应选择对应版本。若系统提示无法验证开发者,在确认下载来源可信后,查看系统设置中的隐私与安全性,并按系统提供的选项允许打开。不同系统版本的入口文字可能不同。来源不明或提示文件损坏时,不要直接执行网上的批量解除限制命令。程序能打开之后,再单独检查系统代理与网络权限;放行应用不代表 TUN 权限已经齐全。

使用技巧

订阅更新、分流与连接验证

配置获取成功、流量进入客户端、远端请求完成,是三个需要分别确认的结果。

自动更新订阅已经开启,为什么配置仍然没变?

自动更新通常要求客户端正在运行,并且到达设置的更新间隔;电脑休眠或应用退出时,不能假定更新任务仍会执行。先手动更新一次,查看结果和分组是否正确,再检查启用更新与间隔设置。更新成功但条目不变,也可能是服务端没有发布变化。自动更新只负责重新获取配置,不会自动修复过期账户、失效地址或系统代理设置,因此仍需区分获取失败与连接失败。

绕过大陆与全局代理有什么区别,日常如何选择?

绕过大陆通常借助域名和地址规则,让匹配中国大陆范围的目标直连,其他目标再按剩余规则处理;具体行为取决于当前规则顺序和数据文件。全局代理通常将已进入客户端的流量交给代理出口,但不会让原本不遵循系统代理的程序自动接入。日常可以先用与需求相符的分流模式,遇到单个网站问题再临时切换作对照;测试结束恢复原设置,避免长期靠切换模式掩盖规则错误。

Android 浏览器能联网,但部分应用不能用,怎么定位?

先确认 v2rayNG 已建立系统 VPN 连接,再检查分应用代理名单,以及名单当前表示允许还是排除。被排除的应用不会按预期进入客户端。还要查看是否存在另一个 VPN、工作资料网络策略或厂商后台限制。若应用已被接管,继续检查它访问的域名是否被路由规则分到直连。每次只修改一个设置并重新打开目标应用,才能分清是接管范围、分流规则还是远端连接的问题。

更新订阅会不会覆盖手动修改的节点参数?

有可能。订阅分组里的条目通常由远端内容重新生成或同步,直接修改其中的地址、端口或传输参数,下次更新后可能被还原,具体取决于客户端版本与同步方式。需要长期保留实验配置时,先将其另存为独立的手动条目,并用明确别名与订阅条目区分。修改前记录原值,测试后只保留必要变化。不要依赖关闭全部订阅更新来保留一处改动,否则其他配置也可能长期停留在旧状态。

怎样确认实际请求走了代理,而不只是开关已打开?

先用同一个浏览器访问一个已知可用的 HTTPS 页面,再对照客户端连接日志,观察该域名匹配了哪条路由以及采用哪个出口。必要时使用可信的出口地址查询页面做辅助对照,但出口地址变化本身不能证明所有应用都已接管。缓存页面、浏览器独立代理和直连规则都会干扰判断。测试应同时确认目标应用进入客户端、路由选择正确和请求完成,而不是只看连接按钮或托盘图标。

查看全平台配置说明 →
故障排查

更新失败、超时与联网恢复

先保留报错,再做对照测试。能否导入订阅与能否连接服务器,可能是两条不同的网络路径。

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

先读更新提示:名称解析失败通常指向 DNS,连接超时通常指向到订阅服务器的网络路径,401 或 403 可能涉及权限、令牌或访问限制,解析失败则可能是响应格式不匹配。这些信息只是线索,不是最终结论。如果订阅只能经代理访问,需先有一个可用连接,再尝试客户端提供的经代理更新方式。不要循环依赖尚未获取的配置;地址已失效时,应向提供方取得有效地址。

节点测试显示超时,是否一定代表服务器失效?

不一定。测试方法、测试目标和真实应用请求可能不同,超时也可能发生在本地 DNS、网络出口或测试网站。先核对服务器地址与端口,再用相同配置访问一个已知可用页面,同时查看日志是否出现连接超时、认证失败或握手错误。只有某个条目异常时,可与同一订阅的其他条目对照;所有条目都异常时,优先检查本地网络、系统时间和内核启动情况,不要仅凭测试结果删除全部配置。

客户端显示已连接,但网页全部打不开,先做哪几步?

已连接可能只表示本地服务或 VPN 接口已经启动,并不代表远端请求成功。先暂时关闭代理,确认原始网络可用;再恢复代理,检查活动服务器、流量入口和日志。如果原始网络正常而代理请求全部失败,按本地监听、远端连接、认证与 DNS 的顺序排查。若日志没有目标网站的请求,先查应用是否被接管;若已有请求并明确报错,再处理对应环节,避免同时修改端口、DNS 和路由。

日志出现 TLS 握手失败或证书时间错误,应该怎么处理?

先检查设备日期、时间和时区,启用可靠的自动时间同步,再核对服务端要求的域名、SNI 与传输参数。证书过期、域名不匹配、中间网络干扰或客户端不支持相关配置,都可能导致握手失败。不要把跳过证书验证作为日常解决办法,这会削弱身份验证。若参数来自订阅,先重新获取有效配置;错误仍存在时,向服务端维护方提供隐藏敏感信息后的报错与发生时间。

关闭客户端后仍然无法上网,怎样恢复网络设置?

先检查系统是否仍指向已经停止的本地代理端口。能够重新打开客户端时,可先执行清除系统代理,再正常退出;不能打开时,在操作系统网络设置中关闭遗留的手动代理。若此前启用了 TUN,还要确认相关连接已经停止,并检查是否有其他 VPN 接管网络。不要立即重置整台设备的所有网络配置,先记录现状并逐项恢复。退出前先停止接管,有助于减少下次出现相同问题。

按错误类型阅读日志 →