v2rayN / v2rayNG / v2flyNG 客户端

V2Ray之家客户端下载与配置

按设备选择开源客户端,从导入订阅到验证路由分流,逐项完成设置。

节点管理DNS 设置
01 阅读路径

客户端、订阅与分流

先分清三个角色:客户端是操作界面,内核负责处理连接,订阅是更新节点列表的一种方式。下载客户端只是第一步,并不会自动获得可用节点。

第一次安装

从下载页核对系统、处理器和安装包类型。换设备时也按新设备重新选包,不要直接沿用旧设备上的安装文件。

已有订阅地址

订阅是一项会更新的节点来源。导入后还要更新列表并选中节点;如果拿到的是单条分享链接,则走单节点导入,不必创建订阅分组。

连接异常

先区分是列表没有更新、内核启动失败,还是只有某个应用打不开。记下故障发生在哪一步,再去查对应的问题,比重新安装更容易定位。

02 核心设置

路由、订阅与 DNS

把问题分开处理:路由决定连接走哪条路径,订阅决定节点从哪里来,DNS 决定域名怎样解析。

让特定连接走指定路径

出站是内核处理连接的出口,可以是直连,也可以交给代理。与把所有已接管连接送往同一出口的配置相比,路由分流可以按域名或地址匹配:例如让本地服务直连,把需要代理的连接交给选中的节点。先用预设建立基线,再加一条确实需要的规则。保存后分别打开一个应直连和一个应走代理的目标,对照日志确认具体命中了哪条规则。若实际路径不符,先检查具体规则是否被排在更宽泛的规则之后。

配置项:出站标签

{ "protocol": "freedom", "tag": "direct" }

这是直连出站的片段;路由规则通过 outboundTag 引用同名标签。

03 安装包

按平台获取客户端

先看系统,再看处理器架构。包名里的 x64 与 arm64 表示不同的硬件架构,不代表功能多少,也不能按名称新旧随意互换。

Windows

选择 v2rayN。桌面版采用跨平台界面,经典 WPF 版沿用原有界面。初次安装前,在系统的「关于」页面查看系统类型,再核对下载页要求。

如果是从旧环境迁移,先记录当前订阅分组、路由模式和系统代理状态。不要让两个客户端同时管理系统代理,否则很难判断最后是哪一个写入了设置。

前往下载

macOS

在「关于本机」查看芯片或处理器。Apple 芯片选择 arm64 包,Intel 处理器选择 x64 包,两者都是 v2rayN 的桌面入口。

首次开启代理前,先确认客户端和内核能启动。如果系统提示权限或兼容性问题,按提示内容对照安装要求,不要把启动失败和节点不通混在一起排查。

前往下载

Android

优先看采用 Xray 内核的 v2rayNG;需要 V2Fly 生态的配置时,再比较 v2flyNG。设备明确支持 arm64 时可选对应包,不确定时先对照通用包的要求。

两款客户端的安装包不能相互覆盖更新。切换前记下节点来源和应用分流范围,切换后重新测试常用应用,不要假设旧客户端的设置会自动继承。

前往下载

Linux

先按发行版选包格式,再按机器架构选 v2rayN。Debian 和 Ubuntu 系发行版通常使用 deb,Fedora 等发行版通常使用 rpm。

图形客户端和在网关上单独运行内核是不同用途。桌面安装后,先用会读取代理设置的应用做测试;终端程序和后台服务未必会沿用桌面环境的设置。

前往下载

查看全部客户端 →

04 快速上手

从导入订阅到验证连接

第一次配置只建立一条可验证的路径。用同一个测试目标逐步验证,等基本连接成立,再加应用分流或自定义 DNS。

  1. 导入并更新列表

    打开客户端的订阅管理,把地址添加到新的分组里,保存后对该组执行更新。更新前先记住分组名称,更新后切回这个分组查看结果。若列表为空,先检查选中的分组,再核对复制时有没有带入空格或换行,以及订阅是否仍有效。

    如果服务方只给了单节点链接,请走分享链接导入;把单节点链接当订阅更新,往往得不到预期列表。订阅地址可能携带访问凭据,求助时可以描述报错,但不要直接贴出完整地址。

  2. 选中节点并开启接管

    从已导入的列表中选一个字段齐全的节点,把它设为当前节点。桌面端可以从系统代理开始,先用遵循系统代理的应用测试;手机端按客户端提示建立系统 VPN 连接。启动状态和代理接管是两件事:内核启动成功,不代表测试应用一定在使用它。

    先保留默认路由,不同时打开多个接管方式。若设备原来就在运行另一套代理或有单位下发的网络设置,先确认哪些设置可以改动,并记录原来的状态。

  3. 验证访问和退出状态

    先访问一个平常能直连的目标,再验证一个按规则应走代理的目标。有日志时,把测试时间和目标对应起来,查看连接是否到达内核、是否命中预期出站。节点测速只能辅助比较,不能替代应用内的实际请求。

    完成后停止客户端并复查网络状态。如果退出后浏览器反而打不开网页,先检查系统代理是否还指向已经停止的本地端口,再决定要不要调整节点或 DNS。

