v2rayN
桌面版 Desktop 使用新一代跨平台 UI；经典 WPF 版沿用 Windows 界面，是熟悉传统操作流程时的稳定选择。两者都用于服务器配置、订阅分组与路由管理，按界面偏好选择一个即可。
CLIENT SHELF / DOWNLOAD
按系统与架构选择V2Ray 下载
客户端安装包
桌面端选择 v2rayN；Android 优先选择 v2rayNG。先确认处理器架构，再下载对应格式。
Windows 客户端
v2rayN / x64 / ZIP
首推
系统要求与安装顺序
| 项目 | 选择依据 | 操作建议 |
|---|---|---|
| 处理器 | 本页提供 x64 安装包 | 在设置 → 系统 → 系统信息中查看系统类型，不要只按设备名称判断。 |
| 系统与运行环境 | 以当前发行包要求为准 | 先安装系统更新；启动时若提示运行组件缺失，按提示补齐对应组件。 |
| 部署位置 | 本地可写目录 | 完整解压后再运行，不要直接在压缩包预览窗口中启动程序。 |
| 权限 | 普通配置与网络接管分开处理 | 先验证基础代理；TUN 或服务相关操作再按客户端提示提升权限。 |
下载完成后，将压缩包解压到固定目录，再查看目录内的安装程序或启动文件。压缩包格式不等于便携模式，实际部署方式应按包内内容执行。首次打开后先设置订阅分组，粘贴链接并更新订阅，再选中服务器。不要在导入配置之前反复切换系统代理，因为此时尚未建立可用的出站配置。
如果从旧版升级，先退出托盘中的客户端，再备份配置。Desktop 与 WPF 的界面和数据处理方式可能不同，迁移时优先使用客户端提供的导出与导入功能。系统代理开启后，通常只有遵循系统代理设置的应用会使用它；需要处理其他应用流量时，再阅读 Windows 安装配置章节。
macOS 客户端
v2rayN / ARM64 · X64 / DMG
v2rayN
打开 Apple 菜单中的“关于本机”。芯片显示 Apple M 系列时选 Apple Silicon；处理器显示 Intel 时选 Intel 包。以设备显示的信息为准，不按购买年份推断。
系统要求与首次运行
| 项目 | 选择依据 | 操作建议 |
|---|---|---|
| 芯片架构 | Apple Silicon 或 Intel | 查看“关于本机”中的芯片或处理器字段。 |
| 系统版本 | 当前发行包的最低要求 | 若系统提示应用不兼容，先检查系统版本与包架构。 |
| 安装位置 | 应用程序目录 | 打开 DMG 后按窗口指示部署，从应用程序目录启动。 |
| 网络权限 | 按使用模式授权 | 系统代理与 TUN 的权限需求不同，逐项阅读系统提示。 |
打开下载的磁盘映像，将应用放入应用程序目录后，再从该目录启动。不要长期从挂载的磁盘映像运行，否则更新、路径访问和配置保存可能与预期不一致。首次运行若受到系统安全策略限制，应先确认下载来源，再在“隐私与安全性”中检查相关提示；不要为启动单个应用而全局关闭安全机制。
导入订阅后，先选择服务器并查看客户端日志，再启用所需的代理模式。切换 Wi-Fi、扩展坞网卡或有线连接后，系统代理设置可能需要重新确认。停止使用时先清除客户端设置的系统代理，再退出程序，避免浏览器继续访问已停止监听的本地端口。详细步骤见 macOS 安装配置章节。
Android 客户端
v2rayNG · v2flyNG / APK
v2rayNG
Android 图形客户端，支持订阅导入、服务器选择与路由配置。2015 年后的主流手机通常优先选 arm64；设备架构不明或安装提示不兼容时，再考虑通用版。
v2flyNG
适合已有配置依赖 v2fly 内核行为的用户。选择前确认配置所需协议与传输功能；不要仅凭客户端名称判断配置能否直接迁移。
系统要求与安装授权
| 项目 | 选择依据 | 操作建议 |
|---|---|---|
| 应用架构 | arm64 或通用版 | 处理器支持 64 位不一定代表系统可运行 64 位应用，仍需确认系统支持情况。 |
| 系统版本 | 安装包声明的最低版本 | 安装器提示版本不兼容时，检查 Android 版本，不要反复安装同一文件。 |
| 安装权限 | 允许当前来源安装应用 | 只为当前使用的浏览器或文件管理器临时授权。 |
| 服务权限 | 系统 VPN 授权与后台运行 | 首次连接按提示授权；持续断连时检查电池优化及后台限制。 |
保存 APK 后，从浏览器下载记录或文件管理器打开。系统若询问是否允许该来源安装应用，只需授权当前安装来源；完成后可撤回此项权限。安装失败不一定是架构问题，也可能是存储空间不足、系统版本过低，或已安装应用与新包的签名不一致。先阅读安装器提示，再决定下一步。
首次运行后添加订阅，执行更新并选中一个服务器。启动代理服务时，Android 会显示 VPN 授权对话框，这是客户端接管流量所需的系统授权，不表示安装包附带了远端服务器。若设备已运行其他 VPN 服务，应先停止该服务再测试。锁屏后频繁断开时，检查后台运行、电池优化和厂商省电设置，参见 Android 安装配置章节。
Linux 客户端
v2rayN / DEB · RPM
v2rayN
Debian、Ubuntu 系通常选择 deb；Fedora、openSUSE 等使用 rpm 包管理体系的发行版通常选择 rpm。包格式相同不代表依赖完全一致，安装器报告的系统库要求仍需逐项满足。
系统要求与桌面集成
| 项目 | 选择依据 | 操作建议 |
|---|---|---|
| 系统架构 | x64 或 ARM64 | 查看系统信息；amd64、x86_64 对应 x64，aarch64 通常对应 ARM64。 |
| 安装格式 | deb 或 rpm | 选择发行版原生包格式，依赖兼容性以安装器检查结果为准。 |
| 运行环境 | 受支持的图形桌面与系统库 | 通过软件安装器检查依赖，先解决缺失项再启动应用。 |
| 代理权限 | 桌面代理设置或 TUN | GNOME、KDE 与应用对系统代理的遵循方式不同，需要单独验证。 |
下载与发行版、架构匹配的包后，优先用系统的软件安装器打开，以便同时检查依赖关系。若提示系统库版本不足，不要强制忽略依赖安装；先确认当前发行版是否满足该包要求。安装成功后，从应用菜单启动 v2rayN，并使用普通用户账户管理订阅和配置。
Linux 桌面代理设置并非所有程序都会读取。浏览器、桌面应用与终端程序可能各自采用不同的代理来源，因此客户端显示运行并不能证明全部应用流量已被接管。先用一个明确遵循代理设置的应用测试，再按需要处理环境变量或 TUN 权限。开机自启动也应在手动连接验证完成后配置，避免启动失败时难以定位原因。参见 Linux 安装配置章节。
INSTALL → IMPORT → VERIFY
下载后的配置顺序
安装、配置与连接验证分开处理。每一步只改变一类设置，日志更容易定位问题。
01 / INSTALL
完成安装与启动
检查系统、架构、磁盘空间与目录权限。能打开窗口后，先确认配置可以保存，再继续导入。启动报错应先处理运行环境，不要通过频繁更换订阅来排查程序本身的问题。
02 / IMPORT
导入订阅与选中服务器
将有权使用的订阅链接添加到分组，执行更新后查看服务器列表。订阅地址可能包含访问凭据，不要公开截图或转发。列表为空时，先查更新日志与链接格式，再检查订阅是否仍然有效。
03 / VERIFY
验证代理范围
选中服务器后启动服务，确认日志没有配置解析错误，再启用所需模式。先验证一个应用，随后检查路由与 DNS。排查时记录现象与错误信息，避免同时修改服务器、代理模式和解析设置。
DOWNLOAD / FAQ
安装包选择与下载问题
Windows 的 Desktop 与 WPF 应该选哪个？
Desktop 使用新一代跨平台界面，适合希望保持桌面平台操作习惯一致的用户；WPF 是经典稳定版，适合熟悉传统 Windows 界面的用户。本页两个入口均为 x64 包，安装前先确认系统类型。
Android 应选 arm64 还是通用版？
2015 年后的主流手机通常优先选 arm64，但仍应以设备支持的应用架构为准。设备架构不明或 arm64 安装包提示不兼容时，可选择通用版；通用版通常包含更多架构，因此文件可能更大。
安装客户端后为什么还没有节点？
安装包提供客户端程序，不附带可用订阅或服务器。需要自行准备有权使用的订阅链接或服务器配置，导入后执行更新订阅，再选择服务器并检查日志。
覆盖更新前需要保留哪些配置？
先通过客户端的导出或备份功能保留配置，记录订阅分组、路由、自定义 DNS 与监听端口，再退出客户端。不要假定不同界面版本或不同客户端的数据目录能够直接互换。
下载失败或浏览器没有开始保存怎么办？
先查看浏览器下载记录，确认磁盘空间与保存权限，再重试同一安装包入口。页面脚本读取版本清单失败时仍保留静态下载链接。若持续失败，记录失败时间、平台、包格式与浏览器提示后再排查网络或下载策略。
首次运行需要直接开启 TUN 模式吗？
建议先完成订阅导入与基础连接验证，再按应用需求选择系统代理或 TUN。桌面端 TUN 可能需要提升权限；Android 首次启动代理服务会请求系统 VPN 授权。切换前应暂停其他可能接管同一流量的网络工具。