Windows
v2rayN / Desktop · WPF
下载页提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留经典桌面交互。选择时结合系统环境与使用习惯,不需要为同一组配置同时运行两个客户端。安装前先关闭旧实例,避免本地监听端口被占用。
首次启动后,先导入配置并确认本地服务已经启动,再设置系统代理。如果浏览器仍沿用自己的代理扩展或手动设置,需要单独检查其连接入口。更换监听端口后,依赖该端口的应用也要同步修改。
前往下载 Windows 客户端CLIENT SETTINGS / 客户端设置
先分清客户端界面与代理内核的职责,再逐项配置。客户端负责保存服务器信息、更新订阅和生成运行配置;内核负责接收连接、匹配路由并转发流量。下面五个入口按实际操作顺序排列,窗口仅用于说明菜单和配置关系,不代表当前设备的运行状态。
更新完成后,在服务器列表中选择活动配置。
订阅地址用于批量获取并更新服务器配置,分享链接通常只描述一条配置。v2rayN 可在订阅分组设置中保存地址,再执行更新;v2rayNG 可从订阅分组入口添加。导入前确认复制的是完整链接,而不是网页标题或登录页面地址。首次更新优先使用直连;只有订阅服务明确需要代理访问时,再尝试通过代理更新。地址可能包含访问凭据,不宜出现在公开截图中。导入成功后仍需选择活动配置,列表出现条目并不代表连接已经建立。
查看配置参考 →应用是否采用系统代理,取决于应用自身的网络实现。
自动配置系统代理会把系统支持的代理入口指向本地客户端,适合浏览器等遵循该设置的应用。清除系统代理用于恢复系统设置,不改变系统代理则保留原有状态。这三项控制流量如何进入客户端;进入后走直连还是代理,仍由路由规则决定。部分应用使用独立代理设置,需要手动填写客户端实际监听的地址和端口。退出客户端前先确认系统代理是否恢复,避免系统仍指向已经关闭的本地端口。不要把系统代理开关当作服务器连接成功的判断依据。
查看配置参考 →{
"type": "field",
"domain": ["geosite:cn"],
"outboundTag": "direct"
}
路由分流把不同目标交给不同出站处理。常见条件包括域名、目标地址、端口和入站标签;规则通常从上到下检查,先匹配的规则决定去向。示例把指定域名集合交给 direct 出站,前提是配置中存在同名出站且相关规则资源可用。修改时先添加一条范围明确的规则,再查看日志验证,不要同时调整整个规则集。域名规则与地址规则的结果还可能受到 DNS 策略影响,因此排查时要同时记录访问目标和解析方式,不能只根据网页是否打开来判断分流是否正确。
查看配置参考 →Xrayv2fly协议、传输方式与安全层需要同时匹配。
内核决定协议和传输功能如何执行,图形界面中的名称相近并不意味着配置可以完全互换。遇到不支持的字段或功能时,应先确认服务器所需协议、安全层和传输组合,再核对客户端内核能力。v2rayN 提供相关内核设置,具体可选项以安装包和界面为准;Android 端可按需求选择使用 Xray 的 v2rayNG,或使用 V2Fly 的 v2flyNG。切换前保留可用配置,切换后重启相关服务并阅读启动日志。连接超时不一定由内核造成,不能把反复切换当作通用修复步骤。
查看配置参考 →可用性取决于平台、运行权限及随包组件。
TUN 模式通过虚拟网络接口接收流量,适用于不遵循系统代理的应用,但会增加权限、路由和 DNS 层面的配置要求。启用前先在普通代理方式下确认服务器可用,再检查系统授权及其他网络工具是否占用相同功能。v2rayN 的 TUN 能力依赖平台与随包组件,不能直接照搬一份原始 V2Ray 入站配置。若启用后网络异常,先关闭 TUN 恢复基线,再逐项检查路由与解析。系统代理、TUN 和应用独立代理并非越多越好,重复接管可能使问题更难定位。
查看配置参考 →准备好可用的服务器配置或订阅地址,导入后选中一条配置,再开启合适的代理入口。先用浏览器访问一个已知可达的目标,并观察客户端日志是否出现对应连接。这个过程只验证当前配置与当前应用,不需要立刻启用复杂路由、虚拟接口或自定义 DNS。基础路径可以正常工作后,再逐项加入额外设置,每次修改都保留能够恢复的状态。
测试结果也要分开看。服务器条目存在,说明格式已被客户端接受;端口测试有结果,说明某一层连接可能可达;实际网页能够访问,才进一步涉及域名解析、传输握手和应用请求。不同测试测量的对象并不相同。遇到结果矛盾时,记录测试方式和日志,比只比较一个延迟数字更有帮助。
理解 JSON 时,可以依次阅读入站、路由和出站。入站描述本地连接从哪里进入;路由描述如何选择处理路径;出站描述最终向哪里转发。DNS 负责相关解析,策略项则调整连接管理行为。教程中的端口和规则只是语法示例,实际使用时应以客户端设置为准,尤其不要假定所有客户端都采用相同的默认端口。
图形客户端可能在启动时重新生成配置文件,因此直接修改生成文件未必能够长期保留。优先使用界面提供的自定义路由或配置入口,修改前导出备份。需要核对字段类型、数组结构和标签对应关系时,继续阅读V2Ray 配置文件参考;不熟悉入站、出站和传输等名称时,可先查阅术语表。
DOWNLOAD / 平台与安装包
桌面平台选择 v2rayN,Android 优先查看 v2rayNG,也可根据 V2Fly 配置需求了解 v2flyNG。先确认操作系统、处理器架构与安装包格式,再进入下载页选择具体文件。客户端与订阅是两件事:安装客户端不会自动获得服务器配置,导入订阅也不会替代系统所需的安装与授权步骤。
v2rayN / Desktop · WPF
下载页提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留经典桌面交互。选择时结合系统环境与使用习惯,不需要为同一组配置同时运行两个客户端。安装前先关闭旧实例,避免本地监听端口被占用。
首次启动后,先导入配置并确认本地服务已经启动,再设置系统代理。如果浏览器仍沿用自己的代理扩展或手动设置,需要单独检查其连接入口。更换监听端口后,依赖该端口的应用也要同步修改。
前往下载 Windows 客户端v2rayN / Apple Silicon · Intel
先在系统的“关于本机”中确认芯片类型,再选择 Apple Silicon 或 Intel 安装包。架构选择与服务器协议无关,不能根据订阅名称判断。按照安装提示完成应用放置,首次运行时阅读系统给出的权限与安全提示。
系统代理与 TUN 模式的授权范围不同,建议先用普通代理验证连接。若只是某个应用无法访问,先检查该应用是否遵循系统代理,不要直接扩大到全设备流量接管。下载页集中列出架构入口及安装前需要确认的事项。
前往下载 macOS 客户端v2rayNG / v2flyNG
v2rayNG 使用 Xray 内核;v2flyNG 使用 V2Fly 内核,可作为对应配置需求的备选。多数较新的设备可先查看 arm64 安装包,架构不明确时再了解通用包。最终能否安装还取决于系统与应用要求,不应仅凭设备购买年份判断。
导入后选择配置并启动连接,首次启动通常需要确认系统的网络连接请求。后台省电限制可能影响持续运行,出现锁屏后断开时应检查应用后台权限。订阅地址与二维码都可能携带访问凭据,分享操作截图前要遮挡相关内容。
前往下载 Android 客户端v2rayN / deb · rpm
按发行版的软件包体系选择 deb 或 rpm,再确认设备使用 x64 还是 arm64 架构。包格式与处理器架构是两个独立条件,文件可以下载并不代表能够在当前环境安装。桌面环境及相关运行依赖也需要符合客户端要求。
不同桌面环境对系统代理的支持方式可能不同,终端程序也未必读取桌面代理设置。验证时应区分浏览器连接与命令行连接,分别确认它们的代理入口。先保证图形客户端与本地监听正常,再考虑虚拟接口权限和系统路由配置。
前往下载 Linux 客户端设备上已经安装过客户端时,更新前先保存订阅分组、自定义规则及必要的应用设置。不要在未确认配置兼容性的情况下覆盖唯一可用的环境。安装包解决的是程序部署问题,连接问题仍应按配置、代理入口、路由与日志的顺序逐层检查。
查看全部客户端 →PROJECT V / 内核与图形客户端
V2Ray 既是常见的检索名称,也关联到 Project V 生态中的具体软件与配置体系。日常操作主要发生在图形客户端里,实际转发则由所使用的内核执行。理解这层关系,才能正确判断一篇教程、一份 JSON 和当前安装的客户端是否适用。
Project V
V2Fly / Xray
v2rayN / v2rayNG / v2flyNG
Project V 以模块化的网络代理能力为基础,V2Ray 的配置围绕入站、出站、路由、DNS 和连接策略等部分展开。模块化意味着同一种本地入口可以配合不同出站,也意味着单个协议名称不足以描述完整连接。阅读配置时,需要同时看认证信息、传输方式与安全层,而不是只确认一项名称是否相同。
V2Fly 社区延续 V2Ray 相关实现与维护,Xray 则在相关技术基础上形成独立演进的内核项目。两者共享部分概念和配置习惯,但功能、字段与更新节奏并不完全一致。一份在某个内核中有效的配置,换到另一个内核后仍需核对支持情况,尤其是涉及特定传输与安全机制的字段。
v2rayN、v2rayNG 和 v2flyNG 都是代码开源的图形客户端项目。开源让实现方式、改动记录与许可证条款能够被公开讨论,但不代表任意第三方配置都适合直接导入。客户端提供的便利主要在于管理配置、调用内核和展示日志;服务器参数是否有效、订阅内容是否可信,仍需要结合来源判断。
桌面端的 v2rayN 便于集中管理订阅、系统代理和路由。Android 端的 v2rayNG 与 v2flyNG 则围绕移动系统的连接授权和后台运行组织界面。三者不是同一程序的不同名称,菜单和设置也不必逐项一致。选择时先看设备与配置需求,再阅读对应客户端教程,避免把桌面菜单直接套到移动端。
开源许可证规定代码使用、修改与分发的条件,不等同于订阅服务的使用条款。内核、图形客户端与随附依赖可能采用不同许可证,需要以各项目随附说明为准。V2Ray 相关核心实现采用的 MIT 许可,以及 Xray-core 采用的 MPL 2.0,体现的是各自代码的授权规则,不能据此推断所有组件都使用同一种许可。
站点名称也不等于项目身份。本页是客户端与配置的中文阅读入口,介绍 Project V、V2Fly 与 Xray 的技术关系,不把教程站与内核项目混为一谈。判断某个功能是否存在,应以所安装客户端的界面、随附说明和实际运行日志为准,而不是仅凭搜索结果中的产品简称。
客户端更新、内核更新、订阅更新和路由资源更新分别解决不同问题。更新客户端可能改变界面或配置生成逻辑;更新订阅会重新取得服务器条目;更新路由资源则影响域名或地址集合的匹配。订阅更新通常不会替换客户端程序,安装新客户端也不意味着订阅中的服务器参数会自动修复。
出现故障时,先记录最近改动,再检查日志。配置解析失败优先查字段、格式与内核兼容性;本地端口占用优先查重复实例;握手失败需要核对时间、目标地址和安全层参数。公开日志前应移除订阅地址、用户标识及认证内容。分层排查比同时重装、切换内核和重写路由更容易保留线索。
READING NOTES / 配置专题
基础连接已经建立后,再按具体问题补充知识。导入失败适合先读格式说明,配置选型适合查看协议对比,连接异常则从运行日志入手。专题文章分别处理一个问题,便于和配置参考中的字段说明交叉查阅。
分别演示桌面端与安卓端添加、更新订阅的菜单入口,并说明 Base64 订阅、vmess:// 与 vless:// 分享链接的结构及导入失败的常见原因。
阅读订阅导入说明 →横向比较四种代理协议的认证方式、加密层、传输组合与客户端支持情况,按桌面日常、移动端省电、自建服务等场景给出选型参考。
阅读协议对比 →讲解日志级别设置与日志结构,逐条拆解连接超时、端口占用、配置解析失败、TLS 握手错误等常见报错的含义与排查步骤。
阅读日志排查方法 →