Project V 生态 · 客户端与配置

V2Fly官网客户端与配置

下载v2rayN 查看教程

从订阅导入到路由分流，按平台查找开源客户端与对应设置。

  • VMess
  • VLESS
  • Trojan
  • REALITY
Windows Android macOS Linux

配置入口

订阅、路由、
代理模式一处配齐

订阅分组与过滤关键字

多个订阅源先分组，再更新。v2rayN 从订阅分组设置添加名称与地址，保存后执行更新订阅；过滤关键字用于整理服务器名称，不会改写远端配置。把工作与测试用途分开，后续更换订阅地址时就能保留清晰的来源关系。与逐条粘贴分享链接相比，订阅适合持续同步服务器变更。更新后列表为空，先清空过滤条件，再检查地址是否过期，不要反复重装客户端。

查看分组与过滤方法 →
订阅分组设置
名称工作
过滤关键字按服务器名称筛选
保存后执行更新更新订阅

安装包选择

按平台找客户端

先确定系统与处理器架构，再决定界面或内核。下载页集中提供对应入口。

查看全部客户端 →

Windows

v2rayN 首推

桌面版使用 Avalonia 跨平台界面，经典 WPF 版保留另一套操作布局。首次使用可从桌面版开始；已有 WPF 使用习惯时，先阅读两种界面的差异，再决定是否迁移。选包时同时核对系统要求与处理器架构，不要只按文件名中的客户端名称判断。

安装后先进入订阅分组设置，保存订阅地址并更新，再选择一个服务器。启用自动配置系统代理后，用浏览器测试连接；若内核无法启动，检查日志中的端口占用与配置错误。TUN 涉及额外权限，应在普通代理连接正常后单独开启。

前往下载 Windows 客户端 →安装说明

macOS

v2rayN

Apple Silicon 设备选择 arm64，Intel 设备选择 x64。可在苹果菜单的“关于本机”中确认芯片或处理器信息。下载磁盘映像后按提示安装到应用程序目录，再从该目录启动，避免长期从临时挂载位置运行。

首次打开遇到系统安全提示，先确认应用来源，再通过系统设置提供的允许入口处理，不要为了启动应用而整体关闭系统保护。配置订阅后，分别检查系统代理和 DNS 行为。若退出后浏览器仍无法连接，查看网络设置是否残留本地代理地址，再重新启动客户端确认监听状态。

前往下载 macOS 客户端 →安装说明

Android

v2rayNG 首推

优先选择采用 Xray 内核的 v2rayNG；需要 v2fly 内核时，可查看 v2flyNG 备选入口。多数较新的手机适用 arm64，架构不确定时先查设备信息，通用包用于覆盖更多架构，并不代表连接能力更强。

在订阅设置中添加名称与地址，返回主界面更新订阅，选中服务器后启动连接。系统弹出的 VPN 连接请求用于建立本地接管通道，不等于订阅已经可用。遇到锁屏后断开，检查电池优化和后台运行权限；配置应用分流时，还要明确所选应用属于代理列表还是绕过列表，避免方向理解相反。

前往下载 Android 客户端 →安装说明

Linux

v2rayN

按发行版的软件包体系选择 deb 或 rpm，再区分 x64 与 arm64。Debian、Ubuntu 系通常使用 deb，Fedora 等发行版通常使用 rpm。下载页同时列出架构入口，安装时留意软件管理器给出的依赖提示，不要把不同架构的包混装。

桌面环境对系统代理的处理不完全一致，命令行程序也未必读取桌面代理设置。先确认客户端本地监听，再在具体应用里指定代理地址。需要 TUN 时检查权限与路由变化；不要长期用高权限运行整个桌面会话。遇到连接问题，先区分应用没有使用代理，还是内核出站连接失败，再决定修改哪一层。

前往下载 Linux 客户端 →安装说明

内核与开源生态

客户端、内核、协议

三个层次分别判断：界面管理配置，内核执行配置，协议决定连接双方怎样通信。

Project VV2FlyXray

Project V 与 V2Fly 的关系

Project V 是围绕网络代理工具形成的开源项目生态，V2Ray 是其中的核心软件之一。V2Fly 社区延续 V2Ray 相关内核的开发与文档工作。“V2Ray”在日常讨论里也常被用来泛指相关客户端，但安装在桌面上的 v2rayN 并不等于内核本身。区分这些名称，才能读懂教程里“更新客户端”和“更换内核”各自修改了什么。

