v2rayN 首推
Windows · x64下载完成后先解压，再运行其中的安装程序。不要直接在压缩包预览窗口中启动。
客户端下载 / 安装包选择
V2Ray 客户端下载
先选操作系统，再选芯片架构。
桌面端使用 v2rayN，Android 首选 v2rayNG，已有 V2Fly 配置可选择 v2flyNG。安装完成后，还需要导入有效的订阅或连接参数。
平台与架构
安装包选择
平台标签会保留在页面地址中。下次打开同一地址，可回到对应平台。以下均为图形客户端入口，具体运行条件还需结合系统版本与安装器提示确认。
Windows 安装条件
| 检查项 | 选择与准备 |
|---|---|
| 系统架构 | 本页两个入口均为 x64。在“设置 → 系统 → 系统信息”中确认系统类型；不能把 x64 安装包当作所有架构的通用包。 |
| 系统与运行依赖 | 使用仍获得维护的 Windows，具体最低版本以安装器和所选界面框架要求为准。若提示缺少运行时，按安装器提示处理。 |
| 文件与目录 | 先将 ZIP 完整解压到可写目录，保留同包文件。避免从临时解压路径启动，也不要只复制一个可执行文件。 |
| 代理权限 | 普通系统代理与 Tun 模式的权限要求不同。先完成基本连接；需要虚拟网卡接管时，再检查管理员权限与驱动状态。 |
首次运行前，先退出其他正在接管系统代理的程序，避免两个客户端轮流改写代理地址。导入订阅后，确认列表中存在可用配置，再启用系统代理。系统代理并不等于全部应用都经过客户端，某些应用有独立的网络设置，应分别确认。
从旧版迁移时，先备份订阅分组、服务器配置与自定义规则。安装新界面后，检查监听端口、路由模式和开机启动选项，不要把旧目录直接覆盖到新目录来代替迁移。遇到启动错误，先看日志中的运行依赖或文件路径提示，再决定是否更换界面版本。
v2rayN
macOS · DMG打开“关于本机”，查看“芯片”或“处理器”一栏后再下载。
macOS 安装条件
| 检查项 | 选择与准备 |
|---|---|
| 芯片架构 | Apple M 系列选择 arm64，Intel 处理器选择 x64。信息可在系统菜单的“关于本机”中查看。 |
| 系统版本 | 确认当前系统满足所下载构建的运行要求。旧系统若出现无法启动或缺少系统组件，应先查看应用和系统的具体提示。 |
| 安装位置 | 打开 DMG，按窗口提示将应用放入“应用程序”目录。完成复制后从该目录启动，而不是长期在磁盘映像内运行。 |
| 网络权限 | 系统代理与 Tun 可能触发不同的授权流程。只授予当前功能需要的权限，授权后再检查网络设置是否生效。 |
首次打开应用时，如果系统要求确认来源，先核对正在打开的文件与下载的平台是否一致，再通过系统提供的安全设置入口处理。不要为了运行单个应用而整体关闭系统安全机制。若提示应用损坏或架构不兼容，也应先排除下载未完成、系统版本不满足或安装位置错误。
配置完成后，在客户端启用系统代理，并使用遵循系统代理设置的应用进行验证。若终端或某个应用仍无法连接，不一定是安装失败，可能是该应用没有读取系统代理。先区分应用范围，再决定是否需要 Tun，具体路由与 DNS 配置可继续查阅进阶配置手册。
v2rayNG 首推
Android · Xray 内核2015 年后的主流手机优先选 arm64；不确定系统支持的架构时，可选通用版。
v2rayNG 使用 Xray 内核，适合多数 Android 初次配置场景。涉及 VLESS、REALITY 或 XTLS Vision 时，仍需核对订阅提供的参数与当前内核支持情况，不能仅凭协议名称判断连接一定可用。
v2flyNG 备选
Android · V2Fly 内核已有 V2Fly 配置时考虑此项；架构选择方法与 v2rayNG 相同。
v2flyNG 使用 V2Fly 内核。相近的界面与导入方式不代表两种内核的扩展字段完全兼容，尤其不要把 Xray 专用参数直接套入。选择依据应是已有配置的实际要求，而不是同时安装更多客户端。
Android 安装条件
| 检查项 | 选择与准备 |
|---|---|
| 应用架构 | 支持 64 位应用的设备优先选择 arm64。处理器支持 64 位不一定代表系统支持，拿不准时可尝试通用版。 |
| 系统兼容 | 最低系统版本以安装器判断和应用实际要求为准。提示解析失败时，先确认 APK 下载完成，再核对系统与架构。 |
| 安装权限 | 按系统提示，为打开 APK 的浏览器或文件管理器临时允许安装应用。安装后可在设置中收回该来源的安装权限。 |
| 连接权限 | 启动连接时确认系统 VPN 授权。通常同一时间只运行一个 VPN 服务，连接前先关闭其他同类服务。 |
| 后台运行 | 若息屏后连接中断，检查电池优化、后台活动与自启动限制。只针对当前客户端调整，不必关闭所有系统节电功能。 |
Android 安装器出现签名冲突时，常见原因是已安装应用来自不同渠道。不要立即卸载旧版；先导出订阅与自定义设置，确认能够恢复，再处理安装来源差异。应用名称相近，也不代表两款客户端能够共享数据目录或覆盖更新。
导入订阅后，先手动选择配置，再启动连接。状态栏出现 VPN 标记只说明系统通道已建立，不代表远端连接和 DNS 都正常。应结合客户端日志与实际访问检查结果。切换网络后出现异常时，可先停止再启动连接，随后检查路由模式与后台限制。
v2rayN
Linux · 图形桌面Debian、Ubuntu 系通常选 deb；Fedora、RHEL 系通常选 rpm。具体兼容性仍以发行版依赖检查为准。
Linux 安装条件
| 检查项 | 选择与准备 |
|---|---|
| 发行版格式 | 根据系统软件安装器支持情况选择 deb 或 rpm。更改扩展名不能转换包格式，也不能解决依赖差异。 |
| 处理器架构 | 在系统信息中查看架构，x64 与 arm64 分别下载。虚拟机应以虚拟机内部的系统架构为准。 |
| 运行环境 | 需要图形桌面与构建所需的系统库。通过图形软件安装器查看依赖提示，不要强制忽略不满足的依赖。 |
| 系统代理 | 不同桌面环境的代理设置入口不同。确认目标应用是否读取桌面代理；需要单独配置的应用应在其设置中处理。 |
| Tun 权限 | 虚拟网卡、路由表与 DNS 接管通常涉及额外权限。先确认普通代理可用，再启用对应功能并检查日志。 |
下载后用发行版提供的图形软件安装器打开软件包，先阅读依赖与目标架构提示，再完成安装。升级时尽量保持相同包格式和安装渠道；混用多种安装方式可能留下重复启动项，也会让配置目录与更新路径难以判断。
客户端启动后，先检查监听端口与所选服务器，再配置桌面系统代理。浏览器可用而其他应用不可用时，应优先判断代理覆盖范围，而不是重复安装。若启用 Tun 后整机网络异常，先停止 Tun、恢复系统 DNS 与路由，再逐项检查权限、默认路由和解析设置。
安装到连接
下载后的配置顺序
安装客户端、导入配置、接管流量是三个独立环节。按顺序确认，能把安装问题与连接问题分开。
01 / 安装准备
保存现有配置
已经在使用客户端时，先记录订阅分组、路由模式、监听端口和自定义 DNS。订阅更新不一定能恢复本地手动修改的规则，单独保存必要设置更便于迁移。
覆盖安装前退出客户端，并停止系统代理或 VPN 连接。不要同时运行新旧版本进行比较，否则端口占用与代理覆盖可能让测试结果失去参考意义。
02 / 配置导入
导入订阅与参数
客户端是本机配置工具，连接服务需要另行准备。获得有效订阅后，在订阅分组中添加地址并更新；只有单条分享链接时，使用对应的导入功能，导入后检查协议与传输设置。
订阅地址可能携带身份凭据。排查问题时，不要将完整地址、账户信息或配置截图公开发布。列表为空时，先检查地址是否完整、是否过期以及更新日志的具体提示。
查看订阅导入步骤 →03 / 连接验证
检查代理覆盖范围
先选择一条配置，再启用所需网络模式。系统代理、路由分流与 Tun 分别影响流量进入客户端的方式、出站选择和接管范围，不应把这些开关当作同一个设置。
通过实际应用访问和客户端日志共同验证。应用能打开不等于所有流量都按预期分流；出现问题时，先回到简单配置确认连接，再逐项加入 DNS、路由和 Tun 设置。
查看进阶配置 →下载常见问题
版本与安装选择
先核对包名、平台和架构，再处理权限与配置。以下问题可直接展开查看。
Windows 桌面版与经典 WPF 版怎么选？
首次安装可先选择桌面版 Desktop，它采用新一代跨平台界面。经典 WPF 版保留 Windows 经典界面与稳定的操作习惯，适合已有使用经验的用户。两者都需要有效的连接配置；换版前先备份订阅分组、路由与参数设置，不要直接假定配置目录可以互换。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但最终以系统支持的应用架构为准。部分设备的处理器是 64 位，系统却只支持 32 位应用，此时可尝试通用版。若安装器提示解析失败或不兼容，先检查系统版本和架构，不要反复安装同一个不匹配的包。
v2rayNG 与 v2flyNG 有什么区别？
v2rayNG 使用 Xray 内核，作为 Android 首选；v2flyNG 使用 V2Fly 内核，适合作为已有 V2Fly 配置的备选。两者的协议支持与配置字段不能视为完全相同。涉及 REALITY 或 XTLS Vision 时，应确认客户端所用内核及连接参数的支持情况，不能只依据导入成功判断可用。
为什么卡片中的版本文字与文件名数字可能不同？
版本文字来自应用级清单，文件名来自具体安装包条目，两类信息的更新节奏可能不同。判断所选文件时，应同时核对客户端名称、平台与架构，不要仅凭数字重命名文件或改写地址。若需要确认已安装版本，可在客户端的关于页面查看实际版本信息。
安装客户端后可以直接连接吗？
还需要有效的订阅链接或连接参数。客户端负责读取配置、选择出站并处理本机流量，安装包不包含可直接使用的连接服务。导入后先选择一条有效配置，再设置系统代理或网络模式，并通过日志与实际应用访问确认连接。订阅链接可能包含访问凭据，不要公开分享。
更新安装前需要卸载旧版吗？
同一客户端、同一安装渠道通常先尝试正常更新，不必先卸载。更新前应备份配置，并退出正在运行的客户端。若安装器提示签名、架构或包格式冲突，先查明旧版来源与安装方式；直接卸载可能清除应用数据。切换客户端或界面版本时，建议分别保存配置并重新检查路由与权限。