v2rayN 使用教程 · 下载与配置

v2rayN 下载 订阅导入与代理设置

对照真实设置项完成订阅导入,再按用途配置系统代理与分流。

GPL-3.0 客户端开源协议

三步上手

  1. 导入订阅
  2. 选择节点
  3. 开启系统代理

静态界面示意;实际入口和选项位置随客户端更新可能调整。

代理设置,分清四个入口

路由、系统代理、核心类型与订阅导入分别负责不同环节。先确认问题属于哪一层,再修改对应设置。

路由分流

路由规则决定进入内核的连接走直连、代理还是阻断。日常使用可先了解「绕过大陆」预设,让匹配中国大陆域名或地址的连接直连,其余按规则处理;「全局」则用于把进入该路由的连接统一交给代理出口。两者都不能代替系统代理,也不代表所有应用已被接管。切换后用同一网站复测,避免同时修改 DNS 和节点。自定义规则还要检查顺序,前面的匹配结果可能使后面的规则不再生效。

预设路由
绕过大陆
全局
查看路由设置 →

核心类型

v2rayN 负责图形界面和配置管理,实际连接由核心执行。核心类型要与节点的协议、传输方式及相关参数相适配,不能只按名称选择。客户端中的 Xray 与 sing-box 是不同实现,配置字段和支持范围并不完全相同。先使用客户端适配的默认配置,遇到不支持的字段时再对照日志定位。V2Fly 则是另一个内核家族,不应与 sing-box 混为一谈。更换核心后,应重新检查该节点能否启动,而不是只看界面是否仍有记录。

核心类型 · 说明切换

按 Xray 的协议支持与日志检查配置;REALITY 等参数需与服务端一致。

查阅内核与协议术语 →

系统代理

桌面端选择「自动配置系统代理」,是把本地代理入口写入操作系统的代理设置,供遵循该设置的应用使用。「清除系统代理」用于移除这项设置;「不改变系统代理」表示保持当前状态,不等于关闭连接。浏览器可以访问而某个应用仍无法连接时,先检查该应用是否读取系统代理、是否单独设置了代理地址。系统代理和 TUN 是不同接管方式,首次配置先走系统代理流程,确认基础连接正常后再研究额外模式。

系统代理
清除系统代理
自动配置系统代理
不改变系统代理
排查代理不生效 →

移动端导入

v2rayNG 的右上角加号菜单可用于「从剪贴板导入」和「扫描二维码」。这两个入口常用于添加单节点分享信息,不要把一条分享链接当作可定期更新的订阅。拿到订阅地址时,应进入「订阅分组」填写备注与地址,保存后执行订阅更新。导入完成还要选择配置并启动连接,首次启动按系统提示授权 VPN。二维码和剪贴板内容可能包含访问凭据,分享截图前先遮住地址、标识和密钥等敏感字段。

v2rayNG +
从剪贴板导入
扫描二维码
对照两端订阅入口 →

客户端下载,按系统选择

先确认操作系统和处理器架构,再选对应安装包。桌面端使用 v2rayN,Android 端按内核需求选择 v2rayNG 或 v2flyNG。

Windows

选择 v2rayN。下载页区分桌面版与经典 WPF 版:桌面版采用跨平台界面,WPF 版延续经典桌面操作方式。根据页面标注的系统与运行环境要求选择,不要只按文件名判断。解压包应完整解压到可写目录后运行,避免直接从压缩文件中启动。

前往下载 Windows 客户端

macOS

选择 v2rayN,并在系统的「关于本机」中确认芯片。Apple Silicon 对应 arm64,Intel 对应 x64。首次打开遇到系统安全提示时,先确认下载来源和安装步骤,再按系统提供的入口处理;不要为了运行客户端而直接关闭整个系统的安全保护。

前往下载 macOS 客户端

Android

优先了解使用 Xray 内核的 v2rayNG,需要 V2Fly 内核时再选择 v2flyNG。常见的现代设备可先确认是否为 arm64 架构,无法确认时查看下载页的通用版说明。启动连接需要系统 VPN 授权;已有其他 VPN 连接时,应先处理连接冲突,再检查节点和分应用代理。

前往下载 Android 客户端

Linux

选择 v2rayN 的 deb 或 rpm 包,并匹配 x64 或 arm64 架构。deb 常用于 Debian、Ubuntu 等发行版,rpm 常用于 Fedora 等发行版。图形桌面的系统代理支持方式存在差异,安装成功不代表应用已走代理;必要时到应用自身的网络设置中填写本地代理入口。

前往下载 Linux 客户端

首次配置,按顺序完成

