客户端入口与配置文档

V2Ray下载站:客户端与配置教程

集中整理 v2rayN、v2rayNG、v2flyNG 的下载入口与操作文档,说明 订阅导入、协议选择、路由分流 的实际配置顺序。

代码开源 中文文档 Xray · V2Fly 永久免费
4 个平台入口 桌面端 v2rayN Android v2rayNG · v2flyNG 内核家族 Xray · V2Fly 协议资料 VMess · VLESS
配置路径

客户端功能与操作重点

从订阅管理到路由分流,按实际使用顺序拆解关键设置。切换主题可查看对应界面结构、适用场景和常见误区。

第一步

订阅导入与节点更新

订阅地址用于批量取得服务端提供的节点配置。桌面端通常在订阅分组中新增地址,保存后再执行更新;Android 客户端则可从剪贴板导入或扫描服务方给出的二维码。导入动作只负责写入配置清单,不等于已经选中可用节点,也不会自动决定系统代理模式。

正确顺序是先确认订阅地址完整,再执行一次手动更新,随后进入节点列表选择具体条目。订阅名称应写成能够区分用途的短语,避免多个来源混在同一列表中。更新失败时先检查地址是否被截断、有效期是否正常以及设备时间是否准确,不要反复删除客户端配置。

查看订阅导入步骤 →
Subscription groups v2rayN
订阅分组 节点列表 更新记录
更新当前订阅读取远程配置清单 可执行
自动更新按客户端设置的周期处理 已配置
分组备注用于区分不同订阅来源 建议填写
下载入口

按平台选择客户端

桌面设备统一查看 v2rayN,Android 可在 v2rayNG 与 v2flyNG 之间选择。下载页会继续说明安装包类型、系统要求和架构差异。

Windows

Windows 桌面端使用 v2rayN,可在新一代桌面界面与经典 WPF 界面之间选择。初次安装应先确认系统架构,再完成解压或安装、订阅导入、节点选择和系统代理设置。若程序能够启动但浏览器流量没有变化,应优先检查系统代理是否已经启用,而不是立即修改协议参数。

前往下载

macOS

macOS 桌面端同样使用 v2rayN。下载时需要按设备处理器选择 Apple Silicon 或 Intel 安装包,二者不能仅凭系统外观判断。安装后如遇到系统拦截,应在系统安全设置中核对应用权限。完成订阅导入后,先使用系统代理验证基本连接,再判断是否需要更深层的流量接管。

前往下载

Android

Android 平台可选择基于 Xray 内核的 v2rayNG,或使用 v2fly 内核的 v2flyNG。多数近年设备适合 arm64 安装包,无法确认架构时再查看通用包。导入订阅后需要明确选中节点并启动连接;切换网络环境后若状态异常,可先停止再重新启动,不必重复导入相同订阅。

前往下载

Linux

Linux 桌面端使用 v2rayN,下载页按常见发行版提供 deb 与 rpm 类型,并区分 x64 和 arm64 架构。安装后需要留意桌面会话、托盘支持和权限配置。若只打算在图形桌面中使用,先完成客户端界面内的订阅和系统代理设置;路由器部署属于另一类使用方式。

前往下载

安装包怎么选

平台名称相同并不代表安装包可以互换。桌面端需要核对操作系统、处理器架构与包格式;Android 需要在 arm64 与通用包之间选择。无法确认时,应先打开系统信息页面查看设备类型,再进入下载页对应标签,不要仅根据文件名长度判断。

客户端怎么选

Windows、macOS 和 Linux 直接从 v2rayN 开始。Android 优先了解 v2rayNG,它使用 Xray 内核并提供常见订阅、路由与连接设置;需要使用 v2fly 内核时再考虑 v2flyNG。客户端选择应由平台与内核需求决定,而不是把多个客户端同时安装后反复切换。

生态关系

Project V、V2Fly 与 Xray

先分清协议、内核、客户端和订阅服务四个层次,再判断配置问题发生在哪一层。

Project V 是技术生态,不是单一桌面程序

Project V 形成了一套围绕代理协议、传输方式、路由规则和核心程序的技术生态。用户日常看到的 v2rayN、v2rayNG 与 v2flyNG 属于图形客户端,它们负责提供界面、管理订阅、生成配置并控制内核运行。真正处理入站、出站、协议与路由规则的是客户端调用的核心程序。因此,“客户端能打开”只能说明界面层正常,不能直接证明订阅内容、核心配置和网络接管都已正确工作。

理解这一层关系后,排错会更直接:导入失败通常先检查订阅地址与客户端解析;核心启动失败需要查看协议字段、端口占用和日志;浏览器不走代理则检查系统代理或 TUN;只有部分域名走错出口时再检查路由规则与 DNS。把所有故障都归因于节点,会掩盖真实问题,也容易造成无效重装。

V2Fly 与 Xray 属于相关但独立演进的内核家族

