v2rayN
首推两个入口均为 ZIP 压缩包。下载完成后先完整解压，再运行包内安装程序；不要在压缩软件的预览窗口中直接启动。界面版本不决定服务器连接质量，选择时主要看操作习惯和当前环境的兼容情况。
桌面客户端 / Android 客户端
V2Ray 客户端下载
先选系统，再选设备架构。
桌面使用 v2rayN，Android 首选 v2rayNG。客户端永久免费、代码开源；安装后需自行导入有权使用的订阅或配置。
DESKTOP / X64
Windows 客户端
同一客户端的两种界面，首次安装选择其中一种即可。
安装后先导入订阅，再启用系统代理
首次打开 v2rayN，服务器列表为空属于正常情况。在“订阅分组”中添加订阅地址，再执行“更新全部订阅(不通过代理)”。已有可用代理并且订阅地址需要通过代理访问时，再按实际网络条件选择更新方式。订阅更新成功后，选择要使用的服务器，再将“系统代理”设为“自动配置系统代理”。
如果浏览器仍无法访问目标站点，先确认浏览器是否遵循系统代理，再检查客户端日志。系统代理只影响读取这项设置的应用，不等于所有程序都已交给客户端。退出或更换客户端前，先清除原来的系统代理，避免系统继续指向已经关闭的本地端口。
DESKTOP / APPLE SILICON & INTEL
macOS 客户端
在“关于本机”确认芯片，不按电脑购买年份猜测架构。
v2rayN
推荐打开 DMG 后，将 v2rayN 拖入“应用程序”文件夹，再从该文件夹启动。不要长期从挂载的磁盘映像中运行；完成复制后可以推出磁盘映像。保留应用所在路径，也有助于后续更新和权限设置保持一致。
处理首次打开提示与代理权限
系统首次打开下载的应用时可能显示安全提示。先核实来源和文件是否下载完成，再根据提示前往“系统设置 → 隐私与安全性”处理被阻止的打开请求。不要通过关闭系统整体安全保护来绕过故障；若明确提示应用损坏，优先重新下载安装包并确认兼容性。
导入订阅并选择服务器后，再启用系统代理。若请求没有进入客户端，检查“系统设置 → 网络”中当前网络服务的代理配置，并确认没有另一个代理工具同时改写设置。初次排查先保持单一客户端运行，将系统代理和 TUN 分开测试，避免两套接管方式叠加后难以定位问题。平台完整步骤见macOS 安装配置指南。
ANDROID / ARM64 & UNIVERSAL
Android 客户端
先看 v2rayNG；已有 V2Fly 配置需求时，再考虑 v2flyNG。
v2rayNG
首推 · Xray 内核v2rayNG 采用 Xray 内核，适合大多数 Android 初次配置场景。安装后先添加订阅分组并更新订阅，再选择服务器启动连接。首次启动会出现系统 VPN 连接请求，这是客户端接管设备流量所需的授权，应在确认应用身份后再允许。
当前清单的版本文字与文件名不同步：上方显示发布清单值，APK 文件名为 2.3.11。实际安装版本请在客户端“关于”中确认。
v2flyNG
备选 · v2fly 内核v2flyNG 采用 v2fly 内核，适合需要沿用 V2Fly 配置的用户。两款 Android 客户端的内核能力并不完全相同，不能只因为订阅地址一样，就认定每种配置都能互换。切换前确认所需协议和传输方式，并先停止另一款客户端的 VPN 连接。
首次连接与后台运行
安装 APK 不会自动建立连接。导入订阅、更新服务器列表、选中服务器之后，才进入连接步骤。连接建立后可查看 Android 状态栏的 VPN 标识，但该标识只说明本地 VPN 服务已启动，不代表远端服务器一定可用。仍需打开目标站点，并结合运行日志验证请求是否成功。
如果锁屏后连接经常中断，检查系统对客户端的电池优化和后台活动限制。不同厂商的菜单名称可能不同，应只调整客户端相关项目，不必关闭全局省电管理。准备测试另一款客户端时，先断开当前连接，避免系统 VPN 被后启动的应用替换。更详细的操作见Android 安装与配置章节。
DESKTOP / DEB & RPM
Linux 客户端
先确认发行版包格式，再确认 x64 或 arm64 架构。
v2rayN
推荐ARM 设备安装包
使用发行版的软件安装器打开下载文件，并留意依赖解析结果。deb 和 rpm 是不同的软件包格式，不应通过修改扩展名互换。arm64、aarch64 通常指同一类 64 位 ARM 架构命名，amd64、x86_64 则对应常见的 x64 桌面处理器。
区分桌面代理与应用自己的代理设置
Linux 桌面环境的代理设置方式并不完全一致。导入订阅并启动服务器后，先用遵循桌面代理设置的浏览器验证；其他应用可能需要单独填写 HTTP 或 SOCKS 代理。应以客户端当前显示的监听地址和端口为准，不要直接套用其他系统教程中的端口。
初次安装优先确认普通代理路径可用，再考虑 TUN。TUN 涉及网络设备、路由和 DNS，权限或发行版差异都可能影响结果。若开启后出现网络异常，先关闭 TUN，恢复到可复现的基础配置，再逐项检查。完整操作路径见Linux 安装配置指南。
下载与配置
安装前后的检查顺序
安装包、订阅配置和本地代理是三个独立环节。按顺序确认，比反复重装更容易定位问题。
下载前：确认系统和架构
先在设备的系统信息中查看处理器类型，再选择对应安装包。操作系统名称相同，并不代表架构相同；笔记本、台式机和 ARM 设备也不能只按外观判断。架构不匹配通常表现为无法安装或无法启动，与订阅内容没有关系。
下载过程中保留浏览器任务记录，确认任务已经结束后再打开文件。若保存得到的是网页而不是预期的 ZIP、DMG、APK、deb 或 rpm，先检查下载任务与网络状态，不要仅修改扩展名继续安装。
更新前：备份配置和规则
记录订阅分组、当前使用的路由模式，以及自行修改的监听设置。有配置导出功能时优先使用客户端导出；配置可能包含订阅地址和访问凭据，应存放在自己控制的位置，不要直接作为排查截图公开发送。
退出旧客户端后再安装新包。更新完成先检查订阅是否保留，再检查路由和代理状态。跨平台迁移时优先重新导入订阅，再逐项恢复设置，不宜把整个旧数据目录直接覆盖到另一个系统。
连接后：验证请求与日志
先选择服务器，再启用所需的接管方式。桌面端通常先测试系统代理，Android 则确认系统 VPN 请求。连接按钮显示启动、状态栏出现标识，都只说明本地服务状态，还需要实际请求来确认远端连接。
浏览器无法访问时，分别检查订阅是否更新成功、应用是否使用代理、运行日志是否报错。端口占用、认证失败和连接超时属于不同问题；先根据日志缩小范围，再决定调整设置还是联系配置提供方。
Windows 桌面版和经典 WPF 版怎么选？
首次安装可选桌面版 Desktop，使用新一代跨平台界面。习惯经典 Windows 界面或需要延续原有操作流程时，可选经典 WPF 稳定版。两者都属于 v2rayN，初次使用只需安装其中一种，切换前先备份配置。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常选 arm64，但仍需以设备实际架构和系统支持为准。不确定架构，或 arm64 安装提示不兼容时，可尝试通用版。通用版包含多种架构组件，体积通常更大，并不代表连接速度更快。
下载客户端后能直接连接吗？
安装包只提供客户端程序，不包含订阅或服务器配置。需要准备有权使用的订阅地址或配置文件，导入后选择服务器，再按平台启用系统代理或 VPN 连接。连接失败时，应分别检查订阅内容、本地代理设置与运行日志。
macOS 提示无法打开应用时怎么办？
先确认下载包与芯片匹配，并将应用拖入“应用程序”。核实下载来源后，可按系统提示在“系统设置 → 隐私与安全性”中处理被阻止的打开请求。若提示应用损坏，应重新下载安装包并检查系统兼容性，不要直接关闭系统整体安全保护。
更新客户端会保留原来的订阅吗？
是否保留配置取决于安装方式、数据目录和新旧版本差异。更新前先备份客户端配置，并记录订阅分组与路由设置；退出旧程序后再更新。更换界面版本或跨系统迁移时，不要假定整个配置目录可以直接覆盖使用。
页面版本文字与安装包文件名不同，以哪个为准？
页面版本文字与各架构文件的发布信息可能不同步。判断实际安装版本时，以安装后的客户端“关于”信息为准；文件名用于区分下载包。若已有配置依赖特定版本，应先备份，并确认新包实际版本及配置兼容性后再替换。