// CLIENT CAPABILITIES

客户端核心设置

从订阅进入客户端，到系统代理、路由分流和运行日志，四个设置面板对应日常使用中最常见的操作链。这里不把配置拆成孤立术语，而是说明每项设置解决什么问题、何时调整，以及改动后应该观察什么结果。

select feature → read field note

按目标类型决定连接出口

路由分流用于把不同域名、IP 网段或规则集合交给不同出口处理。常见做法是先保留客户端提供的基础规则，再按实际需求增加少量自定义项，并把更具体的规则放在更宽泛的规则之前。v2rayN 的路由设置能够组合 domain、ip、geosite 等匹配方式；调整时应一次只改一组规则，保存后通过运行日志确认命中了预期出口。与全局转发相比，分流更适合长期使用，因为本地服务、局域网地址和指定站点可以保持原有连接路径。

routing.rules[].domain · routing.rules[].ip

// PLATFORM ENTRY

按操作系统选择安装包

桌面端统一从 v2rayN 开始，安卓端根据内核偏好选择 v2rayNG 或 v2flyNG。点击平台入口会进入下载页并自动切换到对应分组，文件格式、架构区别和系统要求都在分组内说明。

查看全部客户端 →

01 / DESKTOP

Windows

使用 v2rayN。下载页提供新一代桌面界面与经典 WPF 界面两类入口，适合希望通过图形界面管理订阅、服务器、系统代理和路由规则的用户。首次安装前先确认系统架构，并为配置目录保留稳定位置，避免移动目录后找不到原有设置。

前往下载

02 / DESKTOP

macOS

使用 v2rayN 桌面客户端。安装包按 Apple Silicon 与 Intel 芯片区分，选择前可在系统信息中查看处理器类型。完成安装后，需要按系统提示授予必要的网络相关权限；若系统阻止首次启动，应从系统设置的安全区域确认应用，而不是反复下载安装包。

前往下载

03 / MOBILE

Android

优先选择使用 Xray 内核的 v2rayNG；需要 V2Fly 内核时，可使用 v2flyNG。大多数近年设备适合 arm64 安装包，不确定处理器架构时可选择通用版。导入订阅后还需主动更新服务器列表、选中一个条目，并确认系统的网络连接授权已经生效。

前往下载

04 / DESKTOP

Linux

使用 v2rayN，并按照发行版的软件包体系选择 deb 或 rpm；设备采用 ARM 架构时，还要对应选择 arm64。安装完成后先从终端或应用菜单确认客户端能够正常启动，再导入订阅。若窗口能够打开但内核未运行，应优先查看执行权限、端口占用和日志路径。

前往下载

// QUICK START

从安装到启用的三步顺序

首次使用时，把客户端安装、订阅导入和代理启用分开完成。每一步结束后先确认结果，再进入下一步，可以避免多个设置同时变化后无法定位问题。

查看完整教程 →

01

选择客户端并完成安装

桌面平台从 v2rayN 开始，Android 从 v2rayNG 开始。下载时先核对操作系统、处理器架构和安装包格式，不要只根据文件名中某一个片段判断。安装完成后先启动一次客户端，确认主窗口、设置入口和日志区域能够打开。桌面端建议将配置目录放在长期保留的位置；移动端则应允许系统要求的网络连接权限，以便后续建立本地接管接口。

如果程序没有正常启动，此时还未导入任何订阅，排查范围通常只涉及系统兼容性、文件权限或运行环境。先解决启动问题，再继续配置，比一开始就修改路由、DNS 和 TUN 更容易得到清晰结论。
02

添加订阅并更新服务器列表

在订阅管理区域新增分组，粘贴完整链接并保存，然后执行一次手动更新。添加订阅和更新订阅是两个动作：只保存链接并不代表服务器条目已经出现在列表中。更新完成后检查分组名称、条目数量和更新时间是否符合预期，再选中一个服务器作为活动项。

若列表为空，先重新复制链接并检查首尾是否夹带空格，再观察日志中是否出现读取或解析错误。多个订阅应分别命名，以便日后判断某个条目来自哪个分组。定期更新可以同步服务端调整，但没有必要在每次启动客户端时重复删除和重建分组。
03

启用代理并验证实际路径

