客户端安装包 / 平台与架构

V2Ray 客户端下载

桌面选择 v2rayN，安卓优先选择 v2rayNG。先确认操作系统，再选择处理器架构与安装包格式。

安装顺序：选择安装包 → 安装客户端 → 导入订阅 → 设置代理

首次使用？查看入门指南 →

桌面客户端 / x64

Windows 安装包

同一客户端提供两种界面。Desktop 桌面版采用新一代跨平台 UI；WPF 是经典稳定版，沿用 Windows 桌面操作布局。首次使用可先选 Desktop，已有 WPF 使用习惯时可继续选经典版。

安装前确认

Windows 系统要求与检查位置
项目要求与检查
系统优先在受支持的 Windows 10 / 11 环境使用；具体依赖以安装程序提示为准。
处理器本页两包均为 x64。在“设置 → 系统 → 系统信息”查看系统类型。
安装环境保留可写的配置位置；如提示缺少运行库，按对应版本安装说明处理。
权限常规系统代理与 TUN 所需权限不同；启用 TUN 前阅读权限提示。

不要直接在压缩包预览窗口中启动程序。先完整解压到独立文件夹，再运行安装程序；Desktop 与 WPF 使用不同目录，避免配置文件互相覆盖。安装完成后先导入订阅，再选择系统代理模式。

选择依据

先看架构，再看包格式

下载按钮的区别是运行环境，不是线路等级。正确的安装包应同时符合系统、处理器和客户端配置需求。

x64 与 ARM64

x64 常见于 Intel、AMD 桌面设备，安装包中也可能写作 amd64 或 x86_64；ARM64 也可能写作 aarch64 或 arm64-v8a。它们描述处理器指令集，不能只根据系统显示“64 位”就任意互换。尤其是 Android，处理器支持 64 位并不一定代表设备当前系统允许安装 64 位应用。

架构选错时，通常在安装或启动阶段就会报错，不需要反复修改订阅。先打开系统“关于”页面核对设备信息，再返回对应平台下载。通用 APK 的作用是覆盖多种架构，不会因此获得更好的网络表现。

客户端与配置兼容

v2rayN 面向桌面环境；v2rayNG 与 v2flyNG 面向 Android。v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核，协议与传输选项的具体支持随版本变化。不能仅凭订阅里出现 VMess、VLESS 或 Trojan，就断定所有扩展设置都能通用。

先查看配置提供方注明的客户端与版本要求。导入后若提示不支持的传输或字段，应核对兼容性，而不是只切换安装包架构。Project V、V2Fly 与 Xray 属于相关的开源技术生态；实际操作通过图形客户端完成，内核概念可在使用文档中继续了解。

安装后的操作顺序

订阅导入与代理设置

安装包只提供客户端程序。服务器地址、认证信息与订阅内容需要另外准备，客户端安装成功不等于连接已经建立。

01 / 安装与启动

先确认程序正常打开

完成安装后，从系统应用列表启动客户端。Windows 先完整解压安装包，macOS 先复制应用，Linux 先解决依赖，Android 先完成安装授权。若尚未进入主界面就退出，优先检查系统兼容、运行环境与文件权限，此时修改订阅地址通常没有帮助。

首次运行先保持默认监听设置。记录客户端使用的本地端口，确认没有其他代理程序占用相同端口，再进行导入。不要同时启动多个旧版窗口，以免误判当前正在运行的配置。

02 / 订阅与服务器

添加分组，再更新订阅

v2rayN 通常从“订阅分组设置”新增分组，填写别名与地址，保存后执行订阅更新。v2rayNG 从“订阅分组设置”添加地址，再回到主界面更新订阅。不同版本的入口措辞可能略有调整，操作目标仍是先保存地址，再拉取服务器列表。

单条分享链接与订阅地址不是同一种内容。复制链接后，应使用与格式对应的导入入口。更新完成后还要主动选择服务器；只看到列表并不表示客户端已经开始接管应用流量。

03 / 代理与验证

设置模式，再检查实际访问

