v2rayN · 下载与配置指南

v2rayN 下载

下载v2rayN 查看教程

按平台选择客户端，从订阅导入开始，逐步配置代理模式与路由分流。先确认连接，再调整进阶设置。

永久免费 代码开源 中文文档

订阅导入、代理模式与路由分流

按设置顺序理解五项核心功能。右侧为静态设置示意，实际菜单名称可能随客户端界面调整。

订阅分组设置

备注我的订阅
启用开启
订阅操作更新订阅
更新完成后设为活动服务器

示意流程：保存分组 → 获取配置 → 选择服务器。

先分清三个配置层。订阅负责取得服务器资料，系统代理或 TUN 负责把应用流量交给客户端，路由负责决定流量从哪个出口发送。三者需要配合，但不能相互替代。仅更新订阅不会自动证明代理已生效；仅打开系统代理，也不能修复服务器配置中的错误。按这个顺序检查，能减少在不相关的菜单之间来回尝试。

初次使用时保留默认项，只完成一条可验证的连接路径。确认网页能够访问后，再增加分组、定时更新、路由例外和 TUN。每次只调整一类设置，记录修改内容与测试结果。需要完整的线性操作说明，可阅读订阅导入教程；需要理解设置之间的关系，可继续查看从零到精通完整手册。

按操作系统选择客户端安装包

桌面端选择 v2rayN，安卓端优先了解 v2rayNG。进入下载页后，再核对处理器架构与包格式。

Windows

选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面，WPF 版保留经典界面布局；选择依据是操作习惯和系统适配，不是把两者当作不同的代理协议。进入下载页后查看安装说明，并确认系统与处理器满足对应入口要求。

安装完成后，先启动客户端、添加订阅并选中活动服务器，再配置系统代理。若旧客户端仍在后台运行，应先退出旧进程，避免本地监听端口冲突。升级已有安装时，先备份订阅与自定义路由，保留能够恢复的设置副本，再验证常用应用。

前往下载 · Windows

macOS

选择 v2rayN 时，先打开系统的“关于本机”，查看芯片信息。Apple Silicon 对应 arm64 入口，Intel 对应 x64 入口。不要只凭电脑外观或购买年份判断架构，也不要把不同芯片的安装包混用。

首次运行按系统提示处理应用权限；出现拦截时先核对提示内容和系统要求，不要为完成安装而随意关闭系统保护。导入订阅后，分别检查活动服务器和系统代理。浏览器连接正常而其他应用异常时，先查应用是否使用系统代理；确有接管需求，再阅读 TUN 章节并确认所需权限。

前往下载 · macOS

Android

优先选择使用 Xray 内核的 v2rayNG；需要 V2Fly 内核时，再了解 v2flyNG。多数较新的手机适合 arm64 包，架构不确定时先查看设备信息与下载说明，再考虑通用包。两款客户端分别管理配置，不应假定安装后会自动共享订阅和规则。

粘贴订阅地址并更新后，先选择节点，再启动连接并处理系统 VPN 授权提示。同一时间通常只能由一个应用使用系统 VPN 通道，切换客户端前应先停止原连接。若切到后台后断开，检查电池优化与后台运行限制；若始终无法连接，则从节点配置和日志开始排查。

前往下载 · Android

Linux

选择 v2rayN 时，同时核对发行版的软件包体系和机器架构。使用 deb 包体系的发行版与使用 rpm 包体系的发行版应选择各自对应入口；arm64 设备则使用下载页中的对应架构入口。包格式一致不代表全部依赖都已满足，安装提示仍需逐项阅读。

图形桌面环境、系统代理实现与权限管理方式可能不同。首次测试先让浏览器明确使用客户端提供的本地代理入口，再检查桌面环境的代理设置。需要启用 TUN 时，确认授权方式以及现有虚拟网卡是否冲突。日常只使用图形客户端即可完成订阅与服务器管理，不必先部署路由器方案。

前往下载 · Linux

安装包用于安装客户端，不包含可直接使用的服务器订阅。订阅地址与服务器参数应从可信来源取得，并按所在地法规与网络服务规则使用。

查看全部客户端 →

Project V 生态与开源客户端

分清项目、内核、客户端和服务器配置，再决定需要安装什么、更新什么。

从界面到连接

图形客户端
v2rayN · v2rayNG · v2flyNG
内核家族
Xray · V2Fly
连接配置
协议、传输、加密与服务端参数
本地接入
系统代理、应用代理或 TUN

这是职责分层示意，不表示每款客户端都支持图中全部功能组合。

阅读 V2Ray 内核区别 →

Project V：先理解生态名称