桌面端可先启用系统代理，Android 则在选中服务器后启动连接。不要把界面显示为运行中直接等同于所有程序都已使用该连接：不同应用是否遵循系统代理、路由规则是否命中、DNS 是否按预期工作，都会影响最终结果。验证时先使用一个普通网络请求确认基础连接，再逐步测试需要分流的域名和应用。

基础连接稳定后，再根据需求调整绕过局域网、规则模式或 TUN。每次只改变一项，并保留调整前的可用配置。若出现连接中断，回到日志查看最近一次变更后的启动和路由记录，而不是连续切换多个服务器与模式。

// OPEN SOURCE ECOSYSTEM

Project V、V2Fly 与 Xray 的关系

V2Ray 通常被用来概括一套开放的网络代理技术生态，而不是只指某一个图形程序。早期 Project V 奠定了配置结构、协议实现和模块化处理方式，随后社区围绕不同维护路线形成了 V2Fly 与 Xray 等内核家族。图形客户端负责把订阅、服务器列表、系统代理、路由规则和日志入口组织成可操作界面；真正执行连接、传输、路由与 DNS 处理的部分，则由所选内核承担。

理解“客户端界面”和“内核”之间的边界，有助于排查问题。界面无法启动，通常先检查操作系统兼容性与程序权限；界面正常但内核启动失败，应查看端口、配置生成和运行日志；内核正常而特定请求路径不符合预期，则需要继续检查 DNS、路由规则和接管范围。把所有现象都归结为客户端故障，容易忽略真正发生错误的层级。

ECOSYSTEM Project V 技术生态

协议、传输、路由与配置模型的开放实现体系。

V2Fly 内核家族

延续 V2Ray 体系的社区维护路线，可由 v2flyNG 等图形客户端调用。

Xray 内核家族

在兼容常见配置概念的同时发展独立能力，v2rayN 与 v2rayNG 常用这一内核路线。

01 / CLIENT

v2rayN：桌面图形管理层

v2rayN 面向 Windows、macOS 与 Linux，集中管理订阅分组、服务器条目、系统代理、路由规则、DNS、TUN 与内核运行状态。它的价值主要在于把结构化配置转换为可重复操作的界面流程，并保留日志和高级参数入口。对普通桌面用户而言，先掌握订阅更新、活动服务器选择和系统代理三项操作，就能够建立稳定的基础使用路径；需要精细分流时，再进入路由和高级设置。

02 / CLIENT

v2rayNG：Android 与 Xray 路线

v2rayNG 是 Android 平台常见的图形客户端，通常配合 Xray 内核运行。它将订阅、分享链接、单条配置、路由规则和本地连接控制放在移动端界面中。移动系统会对后台运行、电池策略和网络连接权限施加额外管理，因此同一份服务器配置在桌面端可用、移动端表现不同，并不一定代表协议参数发生变化，还应检查系统是否限制了后台进程或网络接管。

03 / CLIENT

v2flyNG：V2Fly 内核备选

v2flyNG 同样服务于 Android，但采用 V2Fly 内核路线。它适合需要保持 V2Fly 配置习惯，或希望在同一平台比较不同内核行为的用户。选择客户端时不应只看名称相似度，而应确认内核家族、配置支持范围和现有订阅是否匹配。一般用户可先使用 v2rayNG；已有明确 V2Fly 需求时，再选择 v2flyNG，避免在不清楚差异时反复迁移配置。

开源协议与可审阅实现

三款客户端与相关内核均属于开放源码生态。开放实现意味着配置生成、协议处理和功能变更可以被社区讨论与审阅，也让不同客户端能够围绕相同的基础概念提供各自界面。对使用者而言，更实际的判断依据是项目维护状态、文档完整度、系统兼容范围和更新记录，而不是只根据界面样式或名称选择。

更新机制与配置迁移

客户端更新通常涉及界面、内核、规则数据或默认设置变化。更新前应记住当前客户端类型和配置目录位置，更新后先确认订阅分组、活动服务器和代理模式仍然存在，再检查新增选项。跨客户端迁移时，订阅链接往往比手工复制整个配置目录更稳妥；自定义路由和 DNS 规则则需要单独记录，因为不同客户端的界面字段不一定完全对应。