桌面端先从系统代理模式入手，让遵循系统代理的应用使用本地入口。需要覆盖其他应用时，再阅读 TUN 的权限、路由与 DNS 配置要求。Android 点击连接后需确认系统 VPN 请求，同时检查是否有其他 VPN 服务正在运行。

验证时同时观察客户端日志和实际应用访问。延迟测试结果只是某一测试方式的反馈，不能代替完整访问验证。若浏览器正常而某个应用失败，先看该应用是否采用系统代理，再判断是否需要调整覆盖方式。

按步骤完成首次连接 → 对照桌面端与安卓端的订阅入口 →

配置保留与问题定位

更新前备份，失败时分类

将程序更新与订阅更新分开

客户端下载更新用于替换应用程序；订阅更新用于刷新分组中的服务器配置。两者相互独立。订阅失效、访问凭据变化或更新地址错误，通常不能通过重装客户端解决。先查看“订阅分组设置”中的地址，再根据日志判断是地址问题、网络请求失败，还是内容格式不受支持。

升级前停止连接并退出客户端，再使用应用支持的备份或导出功能保留必要设置。重点记录订阅分组、自定义路由、本地监听端口、DNS 和 TUN 状态。跨版本迁移时，先阅读设置变化，再决定导入哪些内容；不要将旧目录中的所有文件直接覆盖到新版本目录。

按发生阶段定位问题

下载未完成时，先检查浏览器下载记录、剩余空间和网络连接；安装失败时，检查系统版本、架构、包格式与旧版本签名；启动失败时，检查运行依赖和权限；能够启动但不能连接时，再检查订阅、服务器选择、系统代理、路由和 DNS。保留准确报错文字，比笼统描述“打不开”更容易找到对应处理路径。

从一个客户端切换到另一个客户端时，先退出旧程序并清理旧的系统代理状态。新客户端的本地端口可能不同，应用内手动填写的代理也需要同步调整。测试结束后，应确认只保留预期的代理或 VPN 服务，避免多个入口同时存在造成访问结果不一致。

遇到订阅问题可查看订阅更新失败排查；需要了解不同平台的权限和路由差异，可按全平台安装配置文档逐项核对。下载阶段不必提前修改所有高级设置，先完成最小可用配置，再逐项增加自定义规则。

下载常见问题

安装包选择与更新

Windows 桌面版和经典 WPF 版应该选哪个？

首次安装可先选 Desktop 桌面版，它采用新一代跨平台界面。习惯经典 Windows 操作布局的用户可选 WPF 经典稳定版。两者均需按各自版本确认运行环境，不要把两个安装包解压到同一目录。

Android 应该下载 arm64 还是通用版？

2015 年后的主流手机通常优先尝试 arm64，但仍应确认系统支持 64 位应用。设备架构不明或 arm64 包无法安装时可选通用版。通用版包含多种架构，文件通常更大，不代表连接速度更快。

安装包下载完成后，为什么还不能连接？

客户端不附带可直接使用的服务器配置。需要导入有权使用的订阅地址或分享链接，完成更新并选择服务器，再设置系统代理或启动 Android VPN 连接。最后通过日志与实际应用访问确认是否生效。

更新客户端前需要保留哪些配置？

先停止连接并退出旧客户端，通过客户端支持的备份或导出功能保存订阅分组、自定义路由和必要设置。备份包含敏感配置，应存放在受保护的位置。更新后核对监听端口、系统代理状态与路由模式，再恢复日常使用。

macOS 提示无法打开应用时怎么处理？

先确认下载包与芯片匹配，并将应用拖入“应用程序”文件夹。确认来源后，可在“系统设置”的“隐私与安全性”中查看是否提供“仍要打开”入口。若系统报告应用已损坏或含有风险，不要绕过警告，应重新下载并检查兼容性。

Linux 的 deb、rpm 和 arm64 包怎么对应？

先按发行版选择包格式：Debian、Ubuntu 系通常使用 deb，Fedora、RHEL 系通常使用 rpm；再确认处理器是 x86_64 还是 ARM64。包格式相同不代表所有发行版版本都兼容，仍需检查包管理器列出的依赖与系统库要求。