V2Ray 起源于 Project V 体系，常被用来指代相关代理技术与工具生态。日常搜索中的“V2Ray 客户端”通常指带图形界面的配置管理程序，而不是某一个固定安装包。客户端把订阅、服务器、路由等设置组织成可操作的界面，再交由内核执行连接。理解这层关系后，就不会把客户端下载、服务器配置与内核更新混为一件事。

同一份分享链接能够被多个客户端识别，并不意味着所有高级字段都能完整迁移。导入前应确认来源提供的是订阅地址、单条分享链接，还是原生配置文件；不同入口承担不同任务。首次配置建议沿着客户端界面完成操作，建立可用连接后，再学习协议与传输细节。

V2Fly 与 Xray：按配置能力选择

V2Fly 延续 V2Ray 相关内核的社区开发，Xray 则是在相关技术基础上发展出的另一条内核路线。两者共享部分概念与协议背景，但功能支持、配置字段和演进方向并不完全相同。选型时先看服务端要求的协议与传输组合，再核对客户端实际提供的内核支持。名称相似不能替代兼容性判断，也不能据此推导固定的速度高低。

若配置包含某条路线特有的能力，应使用支持该能力的内核与客户端组合。切换后遇到无法启动、字段不识别或握手失败，先查看日志中的明确错误。保留可用配置再做试验，比一次调整内核、DNS、路由和传输方式更容易确认原因。

三款客户端：开源不等于同一界面

v2rayN、v2rayNG 与 v2flyNG 都是代码开源、免费使用的客户端项目，采用 GPL-3.0 开源许可。开源许可说明代码使用、修改与再分发的条件，不替代服务器服务条款，也不代表任何订阅来源都可信。桌面端与安卓端的界面、权限和网络接入方式各有差别，阅读教程时应先确认客户端名称，再对应具体菜单。

v2rayN 面向桌面系统，适合集中管理订阅、服务器与路由设置；v2rayNG 面向安卓设备，使用 Xray 内核；v2flyNG 提供 V2Fly 内核路线的安卓备选。选择时以平台和配置兼容性为先，不需要为了功能名称更多而同时运行多款客户端。迁移时先保留原配置，再逐项验证订阅、连接和分流。

更新机制：程序、内核与订阅分别维护

客户端更新负责界面与程序逻辑，内核更新影响协议处理与连接能力，订阅更新则重新取得服务器资料。这三类操作处理不同内容：更新程序不会自动修复已过期的订阅，更新订阅也不会为旧内核增加新功能。日常维护时，先根据错误发生的位置选择操作，不要把“全部更新”当作唯一排查方法。

升级前备份自定义路由、订阅分组和重要设置，阅读相关变更说明。升级后先用原来的可用服务器测试基本连接，再验证局域网访问、常用应用与 DNS。订阅地址中的凭据应像账号资料一样保管；分享截图或日志时，遮盖地址参数、用户标识及服务器认证信息。需要记录问题时，保留错误类型与发生步骤即可。

连接前常见问题

导入订阅后，为什么还不能直接使用？

导入地址只是保存来源，更新订阅才会读取服务器资料。取得资料后，还要选择服务器、设为活动服务器，并让应用通过系统代理或其他接入方式使用客户端。若列表为空，先查更新订阅的错误提示；若列表存在但无法连接，再查服务器与本地接入。按订阅导入步骤逐项确认。

系统代理与全局路由，是同一个开关吗？

不是。系统代理决定遵循系统设置的应用是否把请求交给客户端，路由模式决定客户端接到请求后如何发送。即使选择全局路由，不读取系统代理的应用也可能没有经过客户端。先检查接入，再检查分流，能避免把应用代理问题误判成节点故障。具体顺序见代理配置教程。

怎样确认连接真正生效？

不要只看启动按钮或单次延迟。先执行客户端提供的连接测试，再用目标应用检查实际访问，同时结合出口地址与日志判断。某个测试成功不代表所有应用都采用相同网络路径；启用分流时，不同目标还可能使用不同出口。按连接验证清单分别测试代理目标与直连目标。

网页打不开时，应该先改 DNS 吗？

先判断是全部连接失败，还是只有部分域名异常。证书错误、认证失败和服务器不可达通常不能通过修改 DNS 解决。确认基础连接后，再查看域名解析结果、DNS 请求路径及路由规则是否一致。调整前记录原配置，每次只改一个环节；进阶说明见DNS 设置章节。

V2Ray 使用教程与连接排查

从首次连接到线路诊断，再到路由器部署。按当前问题选择文章，不必一次修改所有设置。

遇到明确报错时，先记录客户端、操作步骤和错误文字，再选择对应文章。描述问题时隐藏订阅凭据，保留必要的配置类型与错误上下文。

查看全部文章 →