客户端安装与配置文档 PROJECT V

V2Ray最新版下载

下载v2rayN 查看教程

集中整理 四平台客户端入口、订阅导入步骤与路由分流说明。从安装包选择到连接排查，按传输层、协议层和路由层逐段拆开配置，减少在多个设置页面之间反复确认的成本。

永久免费 代码开源 中文文档 图形客户端
PLATFORMS Windows Android macOS Linux

CONFIGURATION LAYERS

按图层理解 V2Ray 配置

客户端界面把复杂字段收进表单，但连接结果仍由传输、伪装、协议和路由四组参数共同决定。逐层检查比反复切换节点更容易定位问题。

TRANSPORT / 01

传输方式决定数据如何抵达服务端

传输层处理 TCP、WebSocket 等承载方式，以及端口、路径、主机名和安全层的组合。导入订阅后，客户端通常会自动写入这些字段；手动调整时则必须与服务端逐项一致。节点超时、握手失败或连接后立即断开，往往应先检查地址、端口、传输类型和 TLS 设置，而不是直接改动系统代理。把承载方式单独视为一层，可以避免协议名称相同就误判为配置完全相同。

在 v2rayN 或移动端客户端中，先打开节点编辑页记录当前传输类型，再核对路径、Host、SNI 与安全选项。每次只修改一组字段并重新测试，能保留清晰的排查路径。

CLIENT ENTRY

按设备选择客户端入口

桌面设备统一以 v2rayN 为主要入口，Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。首页只负责分流，具体安装包、架构说明和系统要求集中放在下载页。

DESKTOP / WINDOWS

Windows

Windows 桌面端使用 v2rayN。下载页分别说明新一代跨平台桌面界面与经典 WPF 界面的选择方式，并整理运行环境、系统代理、开机启动和订阅更新入口。首次安装可先确认系统架构，再按日常操作习惯选择界面版本；已有配置迁移时，则应先导出当前节点与路由设置。

前往 Windows 下载

DESKTOP / MACOS

macOS

macOS 桌面端同样使用 v2rayN，安装前先在系统信息中确认芯片类型。Apple Silicon 与 Intel 安装包不能只按文件名大小判断，下载页已把两类入口分开排列。完成安装后，再依次处理首次启动权限、订阅导入和系统代理状态；若菜单栏显示已连接但应用流量没有变化，应继续检查代理模式与应用自身的网络设置。

前往 macOS 下载

MOBILE / ANDROID

Android

Android 以 v2rayNG 作为主要图形客户端，使用 Xray 内核；需要 V2Fly 内核路线时，可选择 v2flyNG。多数近年设备可从 arm64 入口开始，无法确认架构时再查看通用安装包。移动端连接还受电池优化、后台活动限制和本地网络切换影响，因此导入订阅后应先完成单节点测试，再处理分应用代理和后台保活。

前往 Android 下载

DESKTOP / LINUX

Linux

Linux 桌面端使用 v2rayN，下载页按 deb 与 rpm 软件包体系整理入口，并补充 x64、arm64 的架构区别。选择文件前，应先确认发行版使用的软件包管理体系与处理器架构。安装完成后可从客户端界面导入订阅、选择节点并启用系统代理；若桌面环境未接管代理变量，还需检查应用是否读取系统代理设置。

前往 Linux 下载
查看全部客户端 →

OPEN SOURCE ECOSYSTEM

Project V、V2Fly 与 Xray 的关系

客户端、内核与协议不是同一个层级。理解三者的职责边界，才能在更新、迁移和故障排查时准确判断应该检查哪一部分。

从生态名称拆到实际组件

Project V 是围绕代理协议、传输机制与路由能力形成的开源技术生态。早期 V2Ray 奠定了配置结构和模块化思路，后续社区在不同方向持续维护内核与客户端。用户日常操作的 v2rayN、v2rayNG、v2flyNG 属于图形客户端；真正负责处理入站、出站、传输、安全层和路由规则的是客户端调用的内核。界面更新与内核更新可以分别发生，因此排查时需要同时记录客户端名称、内核路线和配置来源。