查看完整教程 →

05 开源生态

Project V、V2Fly 与 Xray

把客户端、内核和服务来源分开看,才能判断教程里的菜单、配置字段或升级说明是否适用于手上的设备。

一条连接的处理顺序
  1. 应用发起连接
  2. 客户端配置内核
  3. 内核按规则选择出站

查看内核与生态术语 →

  1. Project V:从项目名理解内核

    Project V 提供了一组构建网络代理的工具,V2Ray 是其中处理连接的核心。配置中的「入站」描述内核从哪里接收连接,「出站」描述内核怎么处理收到的连接,路由在两者之间做选择。图形客户端把这些配置组织成节点列表、代理开关和路由页面,省去逐段编辑配置文件的工作。

    看到「V2Ray 配置」时,先判断它指的是完整内核配置、某个字段,还是一条给客户端导入的链接。三者用途不同。例如教程只列了一段出站,就还需要与本地已有的入站和路由配合;把片段当成整个文件覆盖,原来的监听端口和规则也会一起丢失。

  2. V2Fly 与 Xray:同源但独立演进

    V2Fly 延续了 V2Ray 核心的社区维护;Xray 则从相关代码分支发展为独立内核。两者共享许多配置概念,但协议特性、传输选项和字段支持不完全相同。即使两边都显示了同一个协议名称,也要同时核对传输方式、安全设置和服务端参数,不能只凭名称判断是否能用。

    例如,同为 VMess 的两个节点可以使用不同的传输方式。导入成功只说明客户端读懂了链接,后续连接还依赖所选内核支持相关字段,并且两端配置一致。遇到能导入但不能连接的情况,先查当前内核与节点设置,再考虑是否更换客户端。

  3. 三款客户端:界面与默认内核各有分工

    v2rayN、v2rayNG 和 v2flyNG 都是开源图形客户端。v2rayN 面向桌面,可按客户端支持情况为不同节点选择内核类型;v2rayNG 是面向手机的 Xray 客户端;v2flyNG 对应 V2Fly 内核,可在配置明确面向该内核时考虑。客户端提供操作入口,内核处理连接,两者的设置不应混为一谈。

    选型时先看设备和现有配置:需要桌面分组管理,先从 v2rayN 入手;在手机上则按节点要求核对两款客户端。迁移最省事的方式往往是用原有订阅在新客户端重新生成节点列表,再逐项重建自定义规则,而不是直接拷贝另一款客户端的完整设置文件。

  4. 开源许可:代码、订阅和服务是三回事

    开源许可规定代码如何被查看、修改和再分发;它不会为使用者提供远端节点,也不规定第三方服务的流量额度、时段或可用性。客户端的许可说明与服务方的使用条件应分别阅读。遇到订阅失效,应检查地址和服务状态;遇到界面启动失败,应先看客户端运行条件。

    网页截图、配置导出和日志可能暴露订阅地址、节点地址或个人访问记录。整理问题描述时,保留客户端名称、错误类别、触发步骤和必要的脱敏字段就够了。如果问题可重复,记下在什么网络、用哪个测试目标复现,比发一张整屏配置截图更有帮助。

  5. 更新机制:客户端、内核与订阅分开记录

    社区维护的客户端、配套内核和订阅列表有不同的更新节奏。客户端更新可能调整菜单和导入方式,内核更新可能影响协议兼容性,订阅更新则可能替换节点或更改名称。如果三个环节都在同一时间变了,出现异常时很难判断应该回退哪一项。

    更新前可以在本地记录正在使用的客户端、内核类型、当前节点和系统代理模式,并按客户端支持的方式备份必要配置。更新后用原来确认过的测试目标重跑一遍,观察直连、代理和退出状态。如果只有一组节点异常,先检查那组订阅;如果所有应用都失去连接,再回头核对内核启动与系统接管状态。

06 技术笔记

订阅管理与部署笔记

基础连接跑通之后,可以按当前任务继续读:节点列表太长就先整理订阅,准备扩大接管范围再看路由器部署。

查看全部文章 →