v2rayN
首推Windows x64 安装入口。Desktop 为新一代跨平台 UI；WPF 为经典稳定版，保留熟悉的桌面操作布局。
V2Ray 客户端下载
v2rayN 桌面客户端，v2rayNG 与 v2flyNG Android 客户端。先选择系统，再核对处理器架构。
永久免费
代码开源
图形界面配置
平台选择
安装后的配置步骤 →
按系统选择安装包
Windows 安装准备
打开系统“设置 → 系统 → 系统信息”，查看系统类型，确认设备使用 x64 处理器。这里提供的是 x64 包，不能仅凭设备外观判断架构。先将下载的 ZIP 解压到可写目录，再运行其中的安装程序，不要直接在压缩包预览窗口内启动。
Desktop 与 WPF 的主要区别在界面技术和操作布局，不应把两者理解成不同连接线路。首次运行若出现运行环境提示，应按程序提示补齐对应依赖；若只是浏览器无法连接，先检查配置和代理状态，不要把所有连接问题归因于安装包。
| 检查项 | 安装前确认 |
|---|---|
| 系统与架构 | Windows x64；具体系统版本与运行环境以当前包提示为准。 |
| 目录权限 | 解压和安装位置可写，保留配置、日志及更新所需空间。 |
| 首次启动 | 普通代理配置通常不需要管理员权限；使用 TUN 时另行检查权限要求。 |
导入服务器后，在状态栏选择“自动配置系统代理”，让遵循系统代理的应用进入客户端。该选项不等于全局路由：请求进入后仍会按路由规则决定直连、代理或阻断。首次验证时先保持一种接入方式，避免同时改动系统代理、TUN 和自定义规则。
v2rayN
macOS先在苹果菜单中打开“关于本机”：显示 Apple 芯片型号时选 Apple Silicon，显示 Intel 处理器时选 Intel。
macOS 安装准备
下载与芯片对应的 DMG 后打开磁盘映像，将应用复制到“应用程序”目录，再从该目录启动。不要长期从临时挂载的磁盘映像运行，否则后续更新、路径权限和配置定位可能与预期不同。迁移到另一台设备时，重新检查目标设备芯片，不必沿用旧电脑的包类型。
如系统出现安全提示，先阅读提示内容，确认下载来源和所选文件，再按系统提供的应用授权流程处理。不要为了启动一个程序而整体关闭系统安全机制。启动成功之后，分别检查服务器配置、内核日志和系统代理，安装是否完成与连接是否成功是不同阶段。
| 检查项 | 安装前确认 |
|---|---|
| 处理器 | Apple Silicon 对应 arm64；Intel 对应 x64。 |
| 系统兼容性 | 以当前安装包的最低系统要求和启动提示为准。 |
| 网络设置 | 使用系统代理前，确认当前网络服务与已有代理设置。 |
如果此前使用过其他代理程序，先退出旧程序并检查残留的代理设置。结束使用时通过客户端清除系统代理，再正常退出；直接移除应用并不会保证系统中的代理地址同步恢复。浏览器正常而其他应用无法连接时，应确认该应用是否遵循系统代理。
v2rayNG
首推Android 图形客户端，采用 Xray 内核。2015 年后的主流手机通常选择 arm64，实际仍以设备支持的应用架构为准。
v2flyNG
备选 · V2Fly 内核适合需要 V2Fly 内核兼容性的配置。选择前先确认协议、传输方式及配置字段，不要把切换客户端作为所有故障的通用解法。
Android 安装与授权
打开 APK 时，系统可能要求允许当前浏览器或文件管理器安装应用。仅为本次使用的来源授予所需权限，完成后可回到系统设置调整。若安装失败，先看系统提示：架构不匹配、系统版本过低、存储不足和签名冲突，需要分别处理，重复下载同一个包通常不能解决这些问题。
| 检查项 | 安装前确认 |
|---|---|
| 设备架构 | 主流设备优先 arm64；不确定时选择通用版。 |
| 安装权限 | 允许当前文件来源安装应用，并留意系统兼容性提示。 |
| 连接权限 | 首次连接按系统提示授予 VPN 权限。 |
| 后台运行 | 频繁断开时检查电池优化、后台限制与其他 VPN 应用。 |
导入后先选择一个配置再连接。Android 通常通过系统 VPN 接口接管流量，同一用户环境下通常只能有一个活动 VPN 服务；其他使用 VPN 接口的工具可能造成冲突。连接建立后若只有部分应用异常，再检查应用分流规则，不要立即清空全部配置。
v2rayNG 与 v2flyNG 采用不同内核，不能假定所有新协议与扩展字段都能互换。例如配置涉及 REALITY 时，应先核对所选客户端与内核的支持情况。已有应用的更新包若签名不一致，先备份再决定迁移方式，不要直接卸载导致个人配置丢失。
v2rayN
Linux 桌面按发行版的软件包体系选择 deb 或 rpm。下方主入口为 x64，arm64 设备使用对应的小字入口。
Linux 包格式与桌面环境
包格式和处理器架构是两个独立条件：使用 deb 的系统也可能是 arm64，使用 rpm 的系统也可能是 x64。先在系统信息中确认发行版与架构，再选择对应文件。包名中的 amd64、x86_64 通常表示 x64，arm64、aarch64 表示 ARM 64 位架构。
通过发行版提供的软件安装器打开文件，并阅读依赖解析结果。仅扩展名相同不代表所有发行版都能安装，包所需的系统库版本和桌面组件仍需满足。依赖冲突时不要强制忽略，先确认当前系统是否与发布包兼容。
| 检查项 | 安装前确认 |
|---|---|
| 包管理体系 | 选择发行版适用的 deb 或 rpm，不混用安装方式。 |
| 处理器架构 | x64 对应 amd64、x86_64；arm64 对应 aarch64。 |
| 运行环境 | 需要图形桌面与当前包依赖，不作为纯终端服务部署包使用。 |
| 代理接入 | 确认桌面环境和目标应用如何读取代理设置。 |
不同桌面环境对系统代理的处理不完全相同，部分应用只读取自己的代理设置，终端程序也不一定自动继承桌面代理。出现“浏览器能用、其他程序不能用”时，先确认应用的接入方式，再检查路由。系统代理与 TUN 的权限和作用范围不同，应分别验证。
安装之后
按症状查看排查手册 →
导入配置与首次验证
订阅导入与服务器选择
在 v2rayN 的“订阅分组”中填写订阅地址并保存，再执行更新订阅；在 v2rayNG 中可从菜单导入剪贴板中的分享链接，或添加订阅设置后更新。入口名称可能随版本变化，但流程始终是保存来源、获取配置、选择活动服务器。
订阅更新失败时，先确认地址完整、有效且没有多余空格，再区分直连获取与通过代理获取。客户端尚未建立有效代理时，选择通过代理更新可能使问题绕回自身。不要反复删除分组，先记录错误提示再更换获取方式。
分享链接与原生 JSON 不是相同的导入格式。普通分享链接应从对应导入入口处理，完整 JSON 则要确认客户端和内核的兼容性。备份或向他人描述问题时，隐藏订阅地址、用户标识及认证信息。
接入应用与检查日志
桌面端选择活动服务器后，确认核心日志中已出现启动信息，再设置系统代理。Android 则在首次连接时完成 VPN 授权，并检查系统连接状态。先打开一个需要验证的网站，再观察日志中是否出现相应目标连接。
路由模式决定进入客户端的请求如何处理。“绕过大陆(Whitelist)”与“全局(Global)”不是开启系统代理的替代操作。如果日志没有目标请求，先查应用是否进入代理；如果已有请求但连接失败，再查服务器参数、网络可达性与 DNS。
完成一次基础验证后再添加自定义路由、应用分流或 TUN 设置。每次只更改一类选项，保留变更前的配置，便于根据日志判断哪项调整影响了结果。具体操作见使用指南。
安装包选择与更新问题
下载客户端后就能直接连接吗？
安装包提供客户端程序，不包含可直接使用的服务器配置。需要准备有权使用的订阅地址或分享链接，完成导入、选择服务器并启动连接，再检查系统代理或 Android VPN 授权。
Windows 桌面版与经典 WPF 版怎么选？
Desktop 使用新一代跨平台界面，适合新安装与跨桌面系统使用；WPF 是经典稳定版，适合习惯原有窗口和操作路径的用户。两者都需要正确的服务器配置，界面差异不代表连接质量差异。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但仍应以设备支持的应用架构为准。无法确认架构时可选择通用版；如果提示安装包不兼容，还应检查系统版本、剩余空间和已有应用签名。
更新客户端前需要保留哪些内容？
先备份订阅分组、个人服务器配置、自定义路由和重要设置，记录当前使用的应用及安装方式。配置可能包含私人订阅地址和认证信息，备份应保存在受控位置。更新后检查分组、活动服务器与路由模式。
安装完成但浏览器打不开网页，应该重新下载吗？
先查看日志确认内核启动，再检查服务器配置和系统代理。桌面端确认自动配置系统代理是否生效，Android 确认 VPN 授权与连接状态。程序能够正常启动时，优先按连接链路排查，而不是反复安装。
页面显示版本与安装包文件名不一致时看哪里？
版本文字和文件入口来自发布清单的不同字段，更新节奏可能不同。页面版本用于参考，具体包版本以下载文件名及安装后应用中的版本信息为准；不要通过修改下载地址中的数字猜测其他版本。