订阅 · 代理 · 连接排查

V2Ray 常见问题

先确认症状,再调整设置。按分类查找订阅导入、客户端选择与连接故障的处理步骤。

首次配置可先看快速上手;需要连续排查流程时,转到问题诊断。

基础认知

分清客户端、内核与配置来源,再决定需要调整哪一层。

V2Ray、Xray 与 v2rayN 有什么区别?

先区分内核与图形客户端。V2Ray 属于 Project V 生态,V2Fly 延续相关内核的开发;Xray 是相关的另一条内核发展路线。v2rayN 提供桌面图形界面,负责管理订阅、生成配置与启动所选内核。界面能导入某种分享链接,不代表当前内核支持其中所有参数。遇到协议或传输报错时,应同时检查客户端与实际启用的内核,而不是只看软件名称。

v2rayN、v2rayNG、v2flyNG 应该怎么选?

Windows、macOS 与 Linux 桌面优先选择 v2rayN,再按系统架构选择安装包。Android 优先选择使用 Xray 内核的 v2rayNG;需要 V2Fly 内核兼容性时,可考虑 v2flyNG。两款安卓客户端的设置入口和支持能力不完全相同,迁移前先确认节点要求的协议、传输与安全参数。不要仅凭图标或名字相似选择客户端,也不要默认不同客户端导出的完整配置可以直接互用。

安装客户端后,是否还需要订阅或节点配置?

需要。客户端只负责读取配置与转发请求,不会因安装完成就自动获得可用的远端服务。可以导入有权使用的订阅链接、节点分享链接,或按服务端资料填写配置。订阅通常用于批量获取并更新节点,单条分享链接通常对应一份节点配置。导入后还要选择活动节点并启动连接。订阅地址可能包含访问凭据,应保存在可信位置,不要贴进公开截图、论坛或在线解析工具。

系统代理、路由分流和 TUN 分别控制什么?

系统代理告诉遵循系统代理设置的应用,把请求交给本地代理端口;路由分流决定进入内核的请求走代理、直连还是被阻止。TUN 则通过虚拟网络接口接入更多流量,但仍受路由、DNS 和应用行为影响。三者不是同一个开关,也不保证启用后所有程序都使用代理。初次配置先保持 TUN 关闭,确认节点和普通系统代理可用,再逐项增加接管范围,便于发现冲突。

安装配置

先选对应架构,再导入配置。权限问题与节点问题分开检查。

v2rayN 订阅导入失败或列表为空,先检查哪里?

先区分订阅地址与单条分享链接,分别使用订阅分组或剪贴板导入入口。复制时去掉首尾空格和换行,检查链接是否被聊天软件截断。订阅保存后还需要执行更新,才会生成节点列表。若更新成功却没有节点,确认返回内容不是登录页面、错误提示或客户端不支持的订阅格式,并检查列表是否被分组筛选隐藏。不要反复删除全部配置;先保留原分组,再用新分组测试同一地址。

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

先查看设备处理器与系统支持的应用架构。多数较新的安卓设备可使用 arm64 包,体积通常更小;架构不明确时,可选择包含多种架构的 universal 包。处理器支持 64 位,不代表设备当前系统一定支持 64 位应用,因此不能只按购买年份判断。出现安装解析错误时,还要检查系统版本要求、剩余空间,以及已有应用的签名是否一致。卸载旧应用前先导出需要保留的配置。

v2rayN 的桌面版与经典 WPF 版如何选择?

Windows 用户可以在跨平台桌面版与经典 WPF 版之间选择;WPF 版使用 Windows 桌面界面,桌面版采用跨平台界面。首次使用可先选桌面版,习惯经典布局时再考虑 WPF 版,并分别核对安装包要求的运行环境。不要把两版直接解压到同一目录覆盖运行。迁移时先导出订阅和必要设置,在独立目录完成导入与连接测试,确认路由、端口和内核选择后,再处理原目录。

开启 TUN 提示权限不足,应该怎么处理?

先关闭 TUN,确认普通系统代理模式能够连接,避免把节点故障误认为权限问题。Windows 按客户端提示以管理员权限启动,检查安全软件是否阻止虚拟网卡或相关组件;macOS 与 Linux 按系统提示授予相应权限。Android 使用 VPN 模式时,需要确认系统连接授权,并检查是否已有其他 VPN 应用占用连接。不要为排查直接关闭全部安全防护,应根据明确报错处理权限或组件问题。

