客户端安装与配置文档

V2Ray镜像站 客户端下载

下载v2rayN 查看教程

按系统选择 开源客户端，从订阅导入到路由分流，查阅中文配置教程与内核选型说明。

  • 永久免费
  • Xray · V2Fly
  • 订阅与路由

安装包入口

按平台选择客户端

桌面使用 v2rayN，安卓优先查看 v2rayNG。先确认系统与处理器架构，再进入下载页选择对应安装包。客户端负责读取配置，实际连接还需要有效的服务器信息。

Windows

v2rayN · 桌面版 / 经典 WPF 版

桌面版采用跨平台界面，经典 WPF 版保留熟悉的操作布局。两类入口按界面偏好选择，安装前阅读对应系统要求，不用为了导入同一份订阅同时安装两版。

前往下载 Windows 客户端

macOS

v2rayN · Apple Silicon / Intel

在“关于本机”中查看芯片信息，再选择对应架构的安装包。首次打开时按系统提示完成授权；若系统代理已开启但浏览器没有变化，还要检查浏览器是否使用独立代理设置。

前往下载 macOS 客户端

Android

v2rayNG · v2flyNG 备选

v2rayNG 使用 Xray 内核，v2flyNG 提供 V2Fly 内核路线。主流设备通常选择 arm64，架构不确定时查看通用包说明。首次连接需要确认系统 VPN 授权，同一时间留意其他 VPN 应用的占用。

前往下载 Android 客户端

Linux

v2rayN · deb / rpm

依据发行版包管理体系选择 deb 或 rpm，再区分 x64 与 arm64。图形桌面客户端适合交互式管理订阅；命令行工具及后台服务不一定读取桌面系统代理，需要单独确认应用的代理入口。

前往下载 Linux 客户端

从其他设备迁移时，先保留订阅分组与必要的自定义规则。系统代理、授权状态及本地监听端口属于设备设置，不能仅靠复制节点列表完成迁移。

查看全部客户端 →

协议与内核

配置入口与协议支持

VMessVLESSTrojanShadowsocks
REALITYXrayV2Fly

协议决定连接的约定，传输与安全层决定承载方式。REALITY 属于安全方案，Xray 与 V2Fly 属于内核，不能把这些名称当成同一层的可互换选项。

分组保存，按来源更新

订阅链接用于拉取服务器配置，不等同于单个节点分享链接。在 v2rayN 的订阅分组中保存地址后，执行更新订阅，再回到服务器列表选择使用项。不同来源分组存放，便于判断更新失败发生在哪一组。相比逐条手工维护，订阅更适合跟随提供方的配置变化；但更新可能替换原有条目，手动修改前应保留必要记录。订阅地址通常包含访问凭据，截图、日志和求助内容都应隐去完整链接。

订阅分组地址按来源保存
更新操作更新订阅

界面示意只展示设置入口，具体菜单以所用客户端为准。导入成功不代表所有协议参数都已正确识别；遇到字段缺失，应对照原始配置与内核支持范围，而不是反复更换路由模式。

阅读协议与内核手册 →

首次配置

导入、连接与生效验证

安装完成后，先用一份已知有效的配置完成最小连接流程。每次只改一个环节，记录修改后的结果，再增加自定义分流或分应用设置。

v2rayN 桌面与 v2rayNG 安卓的界面不同，但都需要区分三个状态：配置是否进入列表、内核或 VPN 服务是否启动、目标应用的请求是否实际接入。列表有内容，只能说明导入环节已有结果。

查看完整教程

  1. 导入订阅或分享链接

    订阅地址放进订阅分组并执行更新；单个分享链接通过剪贴板导入。v2rayNG 也可从右上角添加入口导入配置。先识别链接用途，再选择操作，网页地址或过期订阅不能直接当成节点使用。

    若更新后仍为空，查看日志中的地址解析、连接或格式错误。不要公开完整订阅地址，也不要把一次拉取失败直接判断为客户端安装失败。

  2. 选择节点与接入方式

    在服务器列表中选定使用项，桌面端确认系统代理，安卓端确认 VPN 授权。先保留默认或已有路由预设，暂时减少自定义规则，避免多个改动叠加后无法定位原因。

    可使用真连接延迟测试初步判断配置是否能建立测试请求。测试结果受目标地址与线路影响，并非带宽测量，也不代表所有应用的访问结果。

  3. 验证目标应用流量

    打开需要使用代理的应用，发起实际访问，再对照客户端日志、系统代理状态与应用内设置。若测试可用而浏览器失败，优先检查浏览器扩展、独立代理与本地端口对应关系。

    连接完成后再逐项恢复分流规则。结束桌面代理会话时确认系统代理已清除或恢复；安卓端可通过客户端断开 VPN 服务，并检查系统状态栏的连接状态。

