v2rayN
Windows · x64
清单标记7.24.1
两个入口均下载 ZIP 包。先解压到独立文件夹，再按包内说明运行安装程序；不要直接从压缩包预览窗口启动。
客户端下载 / 平台与架构
V2Ray 下载
v2rayN 桌面端，v2rayNG 安卓端。
先选系统，再选适配设备的安装包。
v2rayN、v2rayNG 与 v2flyNG 均为免费开源客户端。下载与安装不等于已配置连接；使用前还需要有效的服务器配置或订阅。
- VMess
- VLESS
- Trojan
- Shadowsocks
- REALITY
安装包入口
按操作系统选择
桌面端选择 v2rayN；Android 首选 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。下载按钮位于各客户端卡片顶部，安装与架构说明列在下方。
Windows 客户端
同为 v2rayN，按操作习惯选择 Desktop 或经典 WPF 界面。
系统与安装要求
| 检查项 | 选择依据 |
|---|---|
| 系统架构 | 本页两个安装包均为 x64。到“设置 → 系统 → 系统信息”查看系统类型。 |
| 系统版本 | 使用仍受支持的 Windows；具体最低版本及运行时要求以当前发行说明、安装器提示为准。 |
| 文件位置 | 选择有写入权限的本地目录，并为解压、安装与配置文件预留空间。 |
| 权限范围 | 先以普通权限完成基本配置；涉及 TUN 或网络组件时，再按功能提示授权。 |
Desktop 与 WPF 的区别主要在界面技术及操作呈现，不宜仅凭界面选择判断某个协议一定可用。协议选项还受所带内核与配置字段影响。首次使用可以先完成订阅导入、服务器选择和系统代理设置，再处理自定义路由。
从旧版升级前，先导出已有配置，退出旧进程。若准备更换界面版本，建议保留原目录并在新目录完成安装，通过客户端支持的导入方式迁移，不要把不同版本的程序文件直接混在一起。
安装完成后若能打开窗口但浏览器连接没有变化，先检查系统代理状态，而不是立即重装。系统代理只影响遵循系统代理设置的应用；需要不同接管范围时，参阅配置教程中的模式说明。
macOS 客户端
在“关于本机”查看芯片，Apple Silicon 与 Intel 分别选择对应安装包。
v2rayN
macOS · 按芯片选择
清单标记7.24.1
下载后打开 DMG，按磁盘映像内提示将应用安装到应用程序目录，再从该目录启动。
系统与安装要求
| 检查项 | 选择依据 |
|---|---|
| 芯片类型 | Apple Silicon 对应 arm64，Intel 对应 x64。 |
| 系统版本 | 以当前发行说明与启动提示为准；旧系统先确认兼容性再升级客户端。 |
| 安装位置 | 安装到应用程序目录，避免一直从临时挂载的 DMG 内运行。 |
| 网络权限 | 设置系统代理或启用网络接管功能时，阅读系统权限提示并确认操作来源。 |
芯片架构与 macOS 版本是两项不同条件。安装包架构正确，并不意味着任意旧版系统都能运行。若启动时提示系统版本不足，应先核对发行要求；反复下载另一种架构通常不能解决系统接口不兼容。
首次启动出现安全提示时，先阅读提示具体内容，确认下载入口和应用来源。对于来源、签名或权限有疑问的文件，应停止操作并查明原因，不使用批量关闭系统安全机制的方式强行启动。
已有其他代理工具运行时，先确认它是否仍在修改系统代理。多个程序同时管理同一项设置，可能导致关闭一个客户端后网络状态不符合预期。迁移时先记录旧工具的代理与 DNS 设置，再逐项启用新客户端功能。
Android 客户端
先看 v2rayNG；仅在配置需要 V2Fly 内核时，再选择 v2flyNG。
v2rayNG
Android · Xray 内核
清单标记2.2.6
版本文字展示清单的版本标记；安装包文件名可能采用不同更新节奏。实际安装版本可在系统应用信息中确认。
v2flyNG
Android · V2Fly 内核
清单标记1.10.31
从 v2rayNG 迁移时，先确认订阅和配置格式。相似的界面并不表示所有设置字段可以直接复制。
系统与安装要求
| 检查项 | 选择依据 | 安装注意 |
|---|---|---|
| 处理器架构 | 主流 64 位系统先选 arm64；不确定时可选通用版。 | 处理器支持 64 位，不代表设备一定运行 64 位系统。 |
| 系统版本 | 以当前安装包的最低 Android 版本要求为准。 | 提示解析失败时，同时检查系统版本与包是否完整下载。 |
| 安装权限 | 通过系统安装器安装 APK。 | 仅对本次使用的文件管理器或浏览器按需授权，安装后可收回。 |
| 连接权限 | 首次启用连接时，系统可能显示 VPN 连接请求。 | 先确认请求来自刚安装的客户端；其他 VPN 类应用可能占用同一连接能力。 |
安装成功后，先导入一份已知有效的配置，再接受系统连接请求。若应用前台可用、锁屏后容易断开，检查电池优化、后台运行权限与系统省电策略；不要一开始就同时更改 Mux、DNS、路由和分应用代理，否则难以定位是哪项设置影响连接。
v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核，二者在协议扩展、安全层与配置格式上可能存在差异。尤其涉及 VLESS、REALITY 或定制传输参数时，应先核对服务端要求，再看当前客户端的实际支持情况，不能仅凭链接能导入就判断连接一定可用。
更新时若提示应用未安装，先记录完整错误，再检查旧应用签名、版本关系、设备架构和剩余空间。不要立刻卸载旧应用；卸载可能同时删除本地配置，应先完成导出或其他可靠的配置备份。
Linux 客户端
先按发行版选择 deb 或 rpm，再核对 x64 与 arm64 架构。
v2rayN
Linux · 图形桌面环境
清单标记7.24.1
系统与安装要求
| 检查项 | 选择依据 |
|---|---|
| 桌面环境 | v2rayN 是图形客户端，需要可用的图形桌面会话。 |
| 处理器架构 | amd64、x86_64 对应 x64；aarch64 对应 arm64。 |
| 包管理体系 | 按发行版使用 deb 或 rpm，不通过修改文件扩展名转换包格式。 |
| 系统依赖 | 以包管理器报告的依赖为准；软件包格式相同仍可能存在系统库版本差异。 |
下载后可通过发行版的软件安装器打开软件包，先查看应用信息和依赖提示再确认安装。若系统报告依赖无法满足，检查发行版版本与软件包构建目标，不要强行忽略依赖；尤其是较旧发行版，可能需要先更新受支持的系统环境。
架构别名容易造成误选：普通 Intel、AMD 64 位桌面通常对应 amd64 或 x86_64；64 位 ARM 设备常显示 aarch64。这里的 amd64 是架构名称，并非仅面向某一家处理器。可在桌面系统信息中查看处理器和操作系统架构。
安装完成后先以普通用户启动图形界面。不同桌面环境的系统代理设置入口可能不同，部分应用也不会自动读取系统代理。需要 TUN 时，应按客户端说明处理相关网络权限，而不是长期以高权限运行整个桌面会话。
安装之后
配置、升级与权限
先让基本连接可用，再逐项调整路由与 DNS。遇到问题时，保留错误提示比反复重装更有帮助。
首次安装：导入有效配置
客户端负责管理配置和调用内核，不附带可直接使用的服务器。准备好有效的订阅链接、单条分享链接或兼容配置文件后，再从客户端对应的导入入口操作。导入后检查服务器类型、传输方式、安全层及必要字段，避免把网页地址误当作订阅地址。
选择服务器后，桌面端先确认系统代理模式，Android 端确认系统连接授权。验证连接时使用普通网页请求，并对照客户端日志；单独一次延迟测试不能代表所有应用都已通过代理。
升级迁移：先保留现有设置
更新前保留订阅分组、自定义路由、DNS、监听端口和其他手工修改项。优先使用客户端自带的导出能力；配置中可能含访问凭据，导出文件应保存在受控位置，不要上传到公共页面。
关闭正在运行的旧版本后再安装，避免文件被占用。升级后先核对配置是否仍在、代理模式是否符合预期，再恢复开机启动或自动更新。跨客户端迁移时，先试用一条配置，确认字段兼容后再迁移整个列表。
客户端、内核与订阅的分工
Project V 生态中的图形客户端提供服务器列表、订阅管理和系统网络设置入口；内核负责实际处理代理协议与连接。V2Fly 与 Xray 属于相关但各有演进的内核项目，配置兼容性应以具体版本为准。客户端下载完成后，如果某种安全层或传输方式缺少选项，应先核对内核支持，而不是随意选择名字相近的协议。
订阅则是配置的分发方式，不是客户端安装包。订阅更新失败与程序安装失败属于不同问题：前者要检查地址有效性、请求错误和返回格式，后者要检查系统兼容性、架构与安装权限。需要了解 VMess、VLESS、Trojan、Shadowsocks 和 REALITY 的定位，可阅读协议与内核技术参考，再回到客户端选择匹配的配置类型。
下载相关问题
安装包常见问题
按界面、设备架构与错误发生阶段区分问题。
Windows 的 Desktop 与 WPF 应该选哪个？
首次使用可先选 Desktop，它采用新一代跨平台界面；习惯传统 Windows 操作方式时可选经典稳定的 WPF 界面。两者都是 v2rayN，安装包均面向 x64。切换前先导出配置，不要直接混用两版程序目录。
Android 的 arm64 与通用版有什么区别？
2015 年后的主流手机通常可先选 arm64，但最终仍以设备系统支持的 ABI 为准。通用版包含多种架构，适合无法确认架构或 arm64 包不兼容的情况；通用版不代表支持所有旧系统。
安装客户端后能直接连接吗？
客户端本身不提供服务器。安装后还需导入有效的订阅链接、分享链接或兼容配置，选择服务器并设置代理模式。订阅地址可能包含访问凭据，不要公开分享或粘贴到不明转换服务。
更新客户端前需要保留哪些内容？
先使用客户端的导出功能保留配置，并记录订阅分组、自定义路由、DNS 与本地监听设置。退出正在运行的客户端后再更新。跨界面或跨内核迁移时，不要假定所有配置字段都能直接沿用。
浏览器打不开下载或安装时报错怎么办？
先区分下载失败与安装失败。下载失败时记录浏览器提示并稍后重试；安装失败时检查系统版本、处理器架构、存储空间以及旧进程是否退出。遇到安全提示应阅读具体原因，不要通过关闭系统保护来绕过未知风险。
v2rayNG 与 v2flyNG 可以直接互换吗？
两者都是 Android 图形客户端，但 v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。常见分享链接可能都可导入，具体协议、安全层与配置字段仍取决于各自版本。使用 REALITY 等配置前，先确认目标客户端及内核支持情况。