CLIENT PACKAGES / 客户端安装包
桌面选择 v2rayN，Android 首选 v2rayNG。先确认系统与处理器架构，再选择对应安装格式。
SELECT YOUR SYSTEM
不同架构的安装包不能通用。
版本信息位于各客户端卡片内。
Windows 提供两种界面分支，下面均为 x64 安装包。首次使用可先选择桌面版；已经熟悉原有菜单和托盘操作的用户，可继续选择经典 WPF 版。两种界面都用于管理节点、订阅与路由，不必为了日常连接同时安装运行。
Desktop：新一代跨平台 UI，适合首次安装或希望在不同桌面系统间保持相近操作习惯的用户。
经典稳定版：保留 Windows 原有操作布局。已有配置迁移前，先备份订阅分组和自定义规则。
下载文件为 ZIP。先将压缩包完整解压到独立目录，再按包内安装程序提示操作；不要直接在压缩包预览窗口里运行程序。
| 检查项 | 选择依据 |
|---|---|
| 系统架构 | 本页提供 x64 包；在“设置 → 系统 → 系统信息”查看系统类型。 |
| 安装格式 | ZIP 压缩包，下载后先解压，再运行其中的安装程序。 |
| 运行环境 | 具体系统与运行库要求以所选安装程序提示为准。 |
| 权限 | 常规设置与 TUN 所需权限不同，按功能和系统提示授权。 |
出现运行库提示时，应先处理提示中明确指出的组件，不要把程序无法启动误判为节点连接问题。切换界面分支后，菜单位置可能变化，按设置名称查找即可。
macOS 使用 DMG 安装包，按芯片区分 Apple Silicon 与 Intel。下载前先打开系统菜单中的“关于本机”，读取“芯片”或“处理器”字段。电脑名称、屏幕尺寸与购买年份都不能替代架构信息。
arm64：适用于 Apple M 系列芯片。优先选择与芯片原生架构一致的安装包。
Intel：适用于“关于本机”中显示 Intel 处理器的设备，不按系统界面外观判断。
打开 DMG 后，按安装窗口提示将应用放入“应用程序”目录，再从该目录启动。更新前先退出正在运行的客户端，避免替换应用时出现文件占用。
| 检查项 | 选择依据 |
|---|---|
| Apple Silicon | “关于本机”显示 Apple M 系列芯片，选择 arm64。 |
| Intel | “关于本机”显示 Intel 处理器，选择 x64。 |
| 系统版本 | 以应用发行要求及系统安装提示为准，旧系统可能无法运行。 |
| 网络权限 | 系统代理与虚拟网络接口可能分别请求授权。 |
首次启动若出现系统安全提示，先确认应用来源与具体提示内容，再按系统提供的授权入口处理。不应为启动单个程序而关闭系统整体安全保护。
Android 首选 v2rayNG，它使用 Xray 内核；需要 V2Fly 内核环境时，可选 v2flyNG。2015 年后的主流手机通常先选 arm64；年份只是初步参考，部分设备架构或系统环境不同，无法确认时再选通用版。
适用于主流 arm64 设备。首次使用可先下载这一项，再按系统提示安装。
无法确定架构时的备选安装包。通用版并不代表可以绕过系统版本要求。
导入订阅后选择节点，首次启动连接时会出现系统 VPN 连接请求。确认请求来自当前安装的客户端，再按提示授权。
适用于需要 V2Fly 内核且设备使用 arm64 架构的用户。
架构不明确时可选择通用版，安装前仍需留意系统兼容提示。
不同内核的协议与传输支持可能不同。迁移配置前先核对节点使用的协议、传输与安全参数，不要仅根据订阅名称判断兼容性。
| 检查项 | 说明 | 遇到提示时 |
|---|---|---|
| arm64 / 通用版 | 主流手机先选 arm64，架构不明确时选通用版。 | “与设备不兼容”需同时检查架构与系统版本。 |
| 安装来源 | APK 由浏览器或文件管理器打开。 | 只为当前执行安装的应用授权，完成后可收回权限。 |
| 已有应用 | 覆盖安装受应用签名与版本关系约束。 | 签名冲突时先备份配置，确认发行渠道后再处理。 |
| 连接权限 | 客户端通过系统 VPN 接口接管所选流量。 | 其他 VPN 类应用可能占用同一连接位置，应先检查。 |
Linux 先区分发行版使用的包格式，再确认处理器架构。Debian、Ubuntu 系通常选择 deb；使用 RPM 包管理体系的发行版选择 rpm。相同包格式也不代表依赖完全相同，实际兼容性以发行版、软件包依赖和安装提示为准。
Debian / Ubuntu 系：适用于 x64 设备，由系统软件包安装工具处理。
RPM 包管理体系：选择前确认发行版和依赖要求，尤其注意系统库兼容提示。
安装完成后从桌面应用菜单启动。若包管理器提示缺少依赖，先处理对应依赖与发行版兼容问题，不要强行跳过安装检查。
| 检查项 | 选择依据 |
|---|---|
| 包格式 | 根据发行版的软件包管理体系选择 deb 或 rpm。 |
| x64 | amd64 与 x86_64 通常表示同一类 64 位架构。 |
| arm64 | arm64 与 aarch64 对应 ARM 64 位架构。 |
| 运行环境 | 需要适用的桌面图形环境及安装包要求的系统依赖。 |
| 权限 | 安装软件包与启用 TUN 可能需要额外系统授权。 |
桌面系统代理并不保证所有应用都会读取相同设置。浏览器、终端工具与后台服务应分别验证；涉及 TUN 时，另行核对虚拟网络接口、权限和路由设置。
INSTALL → IMPORT → CONNECT
安装包只负责部署客户端。配置、权限和连接验证分开完成，遇到问题时才能确定故障发生在哪一步。首次安装不必立即修改 DNS、自定义路由或 TUN 等进阶设置。
先核对文件格式和设备架构，保留系统弹出的具体提示。桌面端关闭旧客户端后再更新，Android 确认安装来源授权。已有配置的设备应先备份，尤其是手工维护的路由、订阅分组和本地监听设置。
客户端主窗口能够正常打开后，再进入订阅配置阶段。此时尚未连接网络属于正常状态。
从可信来源取得有权使用的订阅地址，在客户端中添加订阅或订阅分组，再执行更新。导入节点分享链接与导入订阅地址是不同操作，应使用对应入口。更新后检查分组是否有节点，再选定一个节点进行验证。
订阅地址常含访问令牌。不要把完整地址放进公开截图、日志或第三方转换页面。
桌面端先使用系统代理，Android 按系统请求授权连接。路由策略决定哪些连接直连、哪些使用代理；系统代理与 TUN 不是同一个开关。先验证目标应用，再按需要调整分流，避免同时修改多个变量。
退出客户端后若应用无法联网，检查系统代理是否恢复，并确认没有残留的手工代理设置。
DOWNLOAD FAQ
首次安装可先选 v2rayN 桌面版 Desktop，它采用新一代跨平台界面。经典 WPF 版保留 Windows 原有操作布局，适合已有使用习惯的用户。两者按界面和系统兼容情况选择，不需要同时运行；迁移前先备份配置。
打开系统菜单中的“关于本机”，查看芯片或处理器信息。显示 Apple M 系列芯片时选择 Apple Silicon arm64；显示 Intel 处理器时选择 Intel x64。不要按电脑购买年份或外观判断。
2015 年后的主流手机通常先选 arm64，但部分设备仍使用其他架构或较早的系统环境。若无法确认架构，或安装时提示不兼容，可选通用版；通用版也不能解决系统版本过低、签名冲突或存储空间不足的问题。
客户端负责管理配置与连接，不随安装包提供节点或订阅。需要自行准备有权使用的订阅地址或节点配置，完成导入和更新后再选择节点。分享截图或日志时应隐藏订阅地址中的令牌与节点认证信息。
先备份订阅分组、自定义路由及其他重要设置，再退出正在运行的客户端。同一应用且签名一致时通常可以按安装程序提示更新；跨发行渠道、切换界面分支或出现签名冲突时，应先确认迁移方法，不要直接删除旧版数据。
先核对操作系统、处理器架构和安装包格式，再检查系统提示、存储空间及安装权限。Windows 的 ZIP 需要先解压，macOS 使用对应芯片的 DMG，Android 检查安装来源授权与签名冲突，Linux 检查发行版包格式和依赖。记录具体错误后再排查，不要反复更改代理设置。