PLATFORM PACKAGES
平台切换会保留在地址栏锚点中。复制当前页面地址后，接收者可直接打开对应的平台面板。
Windows 提供 Desktop 与经典 WPF 两个界面版本。新安装环境优先选择 Desktop；已经熟悉传统 v2rayN 界面，或需要延续现有操作路径时选择 WPF。两个安装包均面向 x64 桌面设备。
v2rayN 是桌面端图形客户端。可管理订阅、分享链接、路由规则、系统代理与 TUN 模式。安装后先导入订阅，再选择活动配置并设置系统代理。
新一代跨平台 UI。适合首次安装和需要统一桌面界面的设备。
延续经典 Windows 操作方式。适合已有 WPF 使用习惯的设备。
| 检查项 | 建议 | 判断方法 |
|---|---|---|
| 处理器架构 | x64 | 打开“设置 → 系统 → 系统信息”，查看系统类型。 |
| 磁盘权限 | 使用可长期读写的目录 | 不要把运行目录放在临时文件夹；更新前先退出正在运行的客户端。 |
| 界面版本 | 新安装优先 Desktop | 依赖传统操作习惯时选择 WPF，否则使用 Desktop。 |
macOS 安装包按处理器分为 Apple Silicon 与 Intel。先打开“关于本机”，查看芯片或处理器字段，再下载对应 DMG。架构选错时通常无法正常启动，因此不要只按设备外观或购买年份判断。
macOS 版 v2rayN 使用桌面界面管理订阅、路由和连接状态。首次启动遇到系统安全提示时，应在系统设置的隐私与安全页面核对应用授权，再重新打开客户端。
适用于“关于本机”中芯片字段显示 Apple M 系列的设备。
适用于“关于本机”中处理器字段明确显示 Intel 的设备。
| 显示内容 | 下载版本 | 安装要点 |
|---|---|---|
| 芯片：Apple M 系列 | Apple Silicon | 下载 arm64 DMG，打开后按界面提示完成安装。 |
| 处理器：Intel | Intel x64 | 下载 x64 DMG，不要与 Apple Silicon 包混用。 |
| 首次启动被系统拦截 | 核对安全设置 | 打开系统设置中的隐私与安全页面，确认来源后重新启动。 |
常规配置先选 v2rayNG，再按处理器架构选择 arm64 或通用版。2015 年后的主流手机通常使用 arm64。无法确认架构，或 arm64 安装包提示不兼容时，再使用通用版。需要 V2Fly 内核体系时选择 v2flyNG。
v2rayNG 适合 Android 常规订阅与分享链接配置。可管理订阅分组、路由设置、VPN 模式、流量嗅探和域名策略。导入后应先检查配置格式，再启动连接。
2015 年后的主流 Android 手机优先选择。
架构不明确或 arm64 无法安装时使用。
v2flyNG 用于需要 V2Fly 内核体系的 Android 配置。选择前先确认现有订阅、分享链接与服务端参数是否与所需内核功能匹配。
适用于大多数近年 Android 手机。
无法确认架构时使用，安装包体积通常更大。
| 场景 | 建议客户端 | 建议安装包 |
|---|---|---|
| 常规订阅与分享链接 | v2rayNG | 主流手机先选 arm64。 |
| 现有配置要求 V2Fly 内核体系 | v2flyNG | 已知设备架构选 arm64，否则选通用版。 |
| 安装时提示架构不兼容 | 保持原客户端选择 | 改用对应客户端的通用版。 |
| 系统限制安装来源 | 核对安装权限 | 仅对当前下载流程临时授权，完成后复查系统设置。 |
Linux 安装包先按发行版家族选择 deb 或 rpm，再按处理器选择 x64 或 arm64。Debian、Ubuntu 及其衍生发行版通常使用 deb；Fedora、RHEL 系及其衍生发行版通常使用 rpm。
Linux 版 v2rayN 提供桌面图形界面。安装前应确认发行版的软件包格式、处理器架构与桌面环境。安装完成后，从应用菜单启动客户端，再导入订阅并检查系统代理设置。
| 系统环境 | 软件包 | 架构选择 |
|---|---|---|
| Debian、Ubuntu 及衍生发行版 | deb | 常见 PC 选 x64；系统显示 aarch64 或 arm64 时选 arm64。 |
| Fedora、RHEL 系及衍生发行版 | rpm | 常见 PC 选 x64；ARM 设备选择 arm64。 |
| 无法确认架构 | 先读取系统信息 | 终端执行 uname -m，x86_64 对应 x64，aarch64 对应 arm64。 |
| 安装后没有应用入口 | 刷新桌面会话 | 先重新登录桌面环境，再检查应用菜单与安装日志。 |
AFTER DOWNLOAD
安装、导入与连接分开处理。每一步完成后再进入下一步，便于定位权限、配置格式或路由设置问题。
先确认下载页面中的平台标签与当前设备一致。桌面端继续核对 x64、Apple Silicon 或 arm64；Linux 还要确认 deb 与 rpm。Android 主流设备通常使用 arm64，无法确认时再使用通用版。架构或格式不匹配会直接导致无法安装、无法启动或系统提示包不兼容。
Windows 解压后按安装包流程执行；macOS 打开 DMG 并根据系统提示完成授权；Android 安装 APK 时核对当前应用的安装来源权限；Linux 使用发行版对应的软件包工具安装。权限处理只针对当前客户端安装与运行所需范围，不要随意修改其他系统安全设置。
订阅地址应进入“订阅分组”或“订阅设置”，保存后执行更新。单条 vmess、vless 或 trojan 分享链接可使用剪贴板导入入口。导入完成后先检查配置名称、地址、端口、传输方式与 TLS 相关字段，不要直接假设所有条目都适用于当前网络环境。
先选择一条有效配置，再设置系统代理或 VPN 模式。需要按域名和 IP 分类处理流量时，使用路由规则；需要接管更多应用流量时，再阅读 TUN 模式说明。连接启动后查看客户端日志，确认配置加载、DNS 查询和出站建立过程没有报错。
PACKAGE REFERENCE
选择顺序固定为“平台 → 客户端 → 架构 → 包格式”。不要从版本号反推设备兼容性。
Windows、macOS 与 Linux 的图形客户端入口均为 v2rayN。不同平台的功能入口名称可能略有差异，但配置流程保持一致：添加订阅、更新分组、选择配置、设置路由、启动连接。Windows 还需在 Desktop 与经典 WPF 两种界面之间选择；macOS 和 Linux 则重点核对处理器架构与安装包格式。
v2rayNG 使用 Xray 内核，适合常见的 VMess、VLESS、Trojan 与 REALITY 配置管理。安装包分为 arm64 与通用版。主流手机优先 arm64，架构不明确或出现兼容提示时改用通用版。v2flyNG 是 V2Fly 内核体系的备选客户端，只有在配置要求明确时再切换。
更新客户端前先退出正在运行的程序，并记录订阅分组、路由规则和自定义 DNS 设置。桌面端不要把新旧程序目录混合覆盖；Android 更新前确认应用标识与现有安装一致。完成更新后先启动一次，检查内核状态和配置加载结果，再恢复系统代理或 VPN 模式。
DOWNLOAD FAQ
先按平台核对安装包，再处理权限和配置。以下答案与本页客户端清单保持一致。
优先选择 Desktop 版。它采用新一代跨平台界面，适合新安装环境。已有 WPF 使用习惯，或需要延续原有桌面操作方式时，可选择经典 WPF 版。两者都用于 Windows x64，不要同时运行两个版本，以免系统代理端口和配置目录互相影响。
打开系统菜单中的“关于本机”，查看芯片或处理器字段。显示 Apple M 系列芯片时下载 Apple Silicon 版；显示 Intel 处理器时下载 Intel 版。不要只按设备名称判断，同一产品系列可能存在不同处理器版本。
2015 年后的主流 Android 手机通常使用 arm64，可先下载 arm64 版。无法确认处理器架构，或安装时提示不兼容时，再改用通用版。通用版包含更多架构支持，适配范围更宽，但安装包通常也更大。
Android 常规配置优先使用 v2rayNG。需要使用 V2Fly 内核体系，或现有配置明确要求对应内核时，再选择 v2flyNG。客户端切换不会自动修正服务端参数，导入前仍需确认分享链接格式、传输方式和加密相关设置。
Debian、Ubuntu 及其衍生发行版选择 deb；Fedora、RHEL 系及其衍生发行版选择 rpm。随后执行 uname -m 确认架构：结果为 x86_64 时选 x64，结果为 aarch64 时选 arm64。不要通过修改扩展名转换软件包格式。
先打开客户端的订阅分组或订阅设置，添加服务提供方给出的订阅地址，再执行更新。随后选择配置、设置路由模式并启动连接。单条分享链接应使用剪贴板导入入口。订阅地址可能包含访问凭据，不要发布到公开页面或多人共享文档。