v2rayN · Windows / macOS / Linux

V2Ray Windows版v2rayN 下载与配置

从选择安装包开始,用 订阅导入 添加节点,再按应用需要设置 系统代理或 TUN。

  • 代码开源
  • 图形界面
  • 路由分流

功能速查

客户端功能桌面与安卓对照

节点协议与传输参数

导入节点时,先看协议,再看传输与握手设置。桌面 v2rayN 和安卓 v2rayNG 都能通过相应内核处理常见的 VMess、VLESS 和 Trojan 配置,但协议同名不代表传输参数可以互换。复制已有节点时,应保留来源提供的传输方式和安全选项。若桌面能连接而安卓不能,先比较两端解析出的字段,再查内核是否支持该组合,不要同时调整多个选项。

  • VMess:查看协议、传输方式和安全选项是否与来源一致。
  • VLESS:检查流控字段是否适用于节点所用的内核和传输。
  • TLS 与 REALITY:按节点原配置保留对应的握手参数。
项目v2rayN 桌面v2rayNG 安卓
VMess支持支持
VLESS支持支持
Trojan支持支持

安装包选择

四个平台按系统与架构下载

先确认设备的处理器架构,再按系统、发行版或界面形态选包。安装包只提供客户端;节点或订阅地址需另外准备。已有客户端的用户,可以先备份原有设置,再使用同一节点验证新安装是否正常。

Windows

v2rayN · 桌面版 / WPF 版

在系统的「关于」页面核对系统类型。下载页的两个入口都面向 x64:桌面版采用跨平台界面,经典 WPF 版使用原有的界面布局。首次安装选其中一个即可,不必为了对照教程同时装两套。

遇到压缩分发包,先完整解压到可写目录,再运行程序,不要只从压缩窗口里打开主程序。若系统提示缺少运行环境,按所选发行包的说明处理。旧客户端尚在运行时先退出,避免两套程序争用同一个本地端口。

前往下载

macOS

v2rayN · Apple Silicon / Intel

打开「关于本机」查看芯片或处理器一栏。Apple 芯片选择 arm64,Intel 处理器选择 x64。不要凭购买年份判断,同一时期上市的机型也可能采用不同架构。打开磁盘映像后按其中的说明安装。

完成安装后,从「应用程序」启动客户端,不要一直在挂载的磁盘映像中运行。首次连接先验证浏览器是否按预期使用系统代理,再处理单个应用的代理设置。出现系统权限提示时,先看它对应的是启动应用,还是启用网络功能。

前往下载

Android

v2rayNG · v2flyNG

常用入口是采用 Xray 内核的 v2rayNG;已有配置明确需要 V2Fly 时,再看 v2flyNG。多数近年的机型可选择 arm64。若设备资料没有列出系统支持的应用架构,可先看通用包,而不是把桌面安装包传到手机上。

安装完成后先导入订阅、更新列表并选中节点,再点启动,按系统提示建立本地 VPN 会话。若只有个别应用不通,检查分应用代理列表;如果只是切到后台后一段时间断开,再检查系统是否限制了客户端的后台活动。

前往下载

Linux

v2rayN · deb / rpm

先按发行版选包格式,再按设备选架构。Debian、Ubuntu 通常选 deb;Fedora、openSUSE 通常选 rpm。下载页分别列出 x64 和 arm64,安装时用发行版的包管理工具查看依赖提示。

首次运行先确认客户端能启动、内核能载入节点,再处理桌面环境的代理设置。即使图形界面中的系统代理已生效,终端程序也不一定读取同一套设置。先按应用逐一验证,再决定是否需要启用 TUN,避免把接管范围和节点问题混在一起。

前往下载

快速上手

