V2Ray 下载
客户端与安装包

Windows 客户端

v2rayN 提供 Desktop 与经典 WPF 两种界面。这两个入口面向 x64 系统，主要差别在界面技术与操作布局，不是两种不同的代理协议。首次安装可以按教程中出现的菜单选择界面，已有配置的用户则应先备份，再决定是否迁移。

Desktop 使用新一代跨平台 UI，适合同时使用多种桌面系统、希望保持相近操作习惯的用户；WPF 是经典稳定版，适合沿用既有 Windows 操作流程。两版对具体系统版本与运行环境的要求，应以当前安装程序提示为准。

压缩包安装顺序

1. 在“设置 → 系统 → 系统信息”核对系统类型，确认是 x64 系统。此处的两个入口不应被当作其他处理器架构的安装包。
2. 将下载的 ZIP 解压到可写目录，打开解压后的文件夹，再运行其中的安装程序。不要直接在压缩软件的预览窗口里启动。
3. 首次运行如提示缺少运行环境，记录提示中的组件名称与架构，按对应组件说明补齐；不要通过随意更换代理设置处理启动错误。

如果安全软件拦截文件，先核对文件来源与具体告警内容。遇到不明确的告警应暂停安装，而不是直接关闭全部防护。程序可以启动后，再处理订阅导入、系统代理和路由设置。

macOS 客户端

macOS 使用 v2rayN 的桌面界面，安装前最重要的是区分 Apple Silicon 与 Intel。打开苹果菜单中的“关于本机”，查看“芯片”或“处理器”一栏：Apple M 系列对应 Apple Silicon，Intel 处理器对应 Intel 安装包。不要仅凭设备名称判断。

两种 DMG 提供相同客户端的不同处理器构建。Apple Silicon 机器优先选择原生 arm64 包，Intel 机器选择 x64 包。架构匹配与连接协议是独立问题，更换安装包架构不能修复错误的订阅地址或服务器参数。

打开 DMG 后的处理

1. 挂载磁盘映像，按窗口指引把应用放入“应用程序”目录，再从该目录启动。安装完成后可推出磁盘映像。
2. 若系统阻止首次打开，先确认下载来源，再到“系统设置 → 隐私与安全性”查看对应提示，按系统提供的选项处理。
3. 首次设置系统代理或启用涉及网络接管的功能时，阅读权限说明，仅授予当前功能需要的权限。

安装错误与网络授权需要分开排查。“无法打开应用”通常发生在启动阶段；应用已启动但浏览器未走代理，则应检查系统代理模式及浏览器自身设置。不要为了处理单个应用提示而关闭整个系统的安全机制。

迁移旧配置时，先保留原有订阅与规则备份，再导入新安装的客户端。跨桌面系统迁移后还应检查路径类设置，例如本地规则文件的位置，避免沿用另一台机器的目录。

Android 客户端

Android 优先选择 v2rayNG，它使用 Xray 内核；需要 V2Fly 生态配置时，可考虑使用 v2flyNG。两款客户端是独立应用，菜单名称、配置能力与数据目录并不完全相同，不应把它们当作同一应用的两种外观。

2015 年后的主流手机通常优先选择 arm64 包，但部分设备可能搭载不同架构或运行不同位宽的系统，仍应以系统实际支持的 ABI 为准。无法确认时可选通用版；通用版覆盖多种架构，不代表连接更快，也不改变订阅本身的兼容性。

安装与首次连接

1. 保存 APK 后从下载管理器打开。系统如要求授权，针对当前使用的浏览器或文件管理器允许安装来源，完成后可收回该权限。
2. 启动客户端，通过“从剪贴板导入”添加单条链接，或进入“订阅分组设置”添加订阅地址并更新。
3. 选中配置后启动连接，阅读系统弹出的 VPN 连接请求。该授权用于客户端在本机处理流量，不表示配置已经成功连通。

遇到“应用未安装”，先检查存储空间、系统版本与架构，再排查已有应用的签名是否冲突。同名应用来自不同构建来源时可能无法覆盖安装；不要在未保存配置前直接卸载旧应用。

连接后若切到后台就中断，再检查电池优化与后台运行限制。排查时一次只调整一项，并记录调整结果。v2rayNG 与 v2flyNG 不宜同时启动网络接管，以免系统连接状态来回切换，影响判断。

Linux 客户端

Linux 使用 v2rayN 桌面客户端，先按发行版的包管理体系选择 deb 或 rpm，再确认处理器架构。Debian、Ubuntu 及相应衍生发行版通常选择 deb；Fedora、RHEL 系及相应衍生发行版通常选择 rpm。不要根据桌面主题或窗口外观判断包格式。

常见桌面电脑多为 x64，系统信息可能显示为 x86_64；部分开发板和桌面设备使用 arm64，系统可能显示为 aarch64。二者不能混用。卡片中的主入口是 x64，下方单独列出 arm64 对应包，安装前应再次核对。

用图形安装器处理依赖

1. 在系统设置的“关于”页面查看发行版、版本与处理器信息，再选择对应格式和架构。
2. 用发行版自带的软件安装器打开文件，阅读依赖与兼容性提示。包格式匹配不代表所有发行版版本都能安装。
3. 安装后从应用菜单启动 v2rayN。若使用系统代理模式，确认当前桌面会话允许修改代理设置，并分别检查需要联网的应用。

图形客户端需要可用的桌面会话。仅有命令行环境的机器，不应按本页的桌面安装流程处理。出现缺少动态库或依赖版本不满足时，应先核对发行版支持范围，而不是强制忽略依赖。

Linux 上不同应用对桌面系统代理设置的支持可能不同。浏览器能够连接，并不说明所有终端程序都已使用相同代理。安装完成后的验证应针对实际使用的应用逐一进行；路由与 DNS 的调整放在客户端正常启动之后。