CLIENT PACKAGES / 客户端安装包
v2rayN、v2rayNG 与 v2flyNG
按系统、架构与界面版本选择。
先确认设备信息，再选择安装包。连接参数与订阅需另行准备；首次使用可配合快速上手教程完成导入。
PACKAGE SELECTOR
下载入口按平台组织。切换标签后，查看该系统的客户端、架构说明与安装条件。
同一客户端，两种桌面界面。Desktop 是新一代跨平台 UI；WPF 是经典稳定版。以下两个入口均为 x64 安装包。
Desktop 采用 Avalonia 界面，适合需要在多个桌面系统之间保持相近操作习惯的用户。节点管理、订阅更新和设置入口围绕桌面工作流展开。教程中的菜单名称可能随界面版本调整，遇到位置不同的设置，应按功能名称查找，而不是只对照截图坐标。
WPF 版面向 Windows，保留经典的列表、菜单和设置窗口，适合已经熟悉这套界面的用户。选用哪种界面不代表连接协议更快；连接结果仍取决于内核支持、服务端参数和网络条件。切换界面版本前先导出配置，避免在两个实例中重复修改订阅。
| 检查项 | 选择依据 | 安装前操作 |
|---|---|---|
| 系统与处理器 | 本页两个包均为 x64；系统版本支持以对应发行说明为准。 | 在系统设置的“系统信息”或“关于”中查看系统类型。 |
| 运行环境 | 依赖要求可能随客户端发行调整。 | 如启动提示缺少运行环境，按提示安装匹配组件后重试。 |
| 目录与权限 | 普通代理使用与需要提升权限的功能应分别判断。 | 选择可正常读写的目录；需要虚拟网卡功能时再按提示授权。 |
若系统类型不是 x64，不要仅凭文件名中的 Windows 字样安装。先确认系统对该架构程序的支持情况；模拟运行能力与客户端功能兼容性是不同问题。
按芯片选择 DMG。Apple Silicon 对应 arm64，Intel 对应 x64；优先使用与本机架构一致的安装包。
从系统菜单打开“关于本机”，查看“芯片”或“处理器”一栏。显示 Apple 芯片型号时选择 Apple Silicon 包；显示 Intel 处理器时选择 Intel 包。不要根据设备外观或购买年份推断，同一外观的设备可能采用不同处理器，安装包也不能仅凭体积来区分。
打开 DMG 后按窗口提示将应用放入“应用程序”目录，再从该目录启动。首次打开若出现系统安全提示，先确认提示对象与下载来源，再按系统设置提供的流程处理。不要把关闭系统整体安全机制作为常规安装步骤，也不要长期从挂载的磁盘映像内运行应用。
导入配置后，先测试客户端内部的节点连接，再设置系统代理。应用请求是否进入客户端，还取决于应用是否遵循系统代理设置。需要虚拟网卡方式时，应单独阅读权限提示与相关教程，避免将安装成功直接等同于所有应用都已接入。
| 检查项 | 选择依据 | 安装前操作 |
|---|---|---|
| 芯片架构 | Apple Silicon 用 arm64；Intel 用 x64。 | 在“关于本机”中读取芯片或处理器信息。 |
| 系统兼容性 | 最低系统版本以该次发行要求为准。 | 记录当前系统版本；较旧系统先确认界面与依赖支持。 |
| 应用与授权 | 使用正常可写的应用目录；额外接管功能可能需要授权。 | 退出旧应用后更新，首次启动逐项阅读系统提示。 |
Android 优先选择 v2rayNG。2015 年后的主流手机通常选 arm64；不确定系统架构时，可选通用版。
当前入口文件：v2rayNG_2.3.11_arm64-v8a.apk。页面版本文字与文件名分开读取，安装后可在“关于”中确认实际版本。
arm64 包针对相应的应用运行架构，通用版包含更多架构组件。处理器具备 64 位能力，不一定代表系统允许运行所有 64 位应用；若出现不兼容提示，应再确认系统信息。通过浏览器或文件管理器安装时，仅为当前使用的来源授予安装权限，完成后可按个人安全设置收回。
导入可用配置、选择节点后，首次启动连接会出现系统 VPN 授权提示。这是客户端接收应用流量的系统入口，与节点账号不是同一类权限。已有其他 VPN 连接时应先处理冲突。若锁屏后连接中断，再检查电池优化和后台运行限制，不必先反复更换安装包。
适合明确需要 V2Fly 内核环境的配置。选择前先核对协议、传输与配置字段是否受当前版本支持。
v2flyNG 与 v2rayNG 界面概念相近，但内核家族及版本节奏不同。能够导入同一种分享链接，不代表所有扩展参数都能按相同方式运行。尤其是依赖特定内核能力的连接，应先查看配置提供方说明，再决定是否切换客户端。
需要比较两个客户端时，先备份原配置，再逐个测试，避免同时启动连接。订阅内容中若包含不受支持的字段，换成通用架构包也不会增加协议能力；架构解决安装兼容性，内核能力解决配置兼容性，两者应分开判断。
| 检查项 | 选择依据 | 安装前操作 |
|---|---|---|
| 应用运行架构 | 主流设备优先 arm64；无法确认时选 universal。 | 查看系统或设备规格，安装失败时记录完整提示。 |
| 系统版本 | 最低版本由具体客户端发行决定。 | 通用包不代表兼容所有旧系统，先确认发行要求。 |
| 系统授权 | 安装来源授权与 VPN 连接授权分别处理。 | 完成安装后导入配置，再确认连接所需的系统提示。 |
| 已有安装 | 覆盖更新需满足应用签名与版本条件。 | 遇到签名不一致提示，先备份再决定迁移方式。 |
先按发行版选择 deb 或 rpm，再确认处理器架构。主入口为 x64，arm64 安装包列在下方。
Debian、Ubuntu 及其相应衍生系统通常使用 deb；Fedora、openSUSE 等系统通常使用 rpm。相同格式并不保证适配所有发行版版本，仍需核对包依赖及构建目标。文件名中的 amd64、x86_64 都属于常见的 x64 架构标记，arm64 与 aarch64 则用于相应的 ARM 64 位环境。
在文件管理器中打开安装包，使用系统的软件安装器查看依赖和安装位置。若提示缺少依赖或版本冲突，应先阅读错误详情，确认发行版与软件源状态。不要仅为让安装器继续而强行忽略依赖；界面启动失败、托盘不可见和网络连接失败，也应分别排查。
这里提供的是图形桌面客户端，使用时需要可用的桌面会话。桌面环境对托盘和自动启动项的处理方式可能不同。安装完成后先从应用菜单启动，确认配置目录可以正常写入，再设置登录后自动启动；自动启动应用与自动连接节点并不是同一个选项。
| 检查项 | 选择依据 | 安装前操作 |
|---|---|---|
| 包管理体系 | 按发行版选择 deb 或 rpm。 | 在系统信息中确认发行版名称及版本。 |
| 处理器架构 | x64 对应 amd64 / x86_64；arm64 对应 aarch64。 | 查看系统硬件信息，不要把包格式当作架构。 |
| 桌面与依赖 | 需要桌面会话及当前发行所要求的图形依赖。 | 让系统安装器检查依赖，阅读冲突信息后处理。 |
首次使用时，准备有权使用的订阅地址或完整节点参数。已有客户端时，先通过界面的导出或备份功能保存当前配置，记录本地端口、内核选择、路由模式与自定义 DNS。只记录订阅地址并不能保存手动添加的节点和本地规则；切换界面版本时尤其需要把这几类信息分别保留。
订阅地址可能携带访问凭据，分享链接也可能包含连接身份。备份应放在访问受控的位置，排查问题时不要直接公开整份配置。截图若包含地址、标识或订阅参数，应先移除敏感内容，再保留与错误相关的字段。
客户端能打开，只说明程序已经启动。接下来在图形界面添加订阅或导入节点，确认列表出现预期条目，再选中准备使用的连接。订阅分组与当前活动节点不是同一概念；更新某个分组，也不一定会自动改变当前连接。若导入失败，先检查链接格式与客户端支持范围。
测试阶段一次只改变一项设置。先保留默认监听地址，确认选中节点的地址、端口、协议和传输参数完整，再进行连接测试。不要同时调整 DNS、嗅探、路由和本地端口，否则很难判断哪次修改改变了结果。
系统代理设置影响愿意遵循该设置的应用；内核路由负责分配已经进入客户端的请求。两者处在不同层。出现浏览器可用、其他应用未变化的情况，应先判断应用是否使用系统代理，而不是立即更换客户端。Android 则需同时确认 VPN 连接状态和应用范围设置。
如果需要查看路由、DNS 与入站的关系，可继续阅读 JSON 配置手册。手写配置前先确认客户端如何生成运行配置：图形界面的设置可能在启动时重新写入文件，直接修改临时生成内容不一定能持续生效。
DOWNLOAD NOTES
围绕安装包选择、版本信息与配置迁移的五项说明。
客户端负责读取配置、管理连接与转发流量。安装包不包含可直接使用的服务端连接信息。需要先准备有权使用的订阅地址或节点参数，导入后再选择节点、设置路由与应用代理入口。
Desktop 使用新一代跨平台界面，适合希望在不同桌面系统保持相近操作方式的用户。WPF 是经典稳定版，适合习惯传统 Windows 界面的用户。两者都需要与系统架构匹配，切换前应备份配置并避免同时监听相同端口。
2015 年后的主流手机通常优先选择 arm64，仍需确认系统具备对应的应用运行支持。无法确认架构或 arm64 包提示不兼容时，可选择通用版。通用版覆盖更多架构，但不能替代客户端对系统版本的要求。
版本文字与文件名来自清单的不同字段，可能在更新期间出现差异。应查看实际下载文件的名称，并在安装后通过客户端的“关于”页面确认实际版本；不要根据页面版本文字自行改写下载地址。
先使用客户端的导出或备份功能保留节点、订阅、路由和自定义设置，记录当前内核选择及本地端口。退出正在运行的客户端后再更新。恢复后先测试一个连接，再启用系统代理或其他流量接管方式，备份文件应按敏感信息保管。