Windows
v2rayN · 桌面版 / WPF 版
在系统的「关于」页面核对系统类型。下载页的两个入口都面向 x64:桌面版采用跨平台界面,经典 WPF 版使用原有的界面布局。首次安装选其中一个即可,不必为了对照教程同时装两套。
遇到压缩分发包,先完整解压到可写目录,再运行程序,不要只从压缩窗口里打开主程序。若系统提示缺少运行环境,按所选发行包的说明处理。旧客户端尚在运行时先退出,避免两套程序争用同一个本地端口。
前往下载功能速查
导入节点时,先看协议,再看传输与握手设置。桌面 v2rayN 和安卓 v2rayNG 都能通过相应内核处理常见的 VMess、VLESS 和 Trojan 配置,但协议同名不代表传输参数可以互换。复制已有节点时,应保留来源提供的传输方式和安全选项。若桌面能连接而安卓不能,先比较两端解析出的字段,再查内核是否支持该组合,不要同时调整多个选项。
| 项目 | v2rayN 桌面 | v2rayNG 安卓 |
|---|---|---|
| VMess | 支持 | 支持 |
| VLESS | 支持 | 支持 |
| Trojan | 支持 | 支持 |
订阅地址是刷新节点列表的入口,不是单个节点地址。在 v2rayN 的订阅分组设置或 v2rayNG 的订阅分组管理中添加地址,保存后还要执行一次更新,列表里才会出现节点。多个来源拆成不同分组,遇到更新失败时便于逐组复查。更新后确认当前使用的节点仍在列表里;若原节点已被移除,应从更新后的同组列表重新选择。
| 项目 | v2rayN 桌面 | v2rayNG 安卓 |
|---|---|---|
| 添加地址 | 订阅分组设置 | 订阅分组管理 |
| 更新订阅 | 更新全部订阅 | 更新订阅 |
| 剪贴板导入 | 支持 | 支持 |
路由规则决定已进入内核的流量走代理、直连还是拦截,并不能让未接管的应用自动走代理。桌面端可从路由设置查看规则,把特定目标的规则放在宽泛规则之前,再用一个已知目标验证。安卓端还可以用分应用代理控制哪些应用进入本地 VPN,这和按域名划分出站是两件事。排查误分流时,先确认流量进了客户端,再确认它命中了哪条规则。
| 项目 | v2rayN 桌面 | v2rayNG 安卓 |
|---|---|---|
| 规则入口 | 路由设置 | 路由设置 |
| 域名规则 | 支持 | 支持 |
| 安卓应用列表 | 不适用 | 分应用代理 |
桌面系统代理为读取系统设置的应用提供代理入口。遇到应用不读取该设置,或需要接管更大范围的流量时,再考虑用 TUN 虚拟接口接管,并检查权限、路由和 DNS。安卓端通常通过系统 VPN 授权启动,不照搬桌面托盘的操作。换模式前记下原设置,先验证浏览器,再验证目标应用,便于区分是节点故障还是应用未被接管。
| 项目 | v2rayN 桌面 | v2rayNG 安卓 |
|---|---|---|
| 桌面代理 | 自动配置系统代理 | 不适用 |
| 虚拟接口 | 启用 TUN | VPN 模式 |
| 本地代理入口 | 支持 | 支持 |
客户端负责管理配置,内核负责解析配置并建立连接。v2rayN 桌面端可在受支持的节点类型和内核组合间选择;v2rayNG 以 Xray 为内核,不提供同样的桌面式选择流程。切换前先记下原内核及节点参数,切换后查看启动日志和实际访问结果。如果提示配置不受支持,优先恢复原组合,不要把更换内核当成解决所有超时问题的方法。
| 项目 | v2rayN 桌面 | v2rayNG 安卓 |
|---|---|---|
| Xray | 支持 | 支持 |
| sing-box | 支持 | 未提供 |
| 选择入口 | Core 类型 | 未提供 |
安装包选择
先确认设备的处理器架构,再按系统、发行版或界面形态选包。安装包只提供客户端;节点或订阅地址需另外准备。已有客户端的用户,可以先备份原有设置,再使用同一节点验证新安装是否正常。
v2rayN · 桌面版 / WPF 版
在系统的「关于」页面核对系统类型。下载页的两个入口都面向 x64:桌面版采用跨平台界面,经典 WPF 版使用原有的界面布局。首次安装选其中一个即可,不必为了对照教程同时装两套。
遇到压缩分发包,先完整解压到可写目录,再运行程序,不要只从压缩窗口里打开主程序。若系统提示缺少运行环境,按所选发行包的说明处理。旧客户端尚在运行时先退出,避免两套程序争用同一个本地端口。
前往下载v2rayN · Apple Silicon / Intel
打开「关于本机」查看芯片或处理器一栏。Apple 芯片选择 arm64,Intel 处理器选择 x64。不要凭购买年份判断,同一时期上市的机型也可能采用不同架构。打开磁盘映像后按其中的说明安装。
完成安装后,从「应用程序」启动客户端,不要一直在挂载的磁盘映像中运行。首次连接先验证浏览器是否按预期使用系统代理,再处理单个应用的代理设置。出现系统权限提示时,先看它对应的是启动应用,还是启用网络功能。
前往下载v2rayNG · v2flyNG
常用入口是采用 Xray 内核的 v2rayNG;已有配置明确需要 V2Fly 时,再看 v2flyNG。多数近年的机型可选择 arm64。若设备资料没有列出系统支持的应用架构,可先看通用包,而不是把桌面安装包传到手机上。
安装完成后先导入订阅、更新列表并选中节点,再点启动,按系统提示建立本地 VPN 会话。若只有个别应用不通,检查分应用代理列表;如果只是切到后台后一段时间断开,再检查系统是否限制了客户端的后台活动。
前往下载v2rayN · deb / rpm
先按发行版选包格式,再按设备选架构。Debian、Ubuntu 通常选 deb;Fedora、openSUSE 通常选 rpm。下载页分别列出 x64 和 arm64,安装时用发行版的包管理工具查看依赖提示。
首次运行先确认客户端能启动、内核能载入节点,再处理桌面环境的代理设置。即使图形界面中的系统代理已生效,终端程序也不一定读取同一套设置。先按应用逐一验证,再决定是否需要启用 TUN,避免把接管范围和节点问题混在一起。
前往下载快速上手
打开订阅分组设置,新建一组,填写能辨认的备注,再粘贴完整订阅地址。保存只会记录地址,通常不会立刻生成节点。返回主界面执行更新,切到新分组,确认列表中有可选节点。若只有一条节点分享链接,用客户端的剪贴板导入入口,不要把它当作订阅地址填写。
列表仍空时,先确认更新的是刚添加的分组,再查看更新提示。地址有多余空格、订阅已过期,或客户端读到的是登录页面而不是节点内容,处理方法各不相同。先解决列表更新,再进入下一步。
从分组中选择一个节点并设为当前服务器。桌面端第一次测试时,不必同时开启 TUN;先在系统代理菜单选择「自动配置系统代理」,用会读取系统代理的浏览器测试。安卓端则在选中节点后启动连接,首次使用时确认系统 VPN 授权。
如果浏览器能访问而目标应用不能,先检查目标应用是否自带代理设置。确实需要接管不读取系统代理的程序时,再测试 TUN。切换前记录原来的系统代理状态,避免后续无法判断是哪项改动引起问题。
检查客户端日志是否显示内核正常启动,然后打开需要测试的页面或应用。延迟测试只说明该次探测的结果,不能代替实际访问。应用连接失败时,记下大致时间、当前节点、代理模式和第一条有用的错误提示。
下一轮只改一个条件:先用同一应用换一个已知可用的节点,再用同一节点对比不同应用。前者有助于判断节点或传输问题,后者有助于判断应用是否被代理接管。结束测试时关闭 TUN 或清除临时设置的系统代理,检查原有网络访问是否恢复。
开源生态
图形界面负责录入和管理配置,内核负责建立连接、处理协议与执行路由。分清这两层,才能判断该换安装包、修正节点参数,还是调整代理入口。
Project V 将入站、出站与路由组织成可组合的网络配置。入站决定流量怎样交给程序,出站决定怎样发送,路由负责把不同目标匹配到适当的出站。V2Fly 是延续 V2Ray 开发的社区项目,维护 V2Ray 核心及相关文档。
这个分工也能解释常见的配置现象:成功导入节点只说明客户端读懂了列表;节点能否建立连接,要看内核能否使用相应参数;浏览器是否使用这一连接,还取决于应用能否把请求交给客户端。排查时按这三个环节分别确认,比反复更新订阅更有效。
Xray 从 V2Ray 代码体系分出后独立演进,与 V2Fly 共享部分配置概念,但各自维护功能和参数。以 REALITY 为例,它属于连接的安全层设置,不能当成替换 VMess 或 VLESS 的节点协议。把一组连接参数拆成节点协议、传输和安全层,有助于查到真正不兼容的字段。
在桌面端更换内核时,先核对原节点使用的传输、流控与安全选项是否都受支持。能载入配置后,再观察连接日志;如果启动就报错,优先查配置和内核组合,而不是修改系统代理或反复更换 DNS。
v2rayN、v2rayNG 和 v2flyNG 都是开源图形客户端。v2rayN 管理桌面端的节点与路由,可结合受支持的内核使用;v2rayNG 面向安卓,以 Xray 为内核;v2flyNG 面向需要 V2Fly 内核的安卓配置。相似的界面或名称不代表高级设置和配置文件可以直接互换。
开源许可约束的是代码的使用、修改与再分发,具体条款以各项目及随包组件的许可证为准。客户端代码开源,与订阅服务由谁提供、节点能否长期使用,是两回事。选择客户端时先看平台和内核需求,排查订阅时再单独确认订阅来源和更新状态。
客户端更新会改变界面、默认设置或运行环境;内核更新会改变可用协议特性、配置解析或连接行为;更新订阅则是重新拉取节点列表。三类更新互不替代。节点列表没有刷新时,不必先重装程序;内核拒绝识别字段时,反复刷新列表也未必有用。
变更前记下当前节点、系统代理模式、自定义路由和监听端口。每次只更新其中一层,用同一个节点和应用复测,再决定是否改下一项。若遇到无法连接,可回到原设置与新设置的差异上逐项定位。对协议名称或配置字段有疑问,可先查术语表。
配置与排查
用握手流程图式的讲解拆开 REALITY 的证书借用思路与 XTLS Vision 的流控机制,说明它们减少重复加密的原理,以及在 v2rayN 中对应的配置项。
从本机时间同步、端口与系统代理状态,到订阅更新、传输层参数和 TLS 设置,按由近到远的顺序逐项排查节点超时,附每一步的判断方法。
对比 v2rayN 两种 Windows 发行形态的界面与运行环境差异,走完解压、首次运行、导入订阅、系统代理设置全流程,并汇总杀软误报与端口占用等常见坑。