CLIENT PACKAGES / 客户端安装
桌面端选 v2rayN，安卓端首选 v2rayNG。先选系统，再对照处理器架构下载，避免安装包与设备不匹配。
按设备选择
平台选择会保存在地址栏中，可复制当前页面链接。
两个入口均为 x64 压缩包，下载后先完整解压，再打开其中的安装程序。
新一代跨平台 UI，适合首次安装，以及希望在不同桌面系统中使用相近界面的用户。
下载桌面版 · x64v2rayN-Desktop-Setup-x64-7.24.1.zip
经典稳定版，使用传统 Windows 界面。熟悉原有菜单布局，或已有相关操作习惯时可选。
下载经典 WPF 版 · x64v2rayN-Setup-x64-7.24.1.zip
两版的主要区别是界面技术与布局，不代表同一服务器在其中一版必然更快。首次配置建议只运行其中一版，避免本地端口占用。
| 检查项 | 下载前确认 |
|---|---|
| 系统架构 | 本页提供 x64 包。在「设置 → 系统 → 系统信息」查看系统类型。 |
| 运行环境 | 以安装程序的系统与运行库提示为准；缺少组件时按提示补齐。 |
| 目录权限 | 保留可写的配置目录；压缩包不要直接在预览窗口里运行。 |
| 代理权限 | 普通系统代理与 Tun 的权限要求不同，先验证基础代理连接。 |
先把压缩包解压到独立目录，再运行安装程序。首次打开时，检查窗口能否正常显示，并留意运行环境提示。不要因为暂时没有服务器列表，就反复重装客户端；列表为空通常只是尚未导入配置。
在「订阅分组设置」中添加订阅地址，保存后执行「更新订阅(不通过代理)」。如果订阅服务明确要求经代理更新，再按实际情况调整。选择一条有效配置后，在「系统代理」里点「自动配置系统代理」，再用浏览器测试。
从经典 WPF 版换到桌面版前，先导出配置并记录路由模式。退出旧版后再打开新版，确认本地监听端口没有被其他程序占用。暂时不需要代理时，在退出客户端前清除系统代理，避免浏览器继续访问已停止的本地端口。
查看首次安装与初始设置 →打开系统菜单中的「关于本机」，按芯片或处理器名称选择 DMG。
「关于本机」显示 Apple 系列芯片时选此包，使用适配该芯片架构的原生应用。
下载 Apple Silicon 版v2rayN-macos-arm64.dmg
「关于本机」显示 Intel 处理器时选此包。不要只根据电脑外观或购买年份判断。
下载 Intel 版v2rayN-macos-64.dmg
下载后打开 DMG，将应用移入「应用程序」文件夹，再从该文件夹启动。完成复制后可以推出磁盘映像。
| 检查项 | 下载前确认 |
|---|---|
| 芯片类型 | Apple Silicon 对应 arm64；Intel 对应 x64。 |
| 系统兼容 | 以当前安装包的兼容提示为准；较旧系统需先确认能否运行。 |
| 安装位置 | 应用应复制到「应用程序」，不要长期从磁盘映像中运行。 |
| 系统授权 | 修改代理或启用 Tun 时，可能需要系统授权或管理员权限。 |
先完成应用复制，再启动客户端。系统出现安全提示时，先确认下载来源和提示内容；如需允许打开，可到「系统设置 → 隐私与安全性」查看对应选项。不要通过关闭整套系统安全机制来解决一个应用的启动问题。
打开后先导入有效订阅，确认服务器配置已经出现在列表中，再设置系统代理。桌面应用不一定都遵循系统代理，因此应先用浏览器验证基础连接；只有特定应用仍无法使用时，再检查它自己的代理设置或了解 Tun。
升级时先退出正在运行的旧应用，保留订阅与路由配置，再替换应用文件。如果更新后界面可以打开但网页无法访问，优先检查系统代理状态和本地端口，而不是立即更换协议。退出客户端后若网络异常，也应先检查系统代理是否仍指向本地地址。
查看桌面端配置步骤 →2015 年后的主流手机通常选 arm64；架构不明确时可选通用版，并以设备实际兼容性为准。
适合支持 64 位应用的主流安卓设备。优先按设备架构选择，而不是只看处理器宣传名称。
下载 v2rayNG · arm64v2rayNG_2.3.11_arm64-v8a.apk
覆盖更多处理器架构。设备信息不明确，或 arm64 包提示不兼容时，可尝试此入口。
下载 v2rayNG · 通用版v2rayNG_2.3.11_universal.apk
卡片版本信息与平台文件地址可能分别更新。下载文件名见入口下方，实际安装版本以客户端「关于」页面为准。
适合明确需要 v2fly 内核，且设备支持 64 位应用的用户。先确认订阅中的协议参数受支持。
下载 v2flyNG · arm64v2flyNG_1.10.31-fdroid_arm64-v8a.apk
为架构不明确的设备提供备选。安装包兼容设备，不等于它能解析所有订阅与协议组合。
下载 v2flyNG · 通用版v2flyNG_1.10.31-fdroid_universal.apk
v2rayNG 与 v2flyNG 使用不同内核生态。不要仅凭名称相似，就假定所有配置参数能够直接互换。
| 检查项 | 下载前确认 |
|---|---|
| 应用架构 | arm64 要求系统支持 64 位应用；不确定时考虑通用版。 |
| 安装权限 | 按系统提示，临时允许当前浏览器或文件管理器安装应用。 |
| 系统版本 | 以安装程序兼容提示为准；通用版不能解决系统版本过旧的问题。 |
| 连接授权 | 首次启动连接时确认系统 VPN 请求，避免与其他 VPN 应用同时接管连接。 |
安装后打开侧边菜单，进入「订阅分组设置」，添加名称与订阅地址，保存后返回主界面更新订阅。不同版本的菜单位置可能略有调整，重点是先保存分组，再更新内容；只粘贴地址却没有更新，服务器列表不会自动出现。
点选一条有效配置，再点连接按钮。系统出现 VPN 授权提示时，确认请求来自当前客户端。状态栏出现连接标记只说明系统通道已启动，仍需打开浏览器验证实际访问。导入报错时，先检查订阅地址是否完整、是否过期，再确认客户端能否识别其中的协议。
升级安装若提示签名冲突，不要立即卸载旧应用。先导出或备份配置，确认新旧安装来源与签名是否一致，再决定如何迁移。系统的省电策略也可能中断后台连接；只有确实遇到后台被停止时，再到应用电池设置中调整限制，并观察电量变化。
查看 v2rayNG 使用教程 →先确认发行版使用 deb 还是 rpm，再按 x64 或 arm64 选择。包格式与处理器架构需要同时匹配。
面向使用 deb 包管理的发行版。常见于 Debian、Ubuntu 及采用相同包格式的桌面系统。
下载 deb · x64v2rayn_7.24.1_amd64.deb
ARM 设备：下载 deb · arm64 ↗
面向使用 rpm 包管理的发行版。安装前仍需确认当前包与发行版的依赖环境兼容。
下载 rpm · x64v2rayN-7.24.1-1.el10.x86_64.rpm
ARM 设备：下载 rpm · arm64 ↗
文件名中的 amd64、x86_64 通常都指 x64；arm64、aarch64 指 ARM 64 位。不要通过重命名文件或更改扩展名转换安装包。
| 检查项 | 下载前确认 |
|---|---|
| 桌面环境 | 本页提供图形客户端，需要可用的桌面会话。 |
| 包格式 | 在系统信息或软件管理器中确认发行版与包管理类型。 |
| 处理器架构 | 普通 Intel、AMD 桌面设备通常选 x64；ARM 设备检查是否为 arm64。 |
| 依赖与权限 | 通过系统软件安装器查看依赖提示；系统代理和 Tun 的权限分开处理。 |
下载对应格式的文件后，用系统软件安装器打开，先阅读依赖与兼容提示，再确认安装。某些发行版虽然使用相同扩展名，基础库版本却不同；如果安装器提示依赖无法满足，应先确认兼容性，不要把忽略依赖当作常规安装方式。
从应用菜单启动 v2rayN，导入订阅并选择有效配置。Linux 桌面环境对系统代理的处理并不完全相同，某些应用还会使用自己的代理选项。浏览器可以连接而其他应用不能连接时，先检查目标应用是否遵循桌面系统代理，再考虑其他接管方式。
启用 Tun 前应理解额外权限与路由变更，避免同时运行多个接管网络的程序。升级前保留配置，关闭旧进程后再安装新包。若新版本无法启动，记录软件安装器或客户端给出的错误信息，区分是桌面依赖问题、权限问题还是配置问题。
查看内核兼容与协议参考 →安装完成之后
客户端是配置管理和连接工具，订阅则提供服务器参数。先检查订阅地址是否有效，更新后选定一条配置，再设置代理模式。不要在首次测试时同时修改订阅、路由、DNS 和内核；每次只调整一项，才能判断变化来自哪里。
系统代理只影响遵循该设置的应用。桌面端可从「自动配置系统代理」开始，Android 则需要确认系统 VPN 授权。浏览器验证成功后，再处理其他应用的接入方式。如果显示已连接却打不开网页，按系统代理、本地端口、路由、DNS、服务器可用性的顺序检查。
更新客户端前，备份订阅分组、自定义路由与手动添加的服务器配置。订阅地址可能包含个人访问凭据，不要直接放进公开截图或求助内容。需要描述问题时，保留错误文字和操作步骤，隐藏地址中的个人信息。
客户端界面与内核是不同层次。界面能保存某个选项，不代表当前内核一定支持该参数；更换客户端也不保证订阅自动兼容。涉及 VMess、VLESS、REALITY 等选型时，先对照协议与内核支持情况，再导入完整参数。
查看已连接却无法访问的排查清单 →下载常见问题
需要准备有效的订阅地址或完整的服务器配置。客户端负责读取配置与建立连接，安装包本身不附带可用服务器。在 v2rayN 里打开「订阅分组设置」并保存地址，再更新订阅；在 v2rayNG 里打开「订阅分组设置」，添加后更新当前分组。
首次安装可先选 Desktop 桌面版，它使用新一代跨平台界面。经典 WPF 版采用传统 Windows 界面，适合熟悉原有布局或需要经典稳定版的用户。两者都需要有效配置；切换前先导出配置并记录系统代理与路由设置，不要同时运行两个客户端接管同一代理端口。
2015 年后的主流手机通常优先选择 arm64，但仍应确认设备系统支持 64 位应用。架构不明确，或 arm64 提示无法安装时，可尝试通用版。通用版涵盖更多架构，包体通常更大；它不会因此自动改善连接表现。
卡片版本信息和各平台文件地址是分别维护的字段，更新节奏可能不同。下载前查看入口旁的文件名，安装后在客户端的「关于」页面确认实际版本。不要仅凭卡片数字判断某个平台包的版本，也不要手动修改下载地址中的数字。
先确认安装包对应当前系统与处理器架构。Windows 压缩包应完整解压后再运行安装程序；macOS 先把应用移入「应用程序」文件夹；Linux 检查包格式、架构和依赖提示；Android 检查安装权限及已有应用的签名冲突。保留错误提示，再到教程中按对应步骤排查。
不必把 Tun 作为首次连接的必选项。桌面端可先选择有效配置，再启用「自动配置系统代理」，用浏览器验证基础连接。只有目标应用不遵循系统代理时，再了解 Tun 的权限和路由影响。Android 首次连接会出现系统 VPN 授权提示，应确认后再继续。