安装包 / 系统与架构
桌面选择 v2rayN，安卓选择 v2rayNG 或 v2flyNG。先确认操作系统与处理器架构，再下载对应安装包。
客户端用于管理订阅、服务器和代理设置；可用的订阅链接或服务器参数需要另行准备。首次安装可同时打开使用指南，按步骤完成配置。
桌面版 Desktop 使用新一代跨平台 UI；经典 WPF 版保留熟悉的 Windows 桌面布局。首次安装可优先选桌面版，已有 WPF 使用习惯时可继续选择经典稳定版。
Desktop · 新一代跨平台界面
WPF · 经典 Windows 桌面布局
下载文件为 ZIP 压缩包。先完整解压，再运行包内安装程序；不要直接在压缩文件预览窗口中启动程序。
查看 v2rayN 安装与订阅导入 →| 检查项 | 选择与要求 | 确认方法 |
|---|---|---|
| 处理器架构 | 本区入口为 x64 包 | 打开“设置 → 系统 → 关于”，查看系统类型 |
| 系统兼容性 | 使用仍受支持的 Windows；具体最低版本以安装程序提示为准 | 确认系统更新状态，留意运行环境提示 |
| 解压与目录 | 完整解压，选择可写的本地目录 | 确认安装程序与附带文件在同一解压目录 |
| 运行权限 | 普通代理先按正常权限使用；TUN 可能需要额外权限 | 首次启动先测试系统代理，再按需设置 TUN |
“系统类型”比电脑型号更适合判断安装包。标注基于 x64 的处理器且运行 64 位系统时，选择本区 x64 包。其他架构的设备应先确认系统是否具备兼容运行能力，不要仅因为设备能打开下载页面就认定可以运行。这里的两个入口区别在界面方案，而不是把同一包按速度或节点能力分成两个档次。
运行安装程序前，先关闭正在使用的旧客户端。若启动时提示缺少运行环境，按提示确认所需组件与系统架构，避免随意复制其他电脑上的运行文件。安装目录中出现的多个程序和附带文件通常各有用途，保留安装包的完整结构；只把主程序拖到另一目录，可能造成组件无法找到。
首次进入 v2rayN 后，先导入订阅并选定一条服务器配置，再设置系统代理。Desktop 与 WPF 的菜单布局可能不同，教程中的操作应以设置项名称为线索，而不是只对照按钮位置。切换版本前备份订阅分组、路由和 DNS 设置，关闭旧程序后再打开另一版，避免两个程序同时修改系统代理。
在“关于本机”中查看芯片信息：显示 Apple M 系列芯片时选择 Apple Silicon，显示 Intel 处理器时选择 Intel。优先使用与芯片匹配的原生架构包。
适用于 Apple M 系列芯片
适用于 Intel 处理器
打开 DMG 后将应用复制到“应用程序”目录，再从该目录启动。升级前退出正在运行的 v2rayN。
查看桌面客户端配置步骤 →| 检查项 | 选择与要求 | 确认方法 |
|---|---|---|
| 芯片架构 | Apple Silicon 选 arm64；Intel 选 x64 | 苹果菜单 → 关于本机 |
| 系统版本 | 具体兼容范围以应用与系统提示为准 | 确认系统版本，使用仍受支持的系统 |
| 应用位置 | 复制到“应用程序”目录后启动 | 不要长期从挂载的 DMG 内运行 |
| 网络权限 | 按实际需要授权系统代理或虚拟网卡功能 | 查看系统设置中的权限提示 |
选择架构时不要只按购买年份判断，同一时期的设备可能采用不同芯片。复制应用完成后可以推出磁盘映像，保留下载文件以便在需要时重新安装。若系统阻止启动，先阅读完整提示，区分系统兼容性、应用来源限制和文件损坏，不建议为了运行单个应用而全局关闭系统安全保护。
客户端能够启动后，仍需导入服务器参数并选择代理模式。系统代理通常影响遵循系统代理设置的应用；TUN 涉及虚拟网卡和额外权限，不是安装后必须马上开启的选项。先用较简单的配置确认服务器可用，再参考TUN 模式说明扩展设置，排查时会更容易区分客户端与网络问题。
安卓端优先选择 v2rayNG，用于导入订阅、管理服务器和建立本机 VPN 连接。2015 年后的主流手机通常可选 arm64，但应以实际系统架构为准。
优先用于兼容的 64 位 ARM 系统
架构不明确时可考虑通用版
版本文字与具体包路径可能更新不同步，按实际文件名及安装后“关于”页面确认版本；不要手工改写下载地址。
查看 v2rayNG 使用教程 →
需要 V2Fly 内核家族的安卓图形客户端时，可选择 v2flyNG。选择之前先确认订阅中的协议与传输设置是否被当前版本支持，不要只按界面相似程度迁移配置。
适用于兼容的 64 位 ARM 系统
适合需要更多架构支持的设备
两款安卓客户端可分别管理配置，但连接测试时只启用其中一个 VPN，避免系统将前一个连接替换后产生误判。
了解内核家族与兼容性 →| 检查项 | 选择与要求 | 确认方法 |
|---|---|---|
| 系统架构 | 兼容的 64 位 ARM 系统选 arm64 | 查看设备规格与系统架构；不确定时考虑通用版 |
| 系统版本 | 以 APK 安装器显示的兼容要求为准 | 查看“设置 → 关于手机”与安装提示 |
| 安装授权 | 为实际打开 APK 的应用授权安装 | 按系统提示开启对应来源的安装权限 |
| 连接授权 | 首次连接需确认系统 VPN 请求 | 确认应用名称，再允许连接 |
| 后台运行 | 持续使用时检查电池优化与后台限制 | 在系统应用设置中按需调整 |
arm64 描述的是运行架构，不是软件的功能级别。处理器具备 64 位能力，但系统采用 32 位运行环境的设备，仍可能无法安装 arm64 包。通用版并不能绕过最低系统版本、签名冲突或安装策略限制；出现“应用未安装”时，先看安装器提示，再决定是否换包。
已有同名应用时，更新通常需要签名兼容。若系统提示冲突，先导出或备份原有配置，不要马上卸载。卸载可能清除订阅与自定义设置。首次连接时，系统 VPN 授权只是允许应用接管网络，并不说明远端服务器已连接成功；需要继续测试网页访问与日志。
先按发行版选择 deb 或 rpm，再匹配 x64 或 arm64 架构。下方主入口为 x64；ARM 桌面设备使用对应的 arm64 入口。
用于采用 deb 包体系的发行版
用于兼容该 rpm 包的发行版
使用系统软件安装器打开包，并查看依赖提示。包格式相同不代表所有发行版版本都兼容，尤其应留意 rpm 文件名中的目标发行环境信息。
查看桌面客户端上手说明 →| 检查项 | 选择与要求 | 确认方法 |
|---|---|---|
| 包格式 | 按发行版包管理体系选择 deb 或 rpm | 查看系统说明和软件安装器支持的格式 |
| 处理器架构 | amd64 / x86_64 对应 x64；aarch64 对应 arm64 | 查看系统“关于”中的硬件信息 |
| 桌面环境 | 需要可运行图形应用的桌面会话 | 本页面向桌面使用，不作为后台服务安装指南 |
| 依赖兼容 | 系统库和发行版版本需满足安装包要求 | 阅读软件安装器的依赖与冲突提示 |
| 代理生效 | 应用是否遵循系统代理取决于桌面与应用设置 | 先在一个明确使用代理的应用中测试 |
不要通过改扩展名把 deb 当作 rpm 使用，也不要仅因为系统允许打开文件就强制忽略依赖。安装器提示依赖版本不满足时，先确认包的目标环境；相同包格式内部仍可能依赖不同系统库。这里不提供固定最低发行版列表，因为兼容范围应以实际安装包和系统环境为准。
Linux 桌面上的系统代理并非所有程序都会读取。客户端启动、服务器选中、代理入口启用是三个不同环节，测试时应逐项确认。如果计划启用 TUN，再检查权限与路由变化，并记录启用前状态，便于退出后恢复。自定义路由和 DNS 可参考高级配置手册，不要把安装阶段和复杂网络设置混在一次操作中。
下载前可以按三个问题缩小选择范围：设备运行哪个系统，系统采用什么处理器架构，当前是否已有需要保留的客户端配置。操作系统决定平台入口，架构决定具体包，已有配置则决定是否先备份。把这三项确认清楚，比连续尝试多个文件更有效，也能减少更新后找不到原有订阅的问题。
x64、amd64 与 x86_64 在本页描述的是同一类 64 位桌面架构；arm64 与 aarch64 则属于 64 位 ARM 架构。它们不是节点协议，也不是连接速度等级。安装包必须与设备运行环境匹配。对于 Windows，本页提供的两个入口都是 x64，Desktop 与 WPF 的区别是界面方案，不应把 WPF 理解成面向另一种处理器的包。
Android 的通用版用于覆盖更多架构，不意味着一定比 arm64 更适合所有设备。支持 arm64 的手机通常可以直接选择对应包；旧设备、特殊系统或架构信息不明确时，再考虑通用版。macOS 应查看“关于本机”的芯片栏；Linux 应同时查看包格式和架构，两项都匹配后再继续安装。
v2rayN、v2rayNG、v2flyNG 是图形客户端，负责把服务器参数、订阅和代理选项组织成可操作的界面。内核负责处理实际连接，服务器则是远端连接目标。下载客户端并不等于获得服务器服务；即使安装完成，缺少有效参数时也无法通过客户端建立可用连接。这也是首次启动后仍然需要导入订阅的原因。
桌面用户通常先选 v2rayN；安卓用户可优先考虑采用 Xray 内核的 v2rayNG，有明确 V2Fly 内核需求时再考虑 v2flyNG。不同内核与版本的协议支持存在差别，尤其是订阅涉及特定传输或安全机制时，应核对参数兼容性。协议名称相同也不代表所有扩展字段都能直接照搬，相关定义可在术语手册中查看。
更新前先确认当前客户端是否工作正常，并记录目前使用的代理模式。优先使用客户端提供的备份或导出功能，保存订阅分组、手动添加的服务器、自定义路由和 DNS 设置。不同版本的配置存储方式可能变化，不能把“同一个产品名”当作覆盖安装一定保留数据的保证。
备份后退出客户端，再运行新安装包。桌面端关闭窗口不一定等于退出，部分程序仍在托盘运行；应从客户端退出入口结束运行。安卓端先断开 VPN，再按系统提示更新。完成更新后检查版本与配置，选择一条已知可用的服务器做测试，确认后再恢复其他高级设置。
从 Desktop 切换到 WPF，或从一款安卓客户端切换到另一款时，应把它当作一次配置迁移。先检查目标客户端能否导入原配置格式，再检查协议、路由和 DNS 字段是否完整保留。订阅可以重新导入，但手动调整的分组和本地规则未必会随订阅一起恢复，所以备份与记录都很重要。
页面中的版本文字与下载入口分别来自版本清单的不同字段，二者可能短暂不同步。具体安装包文件名与安装后的“关于”页面更适合确认实际版本。不要根据一个版本数字自行拼接新的文件名，也不要反复安装不同包来试图让文字一致；先保留当前可用配置，再判断是否有必要更新。
如果更新后连接异常，先回看更新前后的设置差异。系统代理状态、当前服务器、路由模式与 DNS 是较容易发生变化的项目。一次只调整一项，测试后记录结果；同时改变内核、DNS、TUN 和服务器参数，会使排查失去明确的起点。更详细的设置方法见订阅管理与高级配置。
先区分“文件下载失败”“程序安装失败”和“安装成功但连接失败”。下载失败发生在浏览器获取文件时；安装失败通常涉及架构、系统版本、权限或包依赖；连接失败则要看服务器参数和代理状态。三个阶段的问题来源不同，不宜都用重新下载来处理。
确认浏览器已结束下载，而不是仍有临时文件。ZIP 先解压，DMG 用系统磁盘映像工具打开，APK 交由系统安装器处理，deb 和 rpm 使用适合发行版的软件安装器。文件类型决定打开方式；把扩展名改成另一种格式不会改变内容。若浏览器明确显示下载失败，重新使用对应入口获取文件。
完整记录安装器的提示，先核对架构和系统版本。Android 应区分架构不匹配、签名冲突和安装权限限制；Linux 应区分包格式与依赖版本问题；桌面端还应留意运行环境提示。不要为了绕过提示而删除旧配置或强制忽略依赖，先确定错误所属环节再处理。
先确认设备本身能够正常联网，系统时间正确，订阅没有失效，再检查当前选中的服务器和代理模式。安卓端确认 VPN 连接未被另一款应用替换；桌面端确认需要使用代理的应用确实读取了系统代理。日志中的错误时间与具体请求对应起来，通常比只看一个连接图标更有帮助。
如果客户端能稳定打开，订阅能更新，但某个服务器始终超时，应优先检查该条配置与服务端状态。若只有部分应用异常，应关注应用代理设置、路由和 DNS，而不是马上更换安装包。可继续阅读帮助中心，按症状查找下一步处理方法。
还需要由服务提供方给出的订阅链接或服务器配置。安装包提供图形界面和运行组件，不会自动生成可用服务器。先完成安装，再按使用指南导入配置、选择服务器并启用合适的代理模式。
首次安装可优先选择 Desktop 桌面版，它采用新一代跨平台界面；习惯经典 Windows 布局的用户可选择 WPF 版。两者都用于管理服务器与订阅，菜单位置和界面交互可能不同。先备份配置，不要在测试时同时启用两个客户端的系统代理。
arm64 包面向兼容的 64 位 ARM 系统，2015 年后的主流手机通常可优先选择，但仍应以设备实际系统架构为准。通用版包含更多架构支持，适合架构不明确或需要兼顾不同设备的情况。处理器支持 64 位不一定代表系统也是 64 位。
版本文字与具体安装包路径是分别维护的信息，可能出现更新不同步。以所选入口的实际文件名和安装后的客户端关于页面确认版本，不要根据版本文字手工改写下载地址。更新前先备份配置；有疑问时保留当前可用版本。
是否保留取决于客户端版本、安装方式和配置存储位置，不能只凭覆盖安装作保证。更新前使用客户端可用的备份或导出功能，记录订阅分组、路由、DNS 与代理模式；更新后逐项检查，先测试一个已知可用的服务器。
通常先检查本机网络、系统时间、服务器参数、系统代理或 VPN 状态以及客户端日志。安装成功只说明程序可运行，不代表服务器可连接。仅当出现安装失败、文件缺失或启动错误时，再考虑重新下载对应安装包。