Project V 生态 · 图形配置指南

V2Ray图形客户端v2rayN / v2rayNG

按设备选择开源客户端,从订阅导入到路由分流,逐项完成连接配置。

按操作系统选择
协议与安全层
  • VMess
  • VLESS
  • Trojan
  • SS
  • REALITY
内核家族
  • Xray
  • V2Fly

客户端下载入口

按系统选择安装包

桌面系统选择 v2rayN,Android 首选 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。先确认设备架构,再进入下载页查看对应入口;客户端安装完成后,还需要有效的服务端配置或订阅链接才能建立连接。

Windows

v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面,适合希望在不同桌面系统上保持相近操作习惯的用户;WPF 版保留经典桌面界面,可按既有使用习惯选择。两者都应结合服务端参数配置协议、传输方式与安全层,不能只根据界面外观判断连接能力。

首次安装先检查系统要求与运行环境。若已经有可用配置,升级前记录订阅分组、路由规则和本地监听设置,避免同时修改多项参数后难以定位问题。

前往下载

macOS

v2rayN 按 Apple Silicon 与 Intel 芯片提供不同安装入口。可在系统的“关于本机”中查看芯片信息,再选择对应架构。芯片架构与协议类型是两件事:前者决定程序能否正常运行,后者决定客户端如何与服务端建立连接,不需要因为换了电脑就自行更改订阅中的协议。

安装后先验证普通系统代理是否生效,再按需要配置更广的流量接管范围。遇到授权提示时,应阅读系统显示的具体说明,确认操作对象与下载的客户端一致。

前往下载

Android

v2rayNG 使用 Xray 内核,作为安卓端首选;v2flyNG 使用 V2Fly 内核,适合已有相应配置的用户作为备选。主流设备通常选择 arm64,无法确认架构时可查看通用版说明。导入订阅后,应检查条目是否包含当前内核支持的协议和安全层,而不是在两个客户端间反复导入同一份不兼容配置。

连接时需要确认系统 VPN 授权。若切换应用后连接中断,再检查电池优化、后台运行权限以及是否有其他应用占用 VPN 接口;这些系统行为不等同于订阅失效。

前往下载

Linux

v2rayN 提供 deb 与 rpm 安装入口,并区分 x64 与 arm64。先按发行版的包管理体系选择格式,再匹配处理器架构。图形客户端适合在桌面环境中管理订阅、选择服务器与调整路由;安装包格式并不改变协议能力,具体支持仍由客户端调用的内核决定。

桌面环境中的系统代理设置不一定覆盖每个应用。若浏览器可以连接而其他程序不生效,先检查该程序是否读取系统代理,再评估是否需要 TUN 与相应权限,不必立即重装客户端。

前往下载

配置功能

订阅、协议与流量范围

从左侧选择配置主题。界面拼贴用于解释设置项,实际菜单名称可能随客户端变化;填写参数时,以服务端提供的信息和当前内核支持范围为准。

更新订阅(不通过代理)
自动更新订阅
subscription

订阅将一组服务器配置集中到一个地址,适合定期同步条目。v2rayN 可通过订阅分组区分来源,v2rayNG 可在订阅设置中添加地址并执行更新。首次导入先保留原始链接,确认分组内出现可识别的配置,再选择条目连接。更新失败时,应区分地址过期、网络不可达与返回格式不兼容;是否通过代理更新,取决于订阅地址的实际可达性。与逐条粘贴分享链接相比,订阅更便于同步,但更新也可能替换手动修改的条目。

查看订阅导入步骤 →

开源生态与配置边界

Project V、V2Fly 与 Xray

V2Ray 是 Project V 生态中的核心项目之一。理解“客户端、内核、协议”这三层关系,比记住一串设置名称更有用:客户端提供操作入口,内核执行连接逻辑,协议约定双方如何通信。桌面与手机可以采用不同客户端,但服务端参数必须分别得到正确表达。

项目背景:从核心到图形界面

Project V 以模块化网络代理工具为背景,V2Ray 将入站、出站、路由和传输等功能组织在同一配置体系中。V2Fly 延续了 V2Ray 的社区维护与演进;Xray 从相关代码基础发展而来,在部分协议与安全层方向形成自己的实现。它们不是同一程序的两种皮肤,也不能仅凭名称相近就假定配置可以原样互换。

图形客户端在这些能力之上增加了订阅分组、分享链接解析、菜单设置和日志查看。用户在界面里选择一项设置后,客户端通常会把它转换成内核能够理解的配置。因此,界面保存成功只说明输入已被接受,是否能够启动与连接,还需要结合内核日志及服务端状态判断。