导入订阅三步验证连接

  1. 添加地址并更新订阅分组

    打开订阅分组设置,新建一组,填写能辨认的备注,再粘贴完整订阅地址。保存只会记录地址,通常不会立刻生成节点。返回主界面执行更新,切到新分组,确认列表中有可选节点。若只有一条节点分享链接,用客户端的剪贴板导入入口,不要把它当作订阅地址填写。

    列表仍空时,先确认更新的是刚添加的分组,再查看更新提示。地址有多余空格、订阅已过期,或客户端读到的是登录页面而不是节点内容,处理方法各不相同。先解决列表更新,再进入下一步。

  2. 选中节点并设置代理模式

    从分组中选择一个节点并设为当前服务器。桌面端第一次测试时,不必同时开启 TUN;先在系统代理菜单选择「自动配置系统代理」,用会读取系统代理的浏览器测试。安卓端则在选中节点后启动连接,首次使用时确认系统 VPN 授权。

    如果浏览器能访问而目标应用不能,先检查目标应用是否自带代理设置。确实需要接管不读取系统代理的程序时,再测试 TUN。切换前记录原来的系统代理状态,避免后续无法判断是哪项改动引起问题。

  3. 验证实际访问并记录失败环节

    检查客户端日志是否显示内核正常启动,然后打开需要测试的页面或应用。延迟测试只说明该次探测的结果,不能代替实际访问。应用连接失败时,记下大致时间、当前节点、代理模式和第一条有用的错误提示。

    下一轮只改一个条件:先用同一应用换一个已知可用的节点,再用同一节点对比不同应用。前者有助于判断节点或传输问题,后者有助于判断应用是否被代理接管。结束测试时关闭 TUN 或清除临时设置的系统代理,检查原有网络访问是否恢复。

开源生态

Project V客户端与内核的分工

图形界面负责录入和管理配置,内核负责建立连接、处理协议与执行路由。分清这两层,才能判断该换安装包、修正节点参数,还是调整代理入口。

Project V 与 V2Fly

Project V 将入站、出站与路由组织成可组合的网络配置。入站决定流量怎样交给程序,出站决定怎样发送,路由负责把不同目标匹配到适当的出站。V2Fly 是延续 V2Ray 开发的社区项目,维护 V2Ray 核心及相关文档。

这个分工也能解释常见的配置现象:成功导入节点只说明客户端读懂了列表;节点能否建立连接,要看内核能否使用相应参数;浏览器是否使用这一连接,还取决于应用能否把请求交给客户端。排查时按这三个环节分别确认,比反复更新订阅更有效。

Xray 与协议能力

Xray 从 V2Ray 代码体系分出后独立演进,与 V2Fly 共享部分配置概念,但各自维护功能和参数。以 REALITY 为例,它属于连接的安全层设置,不能当成替换 VMess 或 VLESS 的节点协议。把一组连接参数拆成节点协议、传输和安全层,有助于查到真正不兼容的字段。

在桌面端更换内核时,先核对原节点使用的传输、流控与安全选项是否都受支持。能载入配置后,再观察连接日志;如果启动就报错,优先查配置和内核组合,而不是修改系统代理或反复更换 DNS。

开源客户端与许可证

v2rayN、v2rayNG 和 v2flyNG 都是开源图形客户端。v2rayN 管理桌面端的节点与路由,可结合受支持的内核使用;v2rayNG 面向安卓,以 Xray 为内核;v2flyNG 面向需要 V2Fly 内核的安卓配置。相似的界面或名称不代表高级设置和配置文件可以直接互换。

开源许可约束的是代码的使用、修改与再分发,具体条款以各项目及随包组件的许可证为准。客户端代码开源,与订阅服务由谁提供、节点能否长期使用,是两回事。选择客户端时先看平台和内核需求,排查订阅时再单独确认订阅来源和更新状态。

客户端、内核与订阅的更新

客户端更新会改变界面、默认设置或运行环境;内核更新会改变可用协议特性、配置解析或连接行为;更新订阅则是重新拉取节点列表。三类更新互不替代。节点列表没有刷新时,不必先重装程序;内核拒绝识别字段时,反复刷新列表也未必有用。

变更前记下当前节点、系统代理模式、自定义路由和监听端口。每次只更新其中一层,用同一个节点和应用复测,再决定是否改下一项。若遇到无法连接,可回到原设置与新设置的差异上逐项定位。对协议名称或配置字段有疑问,可先查术语表。

配置与排查

最新使用心得