v2rayN · v2rayNG · v2flyNG

V2Ray中文版客户端下载与配置

下载v2rayN 查看教程

按设备选择开源客户端，从订阅导入到路由分流，逐项完成本地代理配置。

协议
  • VMess
  • VLESS
  • Trojan
  • Shadowsocks
平台
Windows Android macOS Linux

客户端界面示意 · 菜单与默认端口可能随客户端设置变化

按操作系统选择

V2Ray 客户端下载入口

桌面端选择 v2rayN，Android 优先选择 v2rayNG。安装前先确认系统类型与处理器架构，具体安装包、适用条件和更新信息集中放在下载页。

Windowsv2rayN · Desktop / WPF 桌面版采用跨平台界面，经典 WPF 版延续熟悉的窗口布局。两者都需要导入可用配置，再设置系统代理。 前往下载 → macOSv2rayN · Apple Silicon / Intel 先在“关于本机”查看芯片信息。Apple Silicon 与 Intel 分别对应不同架构的安装包，安装后检查系统代理权限。 前往下载 → Androidv2rayNG / v2flyNG 主流设备通常选择 arm64，不确定架构时可查看通用版。首次连接需确认系统 VPN 授权，再检查后台运行限制。 前往下载 → Linuxv2rayN · deb / rpm 按发行版选择 deb 或 rpm，再区分 x64 与 arm64。桌面环境的代理设置与应用自己的代理选项需要分别确认。 前往下载 →

客户端负责管理配置、启动内核和设置本地入口；连接所需的服务器地址、认证信息与订阅地址需要另行准备。安装完成但列表为空，通常还没有导入配置，不代表安装失败。订阅可能包含多个服务器，先选中其中一个作为活动配置，再进行连接测试。

同一份订阅在不同客户端中的导入结果可能不同，原因包括协议支持范围、传输设置和订阅格式。迁移前保留原配置，先验证单条服务器能否正常使用，再导入整组订阅。设备架构决定安装包能否运行，协议兼容性决定配置能否连接，这两项应分开判断。

查看全部客户端 →查看三款客户端横向评测 →

客户端设置目录

订阅、代理与路由设置

先确定请求是否进入客户端，再决定请求如何转发。下面按日常配置顺序整理常用设置，一次查看一项。

v2rayN · 设置参考

订阅分组与服务器更新

订阅分组把来源相同的服务器放在一起，方便单独更新、筛选和移除。先打开“订阅分组设置”，填写备注与完整订阅地址，保存后执行“更新全部订阅(不通过代理)”。如果当前网络无法访问订阅地址，再判断是否需要通过已有代理更新。订阅更新成功不等于服务器可连接，还要选择活动服务器并测试实际请求。相比逐条粘贴配置，分组更适合长期维护，但订阅地址包含访问权限，不应放进截图或公开日志。

订阅分组 → 订阅分组设置
订阅分组 → 更新全部订阅(不通过代理)

界面上的“连接成功”需要分层理解：内核启动，说明配置至少进入运行阶段；本地端口开始监听，说明应用有了可连接的入口；目标站点能够访问，才说明本次请求经过的整条路径可用。只看到启动日志，不能据此判断所有服务器或所有应用都正常。

建议每次只改一个设置，并保留修改前的状态。浏览器可用而某个应用不可用，先检查该应用是否遵循系统代理；所有应用都不可用，先检查活动服务器、端口和内核日志。把入口问题与转发问题分开，比同时切换协议、DNS 和路由更容易找到原因。需要逐个平台核对时，可继续阅读全平台安装配置指南。

首次使用顺序

V2Ray 配置三步预览

先导入，再设置流量入口，最后验证。先用最少改动跑通一条连接，再增加分流或 TUN 设置。

