配置与排查 / FAQ

V2Ray 常见问题

从问题现象开始,依次检查订阅、流量接管和内核运行状态。每次只调整一项设置,再用相同条件验证。

以下以 v2rayN 桌面端与 v2rayNG 安卓端为主。不同界面版本的菜单位置可能略有差别,具体选项以已安装客户端为准。点击问题标题展开操作说明。

基础认知

先区分客户端、内核与服务器,再选择适合的连接方式。

V2Ray、Xray 和 v2rayN 分别是什么?

V2Ray 通常指 Project V 生态中的代理工具与相关技术,V2Fly 延续维护 V2Ray 内核,Xray 是另一条独立发展的内核分支。内核负责协议连接和流量处理;v2rayN 是图形客户端,负责管理服务器、订阅、路由和代理设置,并调用所选内核运行。实际能否使用某种配置,要同时看客户端能否识别字段、所选内核能否处理协议,以及服务端设置是否匹配。排查时先记录客户端名称、所用内核和协议类型,不要只用“V2Ray 连不上”概括全部情况,也不要把更换界面客户端当作必然有效的修复。

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

Windows、macOS 和 Linux 桌面优先选择 v2rayN,再按系统与处理器架构选择安装入口。Windows 下载页提供桌面版与经典 WPF 版:前者使用跨平台界面,后者保留经典 Windows 界面,具体菜单位置可能不同。Android 优先选择使用 Xray 内核的 v2rayNG;需要适配 V2Fly 内核配置时,可考虑 v2flyNG。两款安卓客户端的配置支持范围不能仅凭相似名称判断,应核对服务端要求。建议先用一款客户端完成导入与验证,再考虑迁移,避免同时启用多个代理服务造成端口或 VPN 接管冲突。

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

客户端只提供配置管理和连接功能,安装完成并不会自动获得可用服务器。订阅地址用于获取一组服务器配置,单条分享链接则描述某个服务器;二者都应来自有权使用的来源。导入前确认拿到的是订阅链接、单条配置链接,还是普通网页地址,登录页面不能直接当作订阅使用。订阅内容可能包含访问凭据,应按敏感信息保管,不要贴到公开讨论区。若供应方要求登录后重新生成链接,应先在其账户页面处理。本站提供下载入口与配置说明,服务器有效期、流量额度及账户权限需要向配置提供方确认。

系统代理、路由模式和 TUN 模式有什么区别?

系统代理告诉遵循系统设置的应用,把请求交给客户端的本地代理端口;应用可以忽略这项设置。路由模式决定已经进入内核的请求走直连、代理还是阻止,不负责让所有应用自动进入代理。TUN 模式通过虚拟网络接口接管流量,覆盖范围通常更广,但仍受路由排除项、应用行为及系统权限影响。普通浏览器使用可先启用系统代理,确认连接正常后再判断是否需要 TUN。排查时不要同时改动接管方式与路由规则,否则难以确认是哪项设置改变了结果。局域网访问异常时,也要检查直连与排除规则。

安装配置

确认安装包架构,完成订阅导入,再配置代理与必要权限。

订阅链接应该怎样导入,导入失败先检查哪里?

在 v2rayN 中打开“订阅分组”,进入“订阅分组设置”,新增分组并填写订阅地址,保存后执行“更新全部订阅(不通过代理)”。不同界面版本的标点和入口位置可能略有差别,关键是先保存分组,再发起更新。复制地址时检查开头和结尾是否带入空格、换行、中文标点或聊天软件附带的说明。若拿到的是单条服务器分享链接,应使用从剪贴板导入的服务器入口,而不是把它当作远程订阅地址。安卓端在订阅设置中新增地址,再回到列表更新订阅。出现解析错误时,先确认链接类型与客户端支持的订阅格式。

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

设备支持 arm64 时优先选 arm64 包,universal 包适合不确定架构或需要兼容多种架构的情况,通常体积更大。2015 年后主流手机多数使用支持 arm64 的处理器,但处理器能力与设备实际运行的系统架构不一定相同,不能仅凭购买年份判断。先查看“设置 → 关于手机”中的型号与系统信息,再根据设备说明确认;仍不确定时可尝试通用版。若安装器提示与设备不兼容,应核对架构和系统要求。若提示签名冲突,通常与已安装应用的签名来源有关,不是换成 universal 就能解决,处理前先备份现有配置。

v2rayN 系统代理应该选哪项,端口在哪里确认?

需要让遵循系统代理的应用使用客户端时,在 v2rayN 的“系统代理”中选择“自动配置系统代理”,并确认已有可用服务器被设为活动项。需要退出接管时选择“清除系统代理”,不要把“不改变系统代理”理解成已经关闭代理;它通常只是保留当前系统状态。本地监听端口可在“设置 → 参数设置”中查看,具体字段随客户端版本和内核配置而变化。为浏览器或其他应用手动填写代理时,应使用当前实际监听的地址、端口和协议类型,不能直接填写远端服务器地址。修改监听设置后重启服务,再核对运行日志是否成功绑定端口。

TUN 模式提示权限不足或启动失败怎么办?

先恢复到能正常使用的普通代理状态,再单独处理 TUN。Windows 上检查是否按客户端要求以管理员权限启动;Linux 上确认客户端所需的提权流程或权限配置已完成;macOS 上检查系统提出的网络配置授权是否已允许。不要在不了解作用时随意修改系统目录权限。Android 的 VPN 授权与桌面 TUN 实现不同,首次连接通常需要确认系统弹窗;已有其他 VPN 服务时,应先停止冲突服务。若仍失败,打开日志查看是权限拒绝、虚拟接口创建失败还是路由添加失败,再按对应原因处理,反复点击开关通常不能补齐缺失权限。

