客户端 / 安装包与架构
桌面选择 v2rayN，Android 选择 v2rayNG。
先选操作系统，再核对处理器架构与安装包格式。下方保留桌面界面版本、芯片类型和通用包的独立入口，下载后按对应系统完成安装。
v2rayN · x64 · Desktop / WPF
两个入口的主要区别是界面技术与交互布局，不应把 Desktop 与 WPF 当作不同的代理协议。订阅能否使用，还取决于节点参数、所选内核及传输设置是否匹配。第一次使用时先完成导入和基本连接，之后再调整路由、DNS 与快捷键。
下载完成后，先用系统解压功能把 ZIP 内容提取到可写目录，再打开解压后的安装程序，按界面提示完成安装。不要在压缩包预览窗口里直接运行。若提示缺少运行环境，依据提示中的组件名称处理；安装路径、所需环境和系统版本支持以实际安装程序说明为准。
从已有版本迁移时，先备份配置并退出原客户端。新界面不一定沿用旧版设置项的位置，导入后应重新检查服务器选择、监听端口与系统代理状态。测试期间只运行一个接管系统代理的客户端，避免旧进程占用端口或覆盖代理设置。
| 检查项 | 当前入口 | 操作位置或说明 |
|---|---|---|
| 操作系统 | Windows 桌面环境 | 打开“设置 → 系统 → 关于”，核对系统版本。 |
| 处理器架构 | x64 | 查看“系统类型”；本页两种 Windows 包均为 x64。 |
| 安装格式 | ZIP 内含安装程序 | 完整解压后运行，不要仅拖出单个依赖文件。 |
| 运行条件 | 可写目录与所需运行环境 | 按安装程序提示处理依赖；普通系统代理与 TUN 的权限要求不同。 |
v2rayN · Apple Silicon / Intel · DMG
芯片类型以系统信息为准，不按机型名称或购买年份推断。打开左上角苹果菜单，进入“关于本机”：若显示“芯片”及 Apple M 系列名称，选择 arm64；若显示“处理器”及 Intel 名称，选择 x64。使用匹配架构的安装包，便于减少额外兼容层带来的差异。
打开下载的 DMG，将应用拖入“应用程序”目录，再从该目录启动。不要长期从挂载的磁盘映像运行，否则更新路径和应用位置可能与预期不同。复制完成后可推出磁盘映像；更新已有应用前先退出正在运行的实例，并保留配置备份。
首次打开若遇到系统提示，应先确认文件来源和提示的具体原因，再到“系统设置 → 隐私与安全性”查看系统提供的处理选项。不要为单个应用全局关闭系统保护。允许启动后，先使用普通系统代理验证导入的配置，再根据实际需要设置其他代理模式。
| 检查项 | 选择依据 | 安装注意事项 |
|---|---|---|
| 芯片类型 | Apple Silicon / Intel | 苹果菜单 → 关于本机，按显示的芯片或处理器选择。 |
| 安装格式 | DMG | 挂载映像后复制到“应用程序”，再从本机目录启动。 |
| 系统兼容 | 以当前应用要求为准 | 核对本机 macOS 版本；无法启动时先看系统提示。 |
| 权限条件 | 应用启动与代理设置权限 | 按系统提示授权；额外网络接管模式可能需要更高权限。 |
先选 v2rayNG，再按配置需求考虑 v2flyNG。
v2rayNG 是采用 Xray 内核的 Android 图形客户端，适合在手机上管理订阅、导入配置和切换服务器。配置是否可用仍取决于具体协议与传输参数；导入成功只表示客户端能够读取条目，不等于远端服务器一定可连接。遇到协议兼容问题时，应先对照配置来源的说明。
下载 APK 后，从浏览器下载记录或文件管理器打开。系统如要求允许安装此来源的应用，只为当前使用的浏览器或文件管理器开启对应权限，完成安装后可按需要关闭。启动客户端并首次连接时，系统会弹出 VPN 连接请求；确认应用名称后再授权。
v2flyNG 采用 V2Fly 内核，可作为已有配置明确面向该内核时的备选。它与 v2rayNG 不是简单更换名称的同一应用，内核支持的功能及参数可能存在差异。特别是配置涉及特定内核扩展时，不要假设同一条分享链接能够在两款客户端中获得相同结果。
两款应用可分别保留配置，但连接前应停止另一款应用的 VPN 会话。Android 的活动 VPN 通道会影响网络接管结果，频繁交替启动可能使排查变得困难。若后台连接容易中断，先检查系统电池管理对当前客户端的限制，再确认是否有其他 VPN 类应用接管连接。
| 检查项 | 选择依据 | 操作说明 |
|---|---|---|
| 应用架构 | arm64 或通用版 | 处理器支持 64 位不一定代表系统允许安装所有 64 位应用。 |
| 安装格式 | APK | 允许当前来源安装；确认系统安装器的具体提示。 |
| 系统版本 | 以当前 APK 要求为准 | 打开“设置 → 关于手机”查看 Android 版本。 |
| 网络权限 | Android VPN 授权 | 首次连接确认系统请求；同一时间只保留需要的活动 VPN。 |
| 更新条件 | 包名、签名与版本关系匹配 | 提示无法覆盖安装时先备份，避免直接卸载导致配置丢失。 |
v2rayN · deb / rpm · x64 为主入口
Linux 需要同时核对架构与包管理体系。常见 Intel、AMD 64 位桌面处理器通常选择 x64，对应文件名中的 amd64 或 x86_64；64 位 ARM 环境选择 arm64，对应部分文件名中的 aarch64。名称不同不代表应用功能不同，而是安装包面向的处理器平台不同。
deb 与 rpm 由发行版的软件管理体系决定，不能仅通过修改扩展名转换。下载后使用系统软件安装器打开，先阅读架构、依赖与冲突提示，再确认安装。当前 rpm 文件名包含 el10 标记，不表示所有使用 rpm 的发行版都能直接安装；若基础库版本不满足，应停止安装并核对环境。
此处提供的是图形桌面客户端，不是面向纯终端服务器的部署包。安装完成后从应用菜单启动，先导入配置并检查本地监听，再设置桌面环境的代理。不同桌面环境和应用读取代理设置的方式可能不同；浏览器可用而其他程序不可用时，应分别检查程序是否遵循系统代理。
| 检查项 | 当前入口 | 安装前确认 |
|---|---|---|
| 运行环境 | Linux 图形桌面 | 需要可启动桌面应用的会话与相应运行依赖。 |
| 处理器架构 | x64 / arm64 | 在系统“关于”或硬件信息中核对架构。 |
| 包管理体系 | deb / rpm | 按发行版选择，不能仅修改扩展名。 |
| 依赖条件 | 以软件安装器结果为准 | rpm 带 el10 标记；核对发行版及基础库兼容性。 |
| 安装权限 | 系统软件安装权限 | 安装器可能要求认证；日常运行按所需代理模式授权。 |
安装之后
安装包解决应用安装，订阅与节点参数决定连接目标。按顺序检查，避免同时修改多个设置。
01 / 配置来源
客户端本身不提供服务器账户。先准备有权使用的订阅链接、分享链接或完整连接参数，再通过客户端的订阅管理、剪贴板导入等入口添加。订阅地址可能含有账户标识或访问凭据，复制时不要连同说明文字一起粘贴，也不要把完整地址发到公开讨论区。
导入后先检查分组是否出现、条目数量是否符合预期，再选择需要使用的服务器。订阅更新失败与服务器连接失败属于不同环节：前者先看链接、网络和格式，后者再检查协议、时间及传输配置。不要通过反复覆盖安装来处理订阅格式问题。
02 / 请求入口
桌面客户端中，系统代理决定应用是否把请求交给本地监听端口；路由模式决定进入客户端的请求走哪个出站。这是两个设置层级。先确认客户端处于运行状态，再选择自动配置系统代理；仅导入配置而不设置请求入口，浏览器不一定使用代理。
Android 在首次启动连接时需要系统 VPN 授权。若已有其他 VPN 应用工作，应先明确要保留哪一个连接。暂时不要同时叠加复杂的 DNS、应用分流与自定义规则；先用基础设置建立可验证的连接，再逐项增加需要的功能。
03 / 结果确认
打开常用网页，确认页面与域名解析是否正常，再查看客户端日志中的具体报错。某个应用无法访问时，先检查它是否读取系统代理，而不是立刻更换安装包。若所有应用都失败，则依次检查服务器选择、本地端口占用、设备时间与订阅参数。
准备停止使用时，桌面端先清除系统代理再退出客户端，避免应用继续访问已经关闭的本地端口。更新或迁移后也应重新检查代理状态。详细操作路径见使用指南；涉及 inbounds、routing 和 dns 的字段关系，可继续阅读JSON 配置手册。
下载与安装答疑
首次安装优先选择 Desktop 桌面版，它采用新一代跨平台界面。熟悉经典桌面操作方式、希望保留原有使用习惯时可选择 WPF 经典稳定版。两种入口均为 x64 包，切换界面版本前先备份配置，不要让两个实例同时接管系统代理。
打开苹果菜单中的“关于本机”。“芯片”显示 Apple M 系列时选择 Apple Silicon（arm64）；“处理器”显示 Intel 时选择 Intel（x64）。按实际芯片选择，不要只根据电脑购买年份判断。
arm64 包面向 64 位 ARM 设备，2015 年后的主流手机通常可优先选择。通用版包含多种架构支持，适合架构不确定或专用包不匹配的设备。较新的处理器也可能搭配不同位数的系统，最终应以设备实际支持的应用架构为准。
客户端提供配置管理与连接功能，安装包不附带可用的服务器配置。需要自行准备有权使用的订阅链接或节点参数，导入后选择服务器，再设置系统代理或授予 Android VPN 权限。订阅链接可能包含访问凭据，不应公开分享。
先记录当前客户端名称与配置存放位置，再使用客户端提供的备份或导出功能保存配置、订阅分组和自定义路由。关闭正在运行的客户端后更新，完成后检查订阅、监听端口与代理模式。不要仅为解决普通更新问题而先删除原配置。
先核对发行版包格式与处理器架构，再查看系统软件安装器给出的具体依赖名称。deb 与 rpm 不能仅改扩展名互换；同为 rpm 的发行版也可能具有不同的依赖版本。当前入口的 rpm 文件名带有 el10 标记，安装前应确认发行版环境满足该包要求。