v2rayN
桌面版采用新一代跨平台 UI，适合首次安装与希望保持不同桌面系统操作一致的用户。经典 WPF 版使用传统 Windows 界面，适合已经熟悉旧版菜单结构、托盘操作和设置路径的用户。
桌面版 Desktop
x64 · ZIP 内含安装程序 · 新一代跨平台界面
经典 WPF 版
x64 · ZIP 内含安装程序 · 传统 Windows 操作布局
选择建议：新安装优先使用桌面版；需要延续经典界面操作路径时选择 WPF 版。两种安装包不必同时安装。
PACKAGE SELECTOR
按平台选择客户端
先确定操作系统，再核对处理器架构与安装包格式。平台切换会同步到地址栏锚点，复制当前页面链接后可直接回到对应平台。
WINDOWS · X64
Windows 客户端
Windows 平台使用 v2rayN。桌面版与经典 WPF 版共享相同的主要配置流程，选择差异集中在界面技术、布局与操作习惯。
Windows 系统要求与安装流程
| 检查项 | 要求 | 说明 |
|---|---|---|
| 处理器架构 | x64 | 适用于常见的 64 位 Intel 与 AMD 电脑。 |
| 磁盘权限 | 可写目录 | 安装与更新期间需要向程序目录写入运行文件。 |
| 网络权限 | 允许本地监听 | 系统防火墙首次询问时，应按实际网络环境授予客户端运行所需权限。 |
- 下载并解压。 获取对应 ZIP 文件后完整解压，不要直接在压缩文件预览窗口中运行安装程序。
- 完成安装。 启动安装程序并选择可写入的位置。首次运行后先确认主窗口、日志窗口与系统托盘图标均可正常打开。
- 导入配置。 在订阅分组中添加有效地址并更新服务器列表，或从剪贴板导入单个服务器配置。
- 选择代理方式。 普通浏览器与支持系统代理的程序可先使用系统代理；需要接管更多应用流量时，再阅读文档后配置 TUN 模式。
client: v2rayN · packages: desktop / wpf · architecture: x64
MACOS · ARM64 / X64
macOS 客户端
macOS 平台使用 v2rayN，安装前必须查看设备芯片类型。M 系列设备选择 Apple Silicon，较早的 Intel 处理器设备选择 x64 安装包。
v2rayN
两个 DMG 安装包对应不同处理器架构，功能与配置入口一致。处理器架构选错时，应用可能无法启动或由系统转译运行，因此下载前应先在“关于本机”中确认芯片信息。
Apple Silicon 版
arm64 · DMG · 适用于 M 系列芯片设备
Intel 版
x64 · DMG · 适用于 Intel 处理器设备
芯片判断：系统信息显示 Apple M1、M2、M3 或后续 M 系列时选择 arm64；显示 Intel Core 系列时选择 x64。
macOS 系统要求与安装流程
| 检查项 | 要求 | 说明 |
|---|---|---|
| 芯片类型 | arm64 或 x64 | 必须与下载的 DMG 架构对应。 |
| 应用目录 | 具备写入权限 | 将应用拖入 Applications 目录后再启动，不要长期从挂载镜像内运行。 |
| 网络设置 | 允许修改代理 | 启用系统代理或虚拟网络模式时，系统可能要求确认管理权限。 |
- 核对芯片。 打开系统菜单中的“关于本机”，记录芯片或处理器字段，再选择 arm64 或 x64 安装包。
- 挂载 DMG。 打开下载文件，将 v2rayN 拖入应用程序目录。复制完成后弹出安装镜像。
- 首次启动。 从应用程序目录打开客户端，按系统提示确认启动与网络设置权限，然后检查菜单栏状态。
- 添加订阅。 填入订阅地址并执行更新，选择当前服务器后启用系统代理。若只有部分应用需要代理，可继续使用应用自身的代理设置。
client: v2rayN · packages: dmg · architectures: arm64 / x64
ANDROID · ARM64 / UNIVERSAL
Android 客户端
首选 v2rayNG，需要 V2Fly 内核路线时可选择 v2flyNG。两款客户端都提供 arm64 与通用安装包，2015 年后的主流手机通常优先选择 arm64。
v2rayNG
v2rayNG 是 Android 平台的主要选择，提供订阅更新、服务器切换、路由规则、分应用代理与 VPN 接管界面。首次下载通常选 arm64；只有架构无法确认或 arm64 包无法安装时，再使用通用版。
arm64 版
arm64-v8a · APK · 适用于多数近年 Android 手机
通用版
Universal · APK · 覆盖更多处理器架构
架构选择只影响安装包内包含的本机组件，不改变订阅格式、路由界面与日常连接流程。
v2flyNG
v2flyNG 使用 V2Fly 内核，适合明确需要该内核行为或已有对应配置的用户。应用的基本操作仍是导入配置、选择服务器、启动 VPN 接管并检查连接日志。若没有特定内核要求，优先使用上方 v2rayNG。
arm64 版
arm64-v8a · APK · 适用于多数 64 位 ARM 设备
通用版
Universal · APK · 用于架构不确定的设备
v2flyNG 是 Android 平台的备选客户端。已有配置若依赖特定功能，应先阅读服务提供方给出的协议与参数说明。
Android 系统要求与安装流程
| 检查项 | 要求 | 说明 |
|---|---|---|
| 处理器架构 | arm64 优先 | 多数 2015 年后发布的主流手机使用 arm64-v8a。 |
| 安装权限 | 允许当前来源 | 系统要求确认安装来源时，仅对当前使用的文件管理器或浏览器完成一次授权。 |
| VPN 权限 | 启动时确认 | 客户端通过 Android VPN 接口接管流量，首次连接会显示系统确认窗口。 |
- 选择客户端。 一般使用 v2rayNG；明确需要 V2Fly 内核行为时使用 v2flyNG。无需同时安装两款客户端。
- 确定架构。 主流设备先下载 arm64 版。如果系统报告安装包不兼容，再改用通用版，不要反复覆盖安装不同架构。
- 安装 APK。 打开下载文件，按系统提示允许当前来源安装。安装完成后可关闭该来源的临时安装权限。
- 导入并连接。 使用订阅地址、剪贴板内容或配置文件导入服务器，选中节点后点击连接，并确认系统显示的 VPN 权限请求。
- 检查后台限制。 若锁屏后连接频繁中断，应查看系统的电池优化与后台运行规则，允许客户端在连接期间保持运行。
clients: v2rayNG / v2flyNG · packages: apk · targets: arm64 / universal
LINUX · DEB / RPM
Linux 客户端
Linux 平台使用 v2rayN。先按发行版选择 deb 或 rpm，再按处理器选择 x64 或 arm64。普通台式机与笔记本通常是 x64，ARM 设备使用 arm64。
v2rayN
Debian、Ubuntu 及相关发行版通常使用 deb；Fedora、Rocky Linux、AlmaLinux 与 RHEL 系发行版通常使用 rpm。主按钮提供常见 x64 安装包，arm64 入口单独列在其后。
deb · x64
amd64 · Debian / Ubuntu 系
rpm · x64
x86_64 · Fedora / RHEL 系
发行版与包格式必须对应。处理器架构可通过系统设置查看，也可在终端执行 uname -m：常见输出 x86_64 对应 x64，aarch64 对应 arm64。
Linux 系统要求与安装流程
| 检查项 | 常见选择 | 说明 |
|---|---|---|
| 包管理体系 | deb 或 rpm | 按发行版原生包格式选择，不要只依据桌面环境判断。 |
| 处理器架构 | x64 或 arm64 | x86_64 选择 x64，aarch64 选择 arm64。 |
| 桌面会话 | 图形桌面 | v2rayN 是图形客户端，需要可用的桌面会话与托盘或窗口管理能力。 |
- 确认发行版。 查看系统设置或
/etc/os-release，判断当前系统属于 deb 还是 rpm 包管理体系。 - 确认架构。 执行
uname -m。普通 PC 常见为x86_64，ARM 设备常见为aarch64。 - 交给包管理器安装。 使用系统的软件安装器打开下载文件，或通过发行版对应的本地包安装命令完成依赖解析。
- 启动图形客户端。 从应用菜单打开 v2rayN，确认配置目录可写，再导入订阅并选择当前服务器。
- 配置桌面代理。 系统代理是否对全部应用生效取决于桌面环境与应用自身设置。遇到未接管的程序时，应分别检查桌面代理和应用代理选项。
client: v2rayN · packages: deb / rpm · architectures: x64 / arm64
BEFORE INSTALL
下载前的四项判断
同一客户端可能同时提供多种架构和安装格式。依次完成下面四项判断，可以减少安装后无法启动、系统提示不兼容或包管理器无法识别的问题。
先选操作系统
Windows、macOS 与 Linux 使用 v2rayN；Android 首选 v2rayNG，也可在明确需要 V2Fly 内核时使用 v2flyNG。不同系统的安装包格式不能交叉使用，即使文件名中包含相同的客户端名称，也应从对应平台面板下载。
再查处理器架构
x64 常见于 Intel 与 AMD 桌面电脑，arm64 常见于 M 系列 Mac、现代 Android 手机和部分 ARM Linux 设备。架构信息应以系统设置或系统命令显示为准，不要仅根据设备上市年份推断。
确认安装包格式
Windows 当前提供 ZIP 内含安装程序，macOS 使用 DMG，Android 使用 APK，Linux 使用 deb 或 rpm。Linux 的格式由发行版包管理体系决定；Android 的 arm64 与通用版则主要区别在包含的本机架构范围。
安装后再导入配置
安装客户端不会自动生成服务器。首次启动后，需要导入有效订阅或单个服务器配置，更新列表并选中当前节点，然后按应用范围选择系统代理、应用代理或 TUN 模式。操作顺序应保持清晰，便于发生问题时定位具体环节。
INSTALLATION NOTES
安装后的基础配置路径
下载只是第一步。不同平台的界面布局略有差异，但从配置来源到流量接管的基本链路保持一致。
SOURCE
添加订阅或单个配置
订阅地址用于批量维护服务器列表，单个链接或配置文件适合临时添加某一服务器。导入前应确认内容来源与使用范围，添加后执行一次更新，并检查列表是否出现协议、地址、端口与备注信息。
SELECT
选择当前服务器
订阅更新完成不等于已经切换服务器。需要在列表中选中目标节点，并确认客户端状态区显示的当前服务器已经改变。多订阅环境可先按分组或备注筛选，避免在相似名称之间误选。
ROUTE
决定流量接管范围
系统代理适合浏览器和遵循系统代理设置的桌面应用；Android 通过系统 VPN 接口接管流量；TUN 可覆盖更多不读取系统代理的程序，但会引入虚拟网络接口与额外路由规则，启用前应先了解现有网络环境。
OBSERVE
通过日志确认连接
连接后先观察客户端日志是否出现配置解析、端口占用、DNS 或握手错误。网页无法打开时，不要连续切换多个设置；应从当前服务器、系统代理、本地端口、DNS 与路由规则开始逐项排查。
DOWNLOAD FAQ
下载与安装常见问题
以下问题集中在版本选择、处理器架构、Linux 包格式与安装后的首次配置。
Windows 应该下载 v2rayN 桌面版还是经典 WPF 版？
初次安装可优先选择桌面版，它采用新一代跨平台界面，窗口结构在不同桌面系统上更统一。已经熟悉传统 Windows 操作布局，或需要延续既有菜单与托盘操作习惯时，可以选择经典 WPF 版。两者都是 v2rayN，主要区别在界面技术与交互布局，不需要同时安装。
macOS 如何判断应下载 Apple Silicon 还是 Intel 版本？
打开系统菜单中的“关于本机”，查看芯片或处理器字段。显示 M 系列芯片时选择 Apple Silicon 版；显示 Intel 处理器时选择 Intel 版。安装包架构需要与设备处理器一致。若设备由单位统一管理，还应确认应用安装权限与网络设置权限是否受管理策略限制。
Android 应选择 arm64 版还是通用版？
2015 年后发布的主流 Android 手机通常使用 64 位 ARM 处理器，可以先选择 arm64 版。设备架构无法确认、安装时提示不兼容，或使用较特殊的处理器环境时，再改用通用版。通用版覆盖范围更广，文件通常也会包含更多架构组件。
Linux 应下载 deb 还是 rpm 安装包？
Debian、Ubuntu 及其衍生发行版通常使用 deb；Fedora、Rocky Linux、AlmaLinux、RHEL 系发行版通常使用 rpm。选择格式后还要核对处理器架构，普通 PC 多为 x64，部分工作站、开发板与低功耗设备使用 arm64。无法确定时可查看发行版文档和 uname -m 输出。
安装完成后为什么还不能直接连接？
客户端安装包只提供图形界面与运行组件。首次启动后仍需导入有效订阅或服务器配置，选择可用节点，再根据需要启用系统代理或 TUN 模式。连接异常时应依次检查配置内容、系统时间、本地端口、DNS 与代理状态，避免同时修改多个选项导致断点难以判断。