V2Fly 延续 Project V 体系中的核心实现与社区维护路线,围绕常见协议、传输和路由能力持续演进。Xray 在相关技术基础上发展出独立的核心实现,并扩展了协议组合、传输方式和配置能力。二者有不少相近概念,例如入站、出站、路由和 DNS,但支持范围、字段细节与功能节奏并不完全相同。

配置文件或订阅节点能否使用,取决于客户端所调用的内核是否支持对应协议与传输组合。看到 VMess、VLESS、Trojan、REALITY 等名称时,不应只确认客户端名称,还要确认内核类型和参数是否匹配。本站的术语页用于解释这些概念之间的边界,配置手册则按从客户端界面到核心配置的顺序说明实际操作。

开源协议提供可审阅、可分支和可持续维护的基础

v2rayN、v2rayNG、v2flyNG 以及相关内核都由开放源码项目与社区协作维护。开放源码意味着实现方式、配置结构和变更记录可以由开发者审阅,也允许不同维护方向围绕共同技术基础继续发展。对普通用户而言,更直接的价值是文档、问题记录和功能边界能够被公开讨论,客户端与内核之间的依赖关系也更容易核对。

开源属性不等于所有配置天然正确。订阅内容仍由对应服务来源提供,路由规则仍由用户或客户端预设决定,系统权限也由本机环境控制。使用时应区分软件本身、第三方订阅与个人配置,不把三者混成一个判断。本站只整理客户端入口与配置知识,不替代订阅服务的账户、线路或售后说明。

更新应分为客户端、内核和订阅三条线

客户端更新主要涉及界面、平台兼容性和配置管理;内核更新涉及协议实现、传输能力与运行行为;订阅更新则只是重新取得节点清单。这三类更新发生的频率与来源不同。订阅无法更新时,更新客户端未必能解决;内核无法启动时,重复刷新订阅也不会改变字段兼容性。先判断故障层次,再决定更新对象,是更稳定的维护方式。

升级前应记录当前代理模式、自定义路由和 DNS 设置。升级后先使用最小配置完成基础验证,再恢复 TUN、进程规则或复杂分流。若新旧行为不同,优先查看日志中的具体阶段:订阅解析、配置生成、核心启动、系统代理写入、DNS 查询和路由匹配分别对应不同处理方向。

v2rayN:桌面端配置入口

v2rayN 面向 Windows、macOS 与 Linux 桌面环境,提供订阅分组、节点管理、系统代理、路由规则、TUN 和日志查看等界面。桌面用户可先在一个客户端内完成从导入到排错的完整流程。不同平台的安装包与系统权限存在差异,但配置概念基本一致,适合需要在多台桌面设备间保持相近操作路径的用户。

v2rayNG:Android 与 Xray 内核

v2rayNG 是 Android 平台常用的图形客户端,使用 Xray 内核处理协议和路由配置。它适合通过订阅或单节点分享链接导入配置,并提供分应用代理、路由设置、DNS 和连接日志等功能。移动网络与无线网络切换会影响连接状态,排错时应同时确认系统网络、客户端连接和订阅节点三个层面。

v2flyNG:Android 与 V2Fly 内核

v2flyNG 面向需要使用 v2fly 内核路线的 Android 用户,配置概念与 Project V 生态保持关联。选择它时应确认订阅内容和协议组合能够由对应内核处理。若同一节点在不同客户端中的表现不同,应对照内核支持范围、DNS 设置与路由规则,而不是直接复制全部高级选项。

使用判断

常见问题精选

以下问题用于快速定位章节。完整定义、配置示例和排错顺序可继续查看教程与名词解释。

订阅导入成功,为什么节点列表仍然为空?

保存订阅地址后通常还要手动执行一次更新。若更新后仍为空,依次检查地址是否完整、订阅是否有效、设备时间是否准确以及客户端日志是否出现解析错误。订阅地址和单节点分享链接属于不同输入类型,应放入对应的导入入口。

系统代理、规则模式和 TUN 应该先用哪个?

桌面端先使用系统代理验证浏览器与常规应用。需要按域名或地址决定出口时使用路由规则;遇到不读取系统代理的程序,再评估 TUN。分阶段启用可以把节点问题、规则问题和系统接管问题分开判断。

VMess 与 VLESS 的选择由什么决定?

选择取决于服务端提供的协议、传输组合和客户端内核支持,不能只比较协议名称。VMess 包含自身认证与加密设计;VLESS 更轻量,常与 TLS、REALITY 等安全传输组合使用。客户端参数必须与服务端逐项对应。

更新订阅会覆盖自定义路由吗?

这取决于客户端如何保存订阅分组和路由配置。一般应把自定义路由放在独立规则集或单独配置中,并在大幅调整前导出备份。订阅更新主要替换节点清单,不应把订阅名称、节点和路由规则视为同一个对象。

继续查看协议、内核与路由术语 →