使用技巧

测试、分流与迁移分别验证,不把单个测试结果当作全部结论。

怎样做 V2Ray 延迟测试,结果应该怎么看?

在 v2rayN 的服务器列表中选择需要测试的条目,打开右键菜单,按当前版本提供的入口执行 TCP 测试或真连接测试。TCP 测试主要检查到服务器端口的连通性,不能证明协议认证、目标网站访问和完整代理链路都正常;真连接测试会经由代理请求测试地址,更接近日常使用,但也受测试地址本身影响。比较结果时应保持测试方式、网络和目标地址一致,不要把不同测试类型的数值直接排名。某次失败后先用同一配置访问实际需要的网站,再结合日志判断。延迟较低也不等于下载更快,吞吐与稳定性需要另行观察。

日常使用选“绕过大陆”还是“全局”?

需要让中国大陆常见站点直连、其他流量按代理规则处理时,可从“路由 → 绕过大陆”开始;需要临时确认某个问题是否由分流造成时,可切换到“全局”进行对照。这里的全局指路由策略,不代表所有应用已经被系统代理或 TUN 接管。预置规则的实际行为还取决于规则内容、域名信息和规则数据库是否可用,不能仅凭模式名称推断每条请求的出口。建议每次只切换一个设置,重新打开目标页面并查看日志。若只有少数站点需要特殊处理,再添加明确的域名规则,并检查它与已有规则的先后顺序。

订阅更新后,怎样保留自己的分组和手动服务器?

把手动添加的服务器放入独立分组,不要与自动更新的订阅条目混在同一个分组中管理。订阅更新可能重建对应分组里的服务器记录,手动改过的别名、地址或其他字段不一定被保留,具体行为还要看客户端设置。需要长期保存的修改,应先复制到独立的手动分组,并记录哪些字段与订阅原值不同。更新后检查活动服务器是否仍指向预期条目,再做一次实际访问验证。清理重复项前先导出必要配置;订阅中移除的服务器可能已经失效,保存副本只保留配置内容,并不会延长服务器的可用时间。

换设备时能否直接迁移配置?

可迁移订阅地址或客户端支持的配置导出文件,但不要直接认定整个程序目录可以跨系统使用。先在新设备安装对应客户端,导入订阅并更新,再根据新系统重新设置系统代理、监听端口、TUN 权限和路由。跨客户端迁移时,单条分享链接通常只覆盖服务器连接参数,不一定携带分组、路由规则、DNS 设置和界面偏好。重要规则应另外记录,并逐项核对是否被目标客户端支持。导出的配置可能包含服务器凭据,传输时使用受控渠道,完成后清理临时副本。多设备能否同时连接,还取决于服务器账户的并发限制。

故障排查

按更新请求、本地监听、服务器连接、目标访问的顺序缩小范围。

订阅更新失败,或者更新后列表仍为空,怎么排查?

先打开订阅分组设置,确认地址完整、分组已启用,再查看更新提示是网络错误、权限错误还是解析错误。当前代理本身不可用时,优先试“更新全部订阅(不通过代理)”;只有确认订阅地址需要经代理访问,且现有代理可用时,才选择通过代理更新。若提示访问被拒绝或链接失效,应检查账户状态及订阅地址是否已被重置,不要持续重复请求。若下载成功却没有条目,检查内容是否是登录页、错误提示或客户端不支持的格式。最后取消服务器列表的筛选条件,并切换到“全部”分组,排除只是条目被界面筛选隐藏的情况。

节点一直超时,应该先查服务器还是本地设置?

先查看日志中超时发生的位置,再分层判断。若连服务器地址和端口都无法建立连接,检查当前网络、服务器状态、端口和防火墙;若已经连接但在 TLS 或协议阶段失败,检查设备时间、服务器名称、传输方式和认证参数。不要关闭证书验证来掩盖名称或证书配置错误。用同一网络测试另一条已知可用配置,再用另一种网络测试原配置,可以缩小问题范围,但一次成功或失败还不足以确定长期状态。若多条配置同时失败,应优先检查本地网络和内核启动状态。记录报错原文比只保留“超时”两个字更有助于定位。

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

先确认“已连接”是否只是表示内核或 VPN 服务已经启动,它不保证服务器认证和目标访问成功。打开一个明确需要经过代理的页面,同时观察日志有没有对应请求;完全没有请求时,先查系统代理、应用自带代理设置或 TUN 接管范围。有请求却报解析错误时,检查 DNS 设置及相关服务器是否可达;只有部分站点失败时,检查路由规则、目标服务状态和协议配置。再分别验证一个预期直连页面与一个预期代理页面,避免只测单一站点。浏览器仍使用旧连接时可彻底退出后重开,测试期间不要同时切换服务器、DNS 与路由模式。

系统代理不生效,或者日志提示端口被占用,怎么处理?

先确认内核正在运行,并在日志中找到本地监听成功的记录。若提示地址已被使用,退出重复运行的客户端及占用同一端口的代理程序,再重启服务;确实需要并行运行时,为各程序设置不同监听端口,并同步修改手动配置过的应用。内核正常而浏览器没有请求记录时,检查系统代理是否被其他软件覆盖,以及浏览器是否使用独立代理配置。部分应用不会遵循系统代理,需要在应用内填写正确代理,或在确认权限后使用 TUN。结束排查前核对系统代理仍指向正在运行的监听端口,避免客户端退出后留下不可用的代理地址。