查看完整教程 →

  1. 导入订阅，选择活动服务器

    准备可用订阅地址，在 v2rayN 的“订阅分组设置”中保存，再执行订阅更新。服务器列表出现内容后，选择要使用的条目并设为活动服务器。Android 可在 v2rayNG 的添加菜单中导入配置或管理订阅，再更新订阅内容。二维码、剪贴板和订阅地址是不同入口，选择与手头资料一致的方式。

    列表为空时先检查地址是否完整、是否过期，以及更新日志是否显示获取失败。不要连续导入同一地址制造重复分组；重复条目不会提高可用性，反而容易把后续测试结果对应到错误的配置。订阅地址应视为访问凭据保存。

  2. 启用代理，确认流量入口

    桌面端先选择“自动配置系统代理”，路由从“绕过大陆”开始。Android 点击连接按钮后，确认系统 VPN 授权；如果系统已有其他 VPN 正在运行，先确认当前由哪个应用接管连接。完成这些步骤后，客户端才能接收相应应用发出的请求。

    首次配置不必同时开启所有开关。系统代理能满足浏览器需求时，先保持这一方式；确实需要接入忽略系统代理的应用，再研究 TUN。设备上同时运行多个代理客户端，可能争用本地端口或覆盖系统设置，测试时保留一个活动客户端更容易判断结果。

  3. 验证访问，按日志定位问题

    打开目标站点，再查看客户端日志中是否出现对应连接。延迟测试适合比较当前网络下的响应情况，但测试失败不一定意味着服务器完全不可用，测试成功也不能证明所有站点都能打开。最终应以实际应用请求为准，并确认分流结果符合预期。

    遇到超时，先核对服务器地址、端口和网络；遇到握手失败，再检查时间、TLS 与配置参数；遇到端口占用，先退出重复进程。验证结束后记录有效的配置组合。以后更新或迁移时，先恢复这组已知可用的设置，再逐项增加改动。

开源生态与客户端职责

Project V、V2Fly 与 Xray

V2Ray 常被用作生态的统称。下载时需要分清图形客户端、代理内核与服务器配置，三者承担不同职责。

项目背景与内核家族

Project V 围绕模块化网络代理工具建立技术体系，V2Ray 是其中广为使用的实现。V2Fly 社区继续维护 V2Ray 相关实现与文档，Xray 则从这一技术脉络发展出独立的内核项目。它们共享部分概念和配置习惯，但后续功能、传输能力与配置细节并不完全一致，不能简单看作可以随意替换的同一个程序。

对图形客户端用户来说，内核差异主要体现在某种协议或扩展选项是否能被识别，以及生成的配置是否符合当前内核要求。服务器提供的参数应与客户端所用内核匹配。看到陌生的传输名称时，先核对支持情况，再决定是否更新客户端或调整内核，而不是反复重装同一个安装包。

三款客户端的开源定位

v2rayN 是面向桌面的开源图形客户端，承担服务器管理、订阅更新、系统代理与路由配置等工作，适合在电脑上集中管理连接。v2rayNG 面向 Android，使用 Xray 内核，常用于手机端的配置导入与 VPN 接入。v2flyNG 同样面向 Android，采用 V2Fly 内核，适合作为已有配置与该内核体系相匹配时的备选。

三款客户端并不是三个服务器服务，也不会在安装后自动提供连接参数。界面帮助用户生成和管理本地配置，实际的远端连接仍由导入内容决定。因此，客户端名称相同不代表订阅来源相同；订阅中出现某种协议，也不代表每一款客户端都能使用其中的全部扩展功能。

开源许可与社区维护

开源意味着源代码以相应许可证开放，使用、修改和再分发仍应遵循各项目的许可条件。V2Ray 与 Xray 内核采用 MPL-2.0 许可体系，客户端及其依赖应以各自附带的许可说明为准。开源许可描述代码的使用规则，并不替代用户对订阅来源、服务器权限和本地隐私设置的判断。

社区维护通常分别推进界面、内核和文档。某项能力可能先出现在内核中，再由客户端补充设置入口；也可能需要新的配置格式才能使用。阅读更新说明时，要确认变化发生在哪一层。遇到界面没有对应选项，不宜直接认定协议不可用，也不宜把其他内核的字段生搬到当前配置中。

更新前后保留验证路径

更新客户端、更新内核与更新订阅是三件不同的事。客户端更新改变界面和管理逻辑，内核更新影响连接能力与配置解析，订阅更新则替换服务器列表或参数。排查问题时记录刚刚执行的是哪一种更新，能明显缩小范围。不要在同一轮测试中同时替换安装包、订阅和路由规则。

更新前保存必要的配置与自定义规则，更新后先测试此前可用的一条服务器，再验证常用站点、局域网访问和应用代理行为。若只在某个应用中出错，优先核对入口设置；若启动就报配置错误，优先核对内核兼容。本站集中整理下载入口与图形界面路径，连接服务本身仍由用户选择的配置来源提供。

配置记录与问题排查

V2Ray 使用文章

基础连接可用后，再按具体问题阅读。路由文章解决请求去向，日志文章帮助定位失败环节，入门问答用于快速复查操作顺序。

查看全部文章 →