安装客户端只是起点。还需要有效配置、可用出口,以及正确的流量接管方式。下面以桌面端为主线,移动端入口单独说明。

  1. 导入订阅并更新

    在 v2rayN 中打开「订阅分组设置」,新增分组,填写便于辨认的备注,再把完整订阅地址粘贴到「地址(url)」。首次配置时先保留默认更新选项,保存后执行该分组的订阅更新。订阅地址通常用于返回一组配置,和以 vmess:// 或 vless:// 开头的单节点分享链接用途不同,不能随意互换入口。

    v2rayNG 则从「订阅分组」管理订阅。若更新后仍为空,先检查日志中的下载或解析错误,确认复制时没有漏掉查询参数,也没有把说明网页当成订阅地址。订阅属于敏感信息,排查时只记录错误类型,不要把完整地址贴到公开页面。

  2. 选择节点与路由

    更新完成后,在目标分组中选择一条配置并设为活动服务器。先确认它能被当前核心识别,再选择适合日常使用的路由预设。新手可先了解「绕过大陆」的作用,需要对比路由影响时再短暂切换「全局」测试。一次只改变一个设置,保留可复现的对照条件。

    配置能导入不等于服务端一定可达,客户端也不会凭空提供可用连接信息。测试超时可能来自服务状态、地址、端口或当前网络,不能单靠一个测试结果判断原因。若日志提示协议参数不受支持,应先核对核心与配置,而不是反复更新同一订阅。

  3. 开启代理并验证

    桌面端选择「自动配置系统代理」,然后使用遵循系统代理的浏览器访问目标网站,同时观察客户端日志。Android 端选择配置后启动连接,并允许系统 VPN 授权。验证时区分网页解析失败、连接超时与证书错误,这些症状对应的检查方向不同。

    完成后再试一个原本可正常访问的网站,确认路由没有影响日常连接。退出桌面客户端前,可先清除系统代理,避免系统仍指向已停止的本地端口。若浏览器正常、其他应用异常,优先检查该应用自己的代理设置;若所有连接都异常,再回到核心启动日志与本地端口检查。

开源生态,区分客户端与内核

名称相近的项目并不承担同一种工作。了解各层的职责,能减少选型、更新和故障排查时的误判。

Project V 与内核家族

Project V 是理解 V2Ray 技术生态的背景。V2Ray 核心提供协议处理、入站出站和路由等基础能力,V2Fly 延续相关核心的社区维护;Xray 是由这一技术体系发展出的另一条实现路线。二者有共同背景,也存在各自的功能演进与配置差异。

VMess、VLESS、Trojan 是协议相关名称,WebSocket、gRPC 等描述传输方式,REALITY 涉及连接的安全与握手机制。这些名称不在同一层,不能简单排列成互相替代的选项。选择时以服务端实际提供的组合为准,再确认客户端所用核心能够处理。

三款图形客户端

v2rayN 为桌面用户提供订阅管理、配置选择、系统代理和路由设置界面;v2rayNG 面向 Android,使用 Xray 内核;v2flyNG 同样面向 Android,为需要 V2Fly 内核的使用场景提供另一种选择。界面操作习惯可以相似,实际支持的参数仍取决于所带核心。

三款客户端均为开源项目,客户端项目采用 GPL-3.0 协议。开源协议规定代码使用与分发的条件,并不等于所有依赖组件都使用相同协议。阅读配置说明时应同时留意客户端名称与核心名称,不能把某一端的菜单位置直接套用到另一端。

订阅与连接服务

客户端用于保存和执行配置,订阅用于获取配置,服务端则提供实际连接出口。这三者职责不同。本站提供客户端选择和操作说明,不提供订阅地址,也不代替服务端维护。安装完成但列表为空时,应先准备合法取得的配置,而不是在系统代理中寻找订阅入口。

更新订阅会重新获取服务端发布的内容,手工改动的节点可能在后续更新时被覆盖。需要保留测试配置时,先确认客户端的分组和复制方式。订阅失效也可能是地址已被更换或访问权限发生变化,不能通过反复重装客户端解决所有问题。

更新与排查顺序

客户端更新、核心更新、订阅更新是三件事。客户端更新可能调整界面和配置生成方式,核心更新影响连接能力,订阅更新改变具体配置。出现兼容问题时先记录当前错误与操作过程,再判断需要更新哪一层,避免把多个变化叠在一起后无法复现。

更新前保留必要的分组和自定义规则,更新后先测试原来可用的一条配置。若失败,按「核心能否启动、服务端是否可达、DNS 是否正常、应用是否走代理」依次检查。分享诊断信息前,移除订阅地址、用户标识、密钥和个人路径等敏感内容。

配置文章,按主题查阅

最近的三篇说明分别覆盖首次安装、DNS 分流和分享链接。先完成基础连接,再按需要扩展设置。