Windows
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留熟悉的经典布局,两者都可用于订阅与路由管理。
安装前先在系统设置中确认处理器类型。遇到运行库提示时,按对应安装说明处理,不必反复更换订阅;程序未能启动与订阅是否可用是两个问题。
前往下载 Windows 客户端→桌面端选择 v2rayN,安卓端优先了解 v2rayNG。进入下载页后,再按处理器架构和安装包类型选择。
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留熟悉的经典布局,两者都可用于订阅与路由管理。
安装前先在系统设置中确认处理器类型。遇到运行库提示时,按对应安装说明处理,不必反复更换订阅;程序未能启动与订阅是否可用是两个问题。
前往下载 Windows 客户端→选择 v2rayN,并根据“关于本机”显示的芯片信息区分 Apple Silicon 与 Intel 安装包。安装包架构与电脑芯片对应,比按设备外观判断更可靠。
首次打开如遇系统安全提示,应先确认软件来源与提示内容,再按系统提供的入口处理。配置完成后检查系统代理是否生效;需要管理员权限的功能另行授权。
前往下载 macOS 客户端→优先选择采用 Xray 内核的 v2rayNG;需要 V2Fly 内核时,可了解 v2flyNG。多数近年的主流手机使用 arm64,无法确认架构时查看通用版说明。
安卓通过 VPN 接口接管连接,首次启动需要确认系统授权。若切到后台后连接中断,再检查电池优化与后台运行限制,不要直接把所有问题归因于订阅格式。
前往下载 Android 客户端→v2rayN 提供 deb 与 rpm 安装包,并区分 x64、arm64 架构。先确认发行版的软件包体系,再选择匹配的架构,避免把安装格式与处理器类型混为一谈。
桌面环境对系统代理的读取方式可能不同。浏览器能连接而其他程序不能连接时,先确认程序是否遵循桌面代理设置;需要更广接管范围时,再阅读 TUN 配置章节。
前往下载 Linux 客户端→客户端负责读取配置和建立连接,安装程序本身不提供可连接的服务端参数。准备好可信来源的订阅地址或分享链接,再继续导入。换电脑或换手机时,也应重新核对协议支持与导入结果,而不是只看客户端名称相似就直接沿用所有设置。
查看全部客户端 →把配置拆成四个环节。先确认内容导入,再决定哪些程序进入代理,以及连接进入内核后如何分流。
订阅地址是获取一组配置的入口,不是浏览器里用来打开普通网页的链接。在 v2rayN 的订阅分组设置中填写备注和地址,保存后执行更新;安卓端则从订阅分组菜单添加。分组能把不同来源的配置分开,后续更新也更容易确认影响范围。与一次性粘贴单条分享链接相比,订阅保留了再次获取配置的入口。更新失败时先检查地址是否完整、是否失效,再区分获取失败与解析失败,避免重复创建同名分组。
路由分流决定进入内核的连接使用哪个出站。可以按域名、IP 或规则集合匹配,再交给 direct、proxy 或 block;这些名称需要与实际配置中的出站标签对应。规则通常自上而下判断,较具体的条件应放在宽泛条件之前。与直接把所有连接交给同一出站相比,分流能保留局域网访问并细化处理范围。调整时每次只改一类规则,结合日志确认命中结果;规则集合缺失、解析策略不同,都可能造成预期外的匹配。
系统代理告诉遵循该设置的应用,把连接交给本机代理入口。v2rayN 中的“自动配置系统代理”负责写入这层设置,并不表示所有程序都会接入,也不等同于路由里的全局代理。与手动在每个应用中填写地址相比,它更适合先验证浏览器连接。若浏览器可用而其他应用失败,应检查后者的代理行为,而不是立即重装客户端。退出前可清除系统代理,避免程序关闭后系统仍指向未监听的本地端口。
TUN 通过虚拟网络接口接管连接,适合处理不遵循系统代理的程序。它与路由分流处在不同层次:前者负责接入,后者决定出站。相比只设置系统代理,TUN 涉及更多系统权限、路由和 DNS 行为,也更需要留意其他 VPN 或虚拟网卡的影响。建议先在普通代理模式下验证同一配置能够连接,再启用 TUN;出现异常时关闭新增接管层进行对照,分别检查权限、网卡与解析记录,不要同时更换订阅和规则。
以上是设置项与规则语义示意,不是可直接导入的完整配置。详细操作顺序见上手教程 →
先分清客户端、内核与协议。三个名字对应不同层次,界面相似并不代表所有配置都能互换。
Project V 是理解 V2Ray 技术生态的起点。V2Ray 将入口、出站、传输、路由与解析等功能拆成可配置模块;图形客户端在这些能力之上,提供订阅管理、模式切换和日志查看等操作入口。因此,“装好了客户端”和“已经具备可用配置”是两件事。客户端可以启动,只说明程序能够运行,实际连接还需要完整的服务端参数、匹配的协议与正确的网络接入方式。
V2Fly 延续 V2Ray 相关项目的社区开发,Xray 则是从相关代码基础发展出的另一条内核路线。两者具有共同技术背景,也有各自的功能演进。阅读教程时应同时确认客户端名称和实际使用的内核;看到某个协议名称,并不能直接推断全部扩展参数都受支持。服务端给出的配置要求,应与客户端当前能够调用的内核能力逐项对应。
v2rayN 面向桌面使用场景,把订阅分组、系统代理和路由设置放在图形界面中管理。桌面端用户可以先围绕同一个客户端建立操作习惯,再根据系统选择对应安装包。其所处的 Xray、V2Fly 等内核生态,使“界面程序”和“实际连接内核”需要分别理解;具体可选内核与功能,以所用发行包和界面选项为准,不应把其他平台截图中的功能直接套过来。
v2rayNG 是安卓端常用的开源客户端,采用 Xray 内核。安卓系统通过 VPN 授权提供接管连接的入口,因此它的启动方式和桌面端的系统代理菜单不同。v2flyNG 则提供 V2Fly 内核路线的安卓选择。两者名称接近,但选型时应看现有配置需要哪条内核路线,而不是把其中一个视为另一个的通用修复工具。换客户端之前,先确认配置字段和协议特性是否兼容。
| 客户端 | 主要场景 | 先确认什么 |
|---|---|---|
| v2rayN | 桌面图形配置与订阅管理 | 安装包架构、运行环境、实际选用的内核 |
| v2rayNG | 安卓端 Xray 配置 | 协议支持、VPN 授权、后台运行限制 |
| v2flyNG | 安卓端 V2Fly 配置 | 内核兼容性、导入字段、系统权限 |
这三款客户端均属于开源软件,源码公开与许可条款让使用者能够了解软件的实现和使用条件。生态中不同项目可能采用不同许可证,修改、再分发与引用代码时,应分别阅读对应项目的许可要求。开源描述的是软件的开发与授权方式,不代表任意来源的订阅或服务端都值得信任,也不表示连接记录、服务质量或可用范围由客户端项目负责。
订阅地址常常包含识别使用者的参数,应当按敏感配置保存。向他人求助时,可以保留错误类型、客户端名称和相关设置项,但要遮盖完整地址、身份字段及认证内容。导入来源不明的配置前,还应留意它是否带有额外路由或 DNS 设置。理解这些边界,比仅凭界面上的“已启动”状态判断连接是否符合预期更有帮助。
软件更新改变客户端程序及其配套组件,订阅更新重新获取远端提供的连接配置,规则更新则可能改变域名和 IP 的匹配集合。三者并不是同一个操作。遇到旧地址失效时,更新软件未必能解决;遇到新协议参数无法解析时,反复刷新订阅也可能没有作用。先辨认变化发生在哪一层,再决定更新对象,能够减少重复操作与配置丢失的风险。
准备升级前,先记录当前正常工作的代理模式、路由方案与必要的自定义设置,并按客户端提供的方式保存配置。升级后用同一份已知可用的配置进行对照,确认程序启动、订阅读取与基本访问正常,再恢复额外功能。不要同时更换内核、导入陌生规则并开启 TUN;一次改变多个变量后,即使出现问题,也很难从日志中定位是哪一项造成的。
首次配置建议保持线性顺序:先安装能正常启动的客户端,再添加订阅分组并更新内容,接着选定要使用的配置,最后启用适合当前系统的接管方式。桌面端可以先从系统代理开始,安卓端则确认 VPN 授权。完成这些操作后,打开实际需要访问的应用,查看请求是否成功,并结合客户端日志确认有连接进入。状态栏显示运行中,不足以替代真实应用的访问验证。
如果访问失败,先判断是所有应用失败,还是只有一个应用失败;再判断是域名解析失败、连接超时,还是服务端拒绝。浏览器可用而其他程序不可用,优先检查接管范围;订阅列表为空,优先检查获取与解析;只有某类域名异常,再检查路由顺序和 DNS。按现象缩小范围,通常比直接重装更容易保留线索。需要逐阶段学习时,可继续阅读V2Ray 系统教程。
不一样。订阅地址应保存到订阅分组,再执行更新;单条分享链接通常通过剪贴板导入等入口添加。先识别手中的内容类型,再按上手教程操作,避免把订阅地址当作单个配置导入。
需要分别理解。系统代理决定支持它的应用如何接入本地代理,路由规则决定连接进入内核后使用哪个出站。启用前者不会代替后者,具体配置顺序可在教程中继续查看。
更新成功只表示获取并解析了配置,不代表服务端一定可连接。继续核对当前选中的配置、系统接管方式和日志错误;再检查服务端参数与网络条件。按连接验证步骤逐项区分问题所在层次。
桌面端建议先用普通代理方式验证基本连接,再根据应用需求决定是否启用 TUN。这样能把配置本身的问题与虚拟网卡、权限或系统路由的问题分开。具体操作从基础教程开始。
近期文章按具体问题展开:先找到操作入口,再看配置结构,遇到启动异常时按运行环境逐项排查。
分别标出 v2rayN 订阅分组设置与 v2rayNG 订阅分组菜单的位置,说明 Base64 订阅、明文链接列表的格式差异,以及更新订阅失败的常见原因。
阅读文章 →以一份精简示例配置为线索,逐段解释 log、inbounds、outbounds、routing、dns 各字段的作用,帮助理解客户端导出的完整配置与连接处理顺序。
阅读文章 →从运行库、内核被拦截、目录写入权限到安卓 VPN 授权与电池优化,按常见原因排列检查顺序。先确定程序在哪一步退出,再采取相应的处理办法。
阅读文章 →