这也解释了为什么教程需要同时写清客户端名称和内核名称。同样叫作“路由设置”的菜单,可能提供不同的预设;同样一份分享链接,在不同实现中也可能出现字段识别差异。迁移设备时先验证基础连接,再迁移自定义规则,比一次性搬入所有历史配置更容易排查。

内核选择:先看配置兼容性

Xray 与 V2Fly 都能处理多种代理配置,但它们支持的具体字段、传输组合和扩展能力会随各自演进而变化。涉及 REALITY 等特定功能时,必须选择明确支持该功能的内核;已有 V2Fly 配置也应按其支持的格式使用,不能只修改一个协议名称就期待得到相同效果。

连接体验还受服务端负载、网络路径、传输方式以及设备性能影响。协议名称本身不能保证更低延迟、更少耗电或更高速度。移动端尤其应关注后台连接是否稳定、是否频繁重连以及是否启用了不必要的功能。没有实际需求时,保持默认并一次只调整一项,通常更便于判断设置的真实影响。

订阅中存在多个协议时,可以让客户端按自身支持方式生成配置。如果日志提示未知字段、缺少必要参数或安全层不受支持,先核对导入结果与内核能力,再联系配置提供方确认参数。反复切换服务器但保留同一个错误字段,通常无法解决这类启动问题。

开源属性:区分各层许可证

v2rayN、v2rayNG 与 v2flyNG 都是开源图形客户端,核心代码采用 GPL 系列许可证;V2Fly 的 v2ray-core 与 Xray-core 核心代码采用 MPL 2.0。客户端、内核和随包依赖并不必然使用同一许可证,具体发行物应以其附带的许可证及第三方声明为准,不能把某个内核的许可证直接套用到整个安装包。

对普通使用者而言,开源意味着程序的实现可以被研究,社区能够围绕问题反馈、兼容性和功能改进开展协作。它不替代对配置来源的判断,也不等于任何订阅服务都可信。客户端是工具,服务器由谁运营、订阅地址由谁提供,以及日志中会记录什么,都需要分别了解。

分享问题时,建议只保留错误类型、相关设置名称和必要的环境说明。订阅链接、认证字段及完整配置可能包含访问凭据,不宜直接贴到公开讨论中。排查需要的通常是错误上下文,而不是把所有个人配置原样展示出来。

更新机制:程序与订阅分开管理

更新客户端、更新内核与更新订阅是不同操作。客户端更新主要涉及界面、解析逻辑和功能集成;内核更新影响底层协议与配置行为;订阅更新则同步服务器条目。只有订阅更新失败时,不应直接推断客户端安装损坏;内核无法启动时,也不应先把所有订阅删除重建。

准备更新前,先记录当前可用配置与自定义设置。更新后保持原有连接方式,验证普通访问和常用应用,再逐项尝试新增功能。如果一次同时调整内核、DNS、路由与流量接管模式,即使出现异常,也很难判断是哪一处变化导致。

本站首页提供平台入口和配置说明,具体安装包信息集中在下载页。判断是否需要更新,应结合当前问题、功能需求和发行说明,而不是只看数字变化。长期可维护的配置应尽量简明,让每一条自定义规则都有明确用途,并在不再需要时及时移除。

三款客户端的适用范围

v2rayN:面向桌面使用,适合管理多个订阅分组、查看日志并维护常用路由。不同桌面平台的界面、系统代理接口和权限行为可能有差别,不能把某个平台的操作步骤机械套到另一个平台。已有配置的用户,应优先确认常用协议与自定义规则可以正常加载,再决定是否调整界面或内核选项。

v2rayNG:面向 Android,使用 Xray 内核,将订阅、分享链接和连接设置组织在移动界面中。系统 VPN 授权、分应用代理和后台运行策略共同决定实际使用范围。若某个应用无法访问,既要看代理规则,也要看它是否被排除在接管范围之外,不应只通过重新导入订阅来尝试修复。

v2flyNG:面向需要 V2Fly 内核的 Android 使用场景,可作为已有相应配置时的备选。它与 v2rayNG 名称相近,但底层能力不能按同一套假设判断。选择时先核对协议与传输参数;如果配置依赖特定内核扩展,就应直接使用支持该扩展的客户端,而不是在导入后不断删改关键字段。

三款客户端都需要用户自行提供有效的连接配置。图形界面负责配置管理,并不会因为安装完成就自动产生服务器。初次使用可先阅读配置教程;需要比较协议、安全层和内核兼容性时,再查阅协议详解。遇到订阅更新或连接异常,可到常见问题按现象缩小排查范围。

配置文章

路由、证书与订阅管理

基础连接可用后,再逐项处理规则和管理需求。下面三篇文章分别对应流量去向、握手错误与多订阅整理,按当前遇到的问题阅读即可,不需要先改动所有设置。