使用技巧

更新订阅、切换路由或调整端口后,检查依赖这些设置的应用。

订阅更新失败时,什么时候使用通过代理更新?

先确认订阅地址仍有效,并记录失败提示是连接超时、访问被拒绝还是内容解析失败。若当前网络无法直接访问订阅服务,而已有节点可以正常连接,可尝试客户端提供的通过代理更新方式;这需要本地代理已经工作。节点全部不可用时,切换更新方式不一定能解决问题。地址失效、授权到期或服务端返回错误页面,也不会因使用代理自动恢复,应联系订阅提供方核实状态与格式。

绕过大陆、全局与直连模式应该如何切换?

先按访问目标选择路由模式。绕过大陆通常让规则匹配到的中国大陆地址或域名直连,其余请求按配置处理;全局通常让进入内核的请求走代理;直连通常让这些请求不经过远端节点。具体结果仍取决于客户端实际生成的规则。排查时可以短暂切到全局,判断问题是否来自分流,但这不会让忽略系统代理的程序自动进入内核。验证结束后恢复原模式,避免改变不相关应用的访问路径。

修改本地监听端口后,哪些设置需要同步调整?

先在参数设置中确认当前监听地址、端口及支持的代理类型,不要假定不同版本的默认端口相同。修改并重启内核后,同步更新浏览器手动代理、下载工具和其他应用中的端口;使用客户端自动配置系统代理时,也要重新应用系统代理设置。HTTP 与 SOCKS 入口不能仅凭数字接近就互换使用。监听地址优先保留本机回环地址,除非明确需要局域网接入,否则不要扩大监听范围。

Android 分应用代理设置后,为什么部分应用没有变化?

先确认当前使用 VPN 模式,因为仅代理模式通常需要应用自行设置代理。再检查分应用列表采用的是仅代理所选应用,还是绕过所选应用,两种含义相反。修改名单后停止并重新启动连接,必要时关闭目标应用后再打开。系统的始终开启 VPN、阻止未使用 VPN 的连接等选项也可能影响结果。验证时一次只调整一个应用,避免同时切换路由与 DNS,导致无法判断是哪项设置生效。

故障排查

从本机网络到客户端模式,再到节点参数与服务端,逐层缩小范围。

节点全部超时或单个节点超时,排查顺序有什么不同?

全部超时时,先清除系统代理并关闭 TUN,确认本机基础网络可用,再检查客户端内核是否成功启动、本地端口是否冲突,以及订阅是否已经失效。只有单个节点超时时,重点核对该节点的地址、端口、协议和传输参数,并与同一订阅中的其他节点对照。一次测速超时不能独立证明服务端不可用,测试目标本身也可能无法访问。保留经过脱敏的错误日志,再根据连接阶段继续缩小范围。

客户端显示已连接,但网页仍然打不开怎么办?

已连接通常只说明客户端或本地服务进入运行状态,不等于目标网站已连通。先确认活动节点确实被选中,再检查系统代理或 VPN 接管是否生效。用不同网站和不同应用交叉测试:仅某个应用失败时检查其独立代理设置;只有域名访问异常时重点检查 DNS;所有请求失败时查看内核日志中的连接错误。还应暂时排除其他代理、VPN 或浏览器扩展冲突,每完成一步就复测,不要同时重置全部设置。

系统代理已开启,但浏览器或其他程序仍然直连怎么办?

先确认选择的是自动配置系统代理,而不是不改变系统代理,并在操作系统网络设置中核对本地代理地址和端口。部分浏览器使用独立代理设置,部分程序根本不读取系统代理,需要单独配置或在确认节点可用后尝试 TUN。若系统代理设置会自动恢复,检查其他代理软件、浏览器扩展或组织策略是否正在覆盖。退出客户端前先清除系统代理;否则本地监听停止后,系统仍指向旧端口可能造成断网。

TLS 握手失败、证书错误或 DNS 异常怎么区分?

先看日志发生在哪个阶段。域名解析失败时,检查系统与客户端的 DNS 设置,并确认服务端域名本身有效;出现证书无效、x509 或握手错误时,先同步系统日期、时间与时区,再核对服务端要求的 SNI、传输主机名和证书域名。不要用允许不安全连接作为常规修复,因为这会跳过重要验证。若同一配置只在某个网络失败,可换可信网络复测,并把解析问题与证书配置问题分开处理。

下载v2rayN