开源生态背景

Project V、内核与客户端

下载的是图形客户端，运行连接的是内核，远端服务由配置提供方管理。把这三层分开，才能判断更新、兼容性与连接故障分别属于哪里。

技术渊源Project V

代理工具与模块化配置体系

执行层V2Fly / Xray

协议、传输与路由实现

管理层v2rayN / v2rayNG / v2flyNG

配置导入与图形操作界面

Project V 与 V2Ray 的关系

Project V 是理解 V2Ray 技术背景的起点。V2Ray 采用模块化思路，将入站、出站、路由、传输等能力组织在配置体系中。“V2Ray”在日常讨论中也常被泛指一类客户端或配置生态，实际下载时却需要落实到具体软件名称。搜索结果里的同一个词，可能指内核、图形界面，也可能只是配置格式。

因此，本站按客户端与操作系统组织安装入口，协议说明另放在手册中。用户不必先手写一份完整配置才能开始使用图形客户端，但应知道分享链接包含哪些连接参数、订阅由谁提供，以及哪些设置只存在于本地设备。这样在迁移设备或询问故障时，能够准确描述问题所在层级。

V2Fly 与 Xray 的后续演进

V2Fly 延续 V2Ray 的社区开发，Xray 则从相关技术基础上发展出自己的功能路线。两者在部分协议和配置概念上接近，但不能据此推断所有新特性、字段默认值与行为都一致。尤其是安全层、传输组合及高级路由设置，需要以实际使用的内核文档和客户端支持情况为依据。

协议名字相同，也可能因为传输路径、服务器名称、指纹或安全参数不匹配而连接失败。选择内核时，优先满足服务端配置要求，再考虑客户端是否提供相应界面。没有必要仅凭名称给内核排列统一的速度名次；线路、服务端负载、设备资源与请求类型都会改变体验。

三款客户端的开源边界

v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端。v2rayN 面向桌面平台，提供服务器列表、订阅管理与本地代理设置；v2rayNG 面向安卓并使用 Xray 内核；v2flyNG 则是安卓上的 V2Fly 内核备选。它们的名称相似，不代表安装包可以互换，也不代表每个界面选项完全相同。

开源意味着代码与许可条款可供查阅，软件的使用、修改和再分发仍需遵守各项目及其依赖的许可要求。客户端与内核的许可范围也应分别理解。客户端本身不提供可直接使用的远端服务，安装完成后仍需从有权使用的来源取得配置，并按所在地法律及网络管理要求使用。

客户端更新与配置兼容

图形界面更新、内核更新与订阅更新是三件不同的事。界面更新可能调整设置入口，内核更新可能改变协议能力，订阅更新则拉取远端配置条目。遇到问题时先记录发生在哪个操作之后，再查看相关日志；重新更新订阅，不会自动补齐客户端尚未支持的功能。

更新前保存必要的订阅分组、自定义路由和本地端口设置。更新后先用原来可用的配置验证连接，再检查系统代理与分应用策略。本站提供下载入口和使用文档，不替代上游项目，也不管理订阅内容。安装包选择以下载页说明为准，具体菜单与兼容范围以所用客户端实际表现为准。

技术笔记

客户端操作与故障定位

按具体问题查看操作说明。先确认现象发生在配置导入、内核启动还是应用接入阶段，再选择对应的排查路径。

订阅更新失败与本地端口冲突属于不同层级。前者先看拉取地址和网络访问，后者先看监听失败日志；不要用重复导入订阅代替端口排查。

查看全部文章 →