图形客户端通常负责订阅、服务器列表、路由模板和系统设置，再把整理后的配置交给内核运行。因此，界面出现某个字段，并不能单独证明当前内核支持它。实际使用还要核对所选内核、服务器要求和客户端生成的配置。排查时先记录这三项，通常比直接更换整套软件更有针对性。

Xray 与 V2Fly 不是同一能力清单

Xray 是从相关代码基础发展出的另一条内核分支，两条路线保留部分共同概念，也各自演进。VMess、VLESS、传输层与安全层需要分别理解；REALITY 是安全相关技术，不能简单当成与所有代理协议并列的独立服务器类型。配置是否可用，要看具体组合，而不是只看分享链接能否被界面识别。

涉及 XTLS 或 REALITY 的配置，应按 Xray 对应实现核对要求。不同内核之间不保证所有字段、默认值和行为完全一致。迁移时先保留可用配置，再测试一条明确支持的连接，观察日志是否出现未知字段、传输不匹配或握手错误。本文展示的配置窗口仅说明入站和路由字段，并非可以直接运行的完整配置。

三款客户端的开源边界

v2rayN 面向桌面环境，提供图形化的服务器、订阅和路由管理；v2rayNG 面向 Android，常用发行采用 Xray 内核；v2flyNG 则提供基于 v2fly 内核的 Android 使用路径。三者都是开源客户端，但界面功能、内核能力和平台权限不能因为名称相似就视为完全相同。

开源意味着代码可按各项目的许可证条款阅读、使用与再分发，并不意味着所有组成部分都采用同一种许可证。图形界面、内核和规则数据应分别看待。客户端也不是订阅服务：安装软件不会自动生成可用服务器，订阅的有效期、内容和授权范围由提供方决定。选择客户端时，应先确认现有配置需要什么协议，再看平台与操作习惯。

更新客户端、内核与订阅

客户端更新主要影响界面、配置管理和平台适配；内核更新影响协议实现与运行行为；更新订阅则重新获取远端服务器内容。三种操作处理不同对象。订阅失效时重装界面通常不能解决问题，界面异常时反复更新订阅也没有帮助。先确定故障属于哪一层，再进行对应操作。

更新前保存必要设置，记录当前内核选择、路由模式与本地监听端口。更新后先测试基础连接，再恢复自定义规则和 TUN。订阅更新可能覆盖来源服务器的参数，因此需要长期保留的手动配置应与订阅分组分开管理。订阅地址、分享链接和完整配置可能含有访问凭据，不宜直接放入公开截图或排查记录。

配置排查按数据流顺序进行

一次连接可以拆成应用、入站、路由、出站与远端服务几个环节。浏览器没有读取系统代理，属于应用到入站的问题；端口被占用，属于本地监听问题；请求被规则送到错误标签，属于路由问题；远端参数不匹配，则需要检查出站与服务器。DNS 又可能影响域名解析和规则匹配，不能只在最后才考虑。

建议每次只改一个变量，并保留修改前后的日志。先确认服务器配置可以建立连接，再验证分流规则，最后处理透明接管。测试网页能打开，只能说明这次请求完成，不能证明所有程序、所有域名和所有传输都走了预期路径。需要判断具体行为时，结合客户端日志与应用自身代理设置，比单看托盘图标更可靠。

配置前先厘清四个问题

订阅地址与分享链接能互换吗？
不能直接视为同一种输入。订阅通常返回服务器集合，单条分享链接描述一个连接，完整配置还可能包含路由与 DNS。先确认内容格式，再选导入入口。查订阅与节点术语 →
全局代理与 TUN 是同一个开关吗？
不是。全局通常描述流量进入内核后的路由去向，TUN 描述流量如何被接管。即使启用 TUN，仍然可以按规则分流；应用未进入代理链路时，单改全局策略也无法接管它。查代理模式术语 →
导入成功为什么还不能连接？
导入成功只说明客户端接受了输入。还要检查配置是否完整、内核是否支持、远端是否有效，以及时间与网络环境是否符合连接要求。先读取日志，不要把所有失败都归为订阅格式问题。查协议与传输术语 →
规则里的 direct、proxy、block 是固定协议名吗？
它们常被用作出站标签，标签必须与实际出站定义对应。名称本身不自动创建出站；复制规则时，也需要一起检查引用关系与默认去向。查路由与分流术语 →

配置记录

近期技术文章

从内核兼容性、桌面界面选择到启动日志，按具体问题继续阅读。

查看全部文章 →