v2rayN
两版主要区别是界面技术与布局，不应仅凭界面选择协议。连接是否可用仍取决于配置参数和所用内核。已有配置时，先做备份，再测试切换，不要直接覆盖另一版的整个配置目录。
客户端安装包 · 按系统选择
V2Ray 下载
V2Ray 下载
客户端与安装说明
桌面端选择 v2rayN，安卓端优先选择 v2rayNG。先确认操作系统，再核对处理器架构。
免费使用
代码开源
图形界面配置
桌面端 / x64
Windows 客户端
首次安装先看 Desktop 版；习惯原有 Windows 界面的用户可选经典 WPF 版。两个入口都属于 v2rayN。
系统要求与安装顺序
| 检查项 | 选择依据 | 安装时注意 |
|---|---|---|
| 处理器架构 | 64 位 Intel / AMD 系统选择本页 x64 包 | 在“设置 → 系统 → 系统信息”查看系统类型；不要只看处理器品牌 |
| 系统版本 | 建议使用仍受支持的 Windows 10 / 11 | 具体最低要求以所选版本的安装提示为准，旧系统可能无法运行 |
| 运行环境 | 若启动提示缺少 .NET，按客户端提示选择桌面运行库 | 运行库的架构应与客户端一致；并非只装通用运行时就能满足要求 |
| 目录与权限 | 程序及配置目录需允许当前用户读写 | 先在本地目录解压，不要直接在压缩文件预览窗口里运行 |
- 完成解压。下载文件为 ZIP，先将其中内容完整解压到本地目录，再运行包内安装程序。保留同目录所需文件，避免仅拖出一个可执行文件后启动。
- 按提示安装并启动。如果出现运行环境提示，先确认缺少的组件名称及架构。普通订阅管理和系统代理设置通常不需要长期以管理员身份运行；TUN 功能的权限要求应单独处理。
- 再导入配置。启动后先添加订阅分组、粘贴地址并更新订阅。选择一个已有授权的配置后，再启用系统代理，避免程序尚未就绪时就修改系统设置。
若旧版本仍在托盘运行，先退出旧进程再启动新版本。两套程序同时监听相同本地端口，可能出现启动失败或应用连接到旧进程的情况。遇到闪退时，优先检查运行环境、目录写入权限和配置兼容性，处理顺序见故障排查。
桌面端 / 按芯片选择
macOS 客户端
打开苹果菜单中的“关于本机”，查看“芯片”或“处理器”。Apple M 系列选 arm64，Intel 选 x64。
v2rayN
不要根据电脑购买年份推断架构，同一时期可能存在不同芯片机型。即使系统能够转译运行其他架构的程序，也建议先选与本机芯片匹配的安装包，减少额外依赖。
系统要求与首次打开
| 检查项 | 选择依据 | 安装时注意 |
|---|---|---|
| 芯片类型 | Apple M 系列对应 arm64；Intel 对应 x64 | 以“关于本机”的实际显示为准 |
| 系统兼容性 | 系统需满足当前构建的最低版本要求 | 若提示系统版本不适用，先核对兼容性，不要反复换架构尝试 |
| 安装位置 | 将应用放入“应用程序”目录 | 不要长期从挂载的 DMG 映像中启动 |
| 网络权限 | 系统代理与 TUN 的权限范围不同 | 按实际使用功能授权，不要为首次导入订阅预先开放无关权限 |
- 挂载安装映像。打开下载的 DMG，将应用拖入“应用程序”目录。复制完成后弹出磁盘映像，再从应用程序目录启动。
- 阅读系统提示。首次打开可能触发系统安全提示。只有在明确文件来源、理解提示含义后，才到系统设置中的“隐私与安全性”查看对应操作；若提示应用损坏或不兼容，应先重新下载并核对系统要求。
- 检查应用代理设置。导入订阅并选择配置后，再启用需要的系统代理选项。系统代理主要影响遵循系统设置的应用，终端或自行管理代理的浏览器扩展需要另行核对。
更新前先退出正在运行的客户端，避免替换应用时仍有旧进程占用文件。若切换架构或迁移设备，优先导出并重新导入必要配置，而不是假定所有路径、权限和本地端口都可直接沿用。更完整的设置说明可查看v2rayN 配置教程。
移动端 / 先确认架构
Android 客户端
优先选择 v2rayNG。2015 年后的主流手机通常选择 arm64；旧设备、模拟器或架构不确定时，可考虑通用版。
v2rayNG
v2rayNG 使用 Xray 内核。导入后仍需确认配置要求的协议、传输方式及安全参数是否被当前版本支持。二维码或剪贴板导入成功，只代表配置已被读取，不代表远端服务一定可用。
v2flyNG
V2Fly 与 Xray 属于不同的内核维护路线。切换客户端前先确认配置兼容性，尤其不要把特定内核才支持的功能直接迁移。两款客户端可以分别管理配置，但不应同时争用系统 VPN 连接。
系统要求与安装授权
| 检查项 | 选择依据 | 安装时注意 |
|---|---|---|
| 应用架构 | 支持 arm64-v8a 的系统优先选 arm64 | 处理器支持 64 位不代表系统一定支持 64 位应用 |
| 系统版本 | 需满足所选 APK 的最低 Android 版本要求 | 无法安装时先阅读系统的具体错误信息 |
| 安装来源权限 | 仅为实际打开 APK 的浏览器或文件管理器授权 | 安装后可收回该来源的安装权限 |
| VPN 授权 | 首次启动连接时按系统提示确认 | 检查是否有其他 VPN 应用占用连接 |
| 后台管理 | 按设备需要允许客户端在后台运行 | 只调整客户端相关的电池策略，不必全局关闭电池管理 |
- 打开 APK。下载完成后，从下载记录或文件管理器打开。系统要求安装来源权限时，核对当前发起安装的应用，再按需授权。
- 保留更新路径。若提示签名不一致，可能是现有应用与新包的签名不同。不要立刻卸载；先备份订阅、路由和必要设置，再判断是否需要迁移。卸载通常会清除应用数据。
- 导入并授权连接。用订阅分组、剪贴板或二维码入口读取配置。更新订阅后选择配置，再点击连接按钮，并阅读系统 VPN 授权对话框。
扫码和剪贴板入口读取的是已有内容，不会自动生成订阅地址。相机权限仅在扫码等相关功能需要时授予。连接后若只有部分应用没有走代理，先检查应用分流和排除列表；不要把系统 VPN 图标等同于所有应用都已完成连接测试。
桌面端 / 发行版与架构
Linux 客户端
先确认发行版的软件包格式，再选择处理器架构。deb 与 rpm 是包格式区别，不是两套客户端功能。
v2rayN
包格式匹配只是第一步，仍需满足该构建的系统库与桌面环境依赖。特别是 rpm 包，不应仅因文件后缀相同就认定兼容所有 rpm 发行版；先查看图形软件安装器列出的依赖及错误提示。
系统要求与图形安装
| 检查项 | 选择依据 | 安装时注意 |
|---|---|---|
| 软件包格式 | Debian 系常用 deb；rpm 系发行版选择兼容的 rpm | 不能通过改后缀转换软件包格式 |
| 处理器架构 | Intel / AMD 64 位选 x64；64 位 ARM 选 arm64 | amd64 与 x86_64 通常指同一类架构 |
| 桌面环境 | 需要可运行图形应用的桌面会话 | 本页提供图形客户端，不是后台服务部署包 |
| 依赖与权限 | 系统库需满足软件安装器列出的要求 | 安装授权与日常运行权限分开处理 |
- 检查系统信息。在发行版的“关于”或系统信息窗口查看发行版名称、版本和架构，再选择对应的软件包。不要把桌面环境名称当作发行版名称。
- 通过软件安装器打开。在文件管理器中打开 deb 或 rpm，阅读依赖信息并按提示安装。若提示依赖无法满足，应先确认系统兼容性，而不是强行忽略依赖继续。
- 从应用菜单启动。首次运行先导入订阅，再选择配置。Linux 上的系统代理是否被应用读取，取决于桌面环境与应用实现；终端程序通常还需单独设置代理环境变量。
不要为了让浏览器走代理而直接以高权限运行整个客户端。需要更广的流量接管时，先了解 TUN 的权限、路由及 DNS 影响。遇到系统代理已开启但应用未使用的情况，应分别检查应用代理选项、本地监听端口和环境变量，相关概念见路由与分流手册。
下载之后
安装与首次配置
把安装、导入和代理设置分开处理。每完成一项，再验证下一项，排查时更容易找到问题所在。
先导入，再启用代理
客户端负责读取与管理配置，不替代远端服务。准备好有权使用的订阅地址后，在订阅分组中添加地址并更新；单条分享链接则使用对应的导入入口。把网页地址、账户管理页面或整段说明文字粘贴进去，通常无法生成有效配置。
选择配置后，桌面端再设置系统代理，安卓端再启动 VPN 连接。用实际需要访问的应用验证结果，同时留意客户端错误日志。不要仅凭开关已打开就判断连接完成。
查看订阅导入步骤 →先备份，再安装更新
更新前记录当前可用的配置来源、本地监听端口、DNS 与自定义路由。使用客户端提供的导出或备份功能，并妥善保存含有访问凭据的内容。备份不要公开上传，也不要直接发到讨论区作为截图附件。
退出旧客户端后再更新。跨界面、跨内核或跨大版本迁移时，优先按新版本支持的方式重新导入，避免直接覆盖全部文件。完成更新后先验证常用应用，再决定是否启用 TUN 等进阶功能。
了解客户端与内核的区别 →Windows 应该选择 Desktop 版还是经典 WPF 版？
首次安装可先选 Desktop 版，它采用新一代跨平台界面；经典 WPF 版采用 Windows 专用的经典界面，是熟悉原有布局时的稳定选择。两者都是 v2rayN，切换前先备份配置，不要让两套客户端同时占用相同的本地监听端口。
macOS 的 Apple Silicon 与 Intel 安装包怎么选？
打开苹果菜单中的“关于本机”。芯片显示 Apple M 系列时选择 Apple Silicon arm64 包；处理器显示 Intel 时选择 Intel x64 包。安装失败时先核对系统版本和架构，不要通过关闭系统安全保护来绕过提示。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常可先选 arm64，但仍需以设备系统支持的架构为准。旧设备、模拟器或架构不确定时可选通用版。通用版包含多种架构文件，并不意味着连接效果更好。
v2rayNG 与 v2flyNG 有什么区别？
v2rayNG 使用 Xray 内核，是本页 Android 首推客户端；v2flyNG 使用 V2Fly 内核，作为备选。配置能否使用取决于内核对协议、传输和安全参数的支持，不能仅凭订阅能够导入就判断兼容。
下载并安装客户端后，可以直接连接吗？
安装包提供客户端程序，不附带可用的连接配置。需要自行准备有权使用的订阅地址或分享链接，完成导入和更新，再选择配置、开启系统代理或授予 Android VPN 权限。具体步骤见入门指南。
更新客户端前要保留哪些设置？
先备份订阅分组、自定义路由、DNS 和本地端口等设置，并记录当前代理模式。退出旧客户端后再安装更新；不要假定跨版本、跨界面或跨内核的配置文件可以直接覆盖。更新完成后重新检查订阅、监听端口及应用连接情况。