图形客户端配置文档 按平台整理

V2Ray教程站 V2Ray 配置与客户端上手

下载v2rayN 查看教程

集中整理 v2rayN、v2rayNG、v2flyNG 的下载选择与配置步骤，覆盖从订阅导入、系统代理到 路由分流与 TUN 模式 的常用操作。

永久免费代码开源中文文档图形界面

平台入口

PLATFORMWindows · macOS · Android · Linux
CLIENTv2rayN · v2rayNG · v2flyNG
COREXray · V2Fly
DOCUMENT下载 · 配置 · 分流 · 排查

配置能力

从客户端选择到流量接管

六个章节对应日常配置中最容易混淆的环节。选择任一主题可查看用途、操作边界与判断方法，不把不同层级的设置混在同一步骤里。

客户端选型

先按操作系统确定图形客户端

桌面场景以 v2rayN 为主，它覆盖 Windows、macOS 与 Linux，并提供订阅、路由、系统代理和 TUN 等集中设置。Android 可优先使用采用 Xray 内核的 v2rayNG；需要 V2Fly 内核路线时，可选择 v2flyNG。三者的界面位置和内核侧重点不同，但订阅导入、选择配置、启动连接的基本流程相近。选型时先看平台和内核需求，不需要依据界面外观反复更换客户端。

平台入口

按设备选择 V2Ray 客户端

下载页按操作系统列出对应安装入口与架构说明。首页只负责平台分流，不直接提供安装文件路径，避免在未确认系统和处理器类型前选错构建。

Windows

使用 v2rayN。下载页提供新一代桌面界面与经典 WPF 界面两类选择，适合需要系统代理、订阅管理、路由和 TUN 设置的桌面环境。

前往下载

macOS

使用 v2rayN。进入下载页后应根据设备处理器选择 Apple Silicon 或 Intel 构建；安装完成后的订阅和路由逻辑与其他桌面平台保持一致。

前往下载

Android

优先选择采用 Xray 内核的 v2rayNG，也可按内核需求使用 v2flyNG。多数较新的设备适合 arm64 构建，无法确认架构时可查看通用构建说明。

前往下载

Linux

使用 v2rayN。下载页按常见软件包体系提供桌面构建，并分别列出 x64 与 arm64 入口；选择前应先确认发行版的软件包格式和处理器架构。

前往下载

查看全部客户端 →

快速上手

三步完成基础连接

先建立最小可用配置，再处理路由、DNS 与 TUN。把基础连接和进阶设置分开验证，可以减少多个变量同时变化造成的误判。

导入订阅或单个配置

在客户端的订阅管理中添加订阅地址，保存后执行更新；如果拿到的是单个分享链接，则使用剪贴板导入功能。导入完成后先查看列表中是否出现协议、地址和端口等基本信息。订阅名称建议描述来源或用途，避免多个默认名称堆叠后无法判断更新对象。此阶段只确认配置已进入客户端，不急于修改路由模板和 DNS 参数。
选择节点并设置代理入口

从服务器列表中选择一个配置作为活动节点，启动客户端内核，再根据使用范围开启系统代理。浏览器等遵循系统代理的程序通常可直接使用这一入口。如果应用不读取系统代理设置，应先确认它是否支持手动代理；确实需要接管更广流量时，再转入 TUN 模式。不要在基础连接尚未确认前同时启用多套网络接管工具。
验证结果并保留排查依据

验证时先检查客户端状态和日志是否出现监听失败、权限不足或解析错误，再打开需要访问的目标进行实际测试。若只有部分应用异常，应比较这些应用是否遵循系统代理；若所有域名都无法解析，则优先检查 DNS；若仅特定站点走错出口，则检查路由规则。每次只调整一个设置，并记录调整前后的现象，便于准确定位问题层级。

查看完整教程

生态关系

Project V、V2Fly 与 Xray 内核家族

客户端界面、代理内核和配置数据是不同层级。理解它们的关系，有助于判断功能来源、协议兼容范围与更新影响。

Project V 提供协议与配置体系的基础背景

V2Ray 通常用于指代 Project V 生态中的代理技术与配置方式。它不是单一图形程序，而是一组围绕入站、出站、传输、路由和 DNS 组织起来的能力。用户在桌面或安卓设备上看到的 v2rayN、v2rayNG、v2flyNG 属于图形客户端；真正解析配置并处理连接的是客户端调用的内核。区分这两层后，界面问题、内核问题与订阅内容问题就能分别判断。

V2Fly 与 Xray 是常见的内核路线

V2Fly 延续 Project V 相关实现与配置体系，Xray 则在相近的配置模型上维护自己的功能演进。二者都包含入站、出站、路由、DNS 与多种传输能力，但具体字段、协议扩展和默认行为可能存在差异。订阅中的配置能否正常导入，不只取决于链接格式，还取决于客户端使用的内核是否认识对应字段。遇到兼容问题时，应先确认内核家族，再核对客户端支持范围。

图形客户端负责把内核能力组织成可操作界面

v2rayN 面向桌面平台，集中管理订阅、服务器列表、系统代理、路由规则、DNS 与 TUN 设置。v2rayNG 面向 Android，通常配合 Xray 内核工作；v2flyNG 采用 V2Fly 内核路线，可作为不同内核需求下的选择。客户端并不会改变服务器端配置本身，它主要负责保存配置、生成内核可读取的参数、启动进程，并把运行状态和日志呈现给用户。

开源许可证界定代码使用与分发条件

Project V 生态中的不同项目分别采用自己的开源许可证。许可证规定源代码使用、修改和再分发时需要遵守的条件，不能简单理解为所有项目都使用同一种许可。站点在说明功能时以项目公开的代码与文档事实为依据，不把某个客户端的许可证结论直接套用到全部内核。需要进行二次分发或集成时，应阅读对应项目随附的许可证文本。

更新判断应同时观察客户端、内核与数据文件

一次客户端更新可能包含界面调整、配置生成逻辑变化或内核替换；GeoIP、GeoSite 等路由数据也有自己的更新节奏。因此，功能异常不能只根据客户端名称判断。更新后如果出现路由结果变化，应检查内核、路由数据与现有规则是否仍匹配；如果只是界面位置改变，则优先查看客户端设置结构。保留旧配置的可读备份，比直接覆盖全部设置更便于比较差异。