V2Fly 延续 V2Ray 的社区化维护路线，核心组件强调模块组合与跨平台运行。Xray 则在相近配置体系上发展出自己的内核实现和功能演进。两条路线存在共同概念，也有各自支持的传输与安全能力。订阅提供方写出的字段必须与当前客户端所用内核兼容，不能因为界面能够导入就直接推断所有字段都会按预期执行。

CORE FAMILY / 01

V2Fly：模块化内核路线

V2Fly 维护 V2Ray 核心体系中的协议、传输、DNS 与路由模块。配置通常由 inbounds、outbounds、dns、routing 等区块组成，图形客户端会把常用字段转换成表单，再由内核读取生成后的配置。需要手动微调时，理解区块之间的引用关系比记忆单个开关更重要：入站接收本地流量，出站决定发送路径，路由负责把匹配结果交给指定出站。

CORE FAMILY / 02

Xray：兼容概念下的独立演进

Xray 与 V2Ray 共享许多配置概念，但属于独立演进的内核路线。v2rayNG 常用 Xray 处理实际连接，因此客户端更新后出现配置行为变化时，需要同时查看内核能力和订阅字段。协议名称、传输名称相同，不代表不同内核中的全部可选项完全一致。进行跨客户端迁移时，应优先迁移订阅来源与基础节点信息，再重新核对路由、DNS 和按应用分流等本地设置。

CLIENT / 03

v2rayN：桌面端配置入口

v2rayN 面向 Windows、macOS 与 Linux 桌面环境，负责订阅管理、节点编辑、系统代理、路由模式和内核调用。其价值不只是提供连接按钮，而是把多个配置层集中到可检查的界面中。桌面端排查应先区分“内核连接失败”和“系统流量没有进入本地代理”两类问题：前者检查节点与传输参数，后者检查系统代理、浏览器设置和本地端口占用。

CLIENT / 04

v2rayNG 与 v2flyNG：移动端两条内核路线

v2rayNG 以 Xray 内核路线为主，提供订阅导入、二维码迁移、路由设置和分应用代理等移动端操作入口。v2flyNG 对应 V2Fly 内核路线，可用于需要该内核兼容性的配置。两款客户端都属于社区维护的开放源码软件，更新节奏可能分别受到界面适配、系统网络接口变化和内核发布影响。选择时应依据配置兼容性，而不是只比较界面外观。

LICENSE & MAINTENANCE

开源协议与更新链路

V2Ray 相关内核与图形客户端采用公开的开源许可证，源代码、构建方式和变更记录由各自项目维护。许可证定义代码使用与再分发边界，客户端发布则通常同时涉及界面代码、内核组件和系统适配。下载新版时，应先阅读功能变化并保留现有配置；跨较长更新周期升级，可先导出订阅、路由与本地设置，再验证新客户端是否正确接管系统代理。站内下载页负责按平台整理当前安装入口，教程与排查手册负责解释配置操作，二者不把界面版本变化混同为协议本身发生变化。

TECH NOTES

配置解析与故障排查文章

近期内容集中在 DNS 查询路径、JSON 配置结构和订阅解析。每篇文章从一个可复现的现象出发，给出检查顺序与设置入口。

故障排查

V2Ray DNS 泄漏检测与防泄漏配置实操

文章先区分系统解析、客户端内置 DNS 与路由拦截三条路径，再说明如何观察查询出口、定位明文请求来源，并在 v2rayN 与 v2rayNG 中调整对应设置。重点不是机械替换解析地址，而是确认域名解析结果与最终出站规则保持一致。

阅读全文 →
深度解析

V2Ray 配置文件 JSON 结构逐段解析

以真实结构拆解 inbounds、outbounds 与 routing 三个核心区块，解释标签如何互相引用、请求怎样从本地入站进入指定出站，以及路由规则为何会影响部分请求而不是整条连接。适合需要读懂导出配置或手动调整规则的用户。

阅读全文 →
故障排查

V2Ray 订阅失效与解析失败自查清单

当订阅更新报错、节点列表为空或新节点未覆盖旧配置时，按链接有效性、响应内容、编码格式、更新时的代理路径和客户端兼容性逐项检查。文章分别标出 v2rayN 与 v2rayNG 的订阅更新入口，并说明如何保留原配置进行对照。

阅读全文 →
查看全部文章 →