免费开源客户端
先选系统，再选处理器架构。桌面设备使用 v2rayN，安卓设备优先使用 v2rayNG。
下载入口按平台整理。安装包、客户端界面和订阅配置是不同的内容；完成安装后，还需导入有权使用的服务器配置。
两个界面版本，均为 x64 安装包。首次安装可先选 Desktop 桌面版。
两种界面都用于管理服务器、订阅分组和代理设置，区别主要在界面框架与操作布局。Desktop 采用新一代跨平台 UI；WPF 保留经典桌面布局。不要仅为切换外观而删除原有配置，先导出备份，再在新版本中检查订阅、路由和本地监听端口。
下载完成后，将压缩包解压到可写目录，再运行其中的安装程序。不要在压缩软件的预览窗口里直接启动。首次打开若提示缺少运行环境，按安装提示补齐对应组件；若系统显示安全提示，先确认文件来源和应用信息，不要通过全局关闭系统防护处理。
查看 v2rayN 安装与订阅导入步骤 →| 检查项 | 选择与处理方法 |
|---|---|
| 系统环境 | 优先使用仍受支持的 Windows 10 / 11；具体兼容范围以安装程序提示为准。 |
| 处理器 | 本页两个入口均为 x64 包。在“设置 → 系统 → 系统信息”查看系统类型，ARM 设备需另行确认兼容性。 |
| 权限与目录 | 保留配置目录写入权限。普通系统代理与 TUN 的权限要求不同，启用 TUN 前再确认管理员权限。 |
| 首次连接 | 导入订阅并更新服务器列表，选中服务器后设置系统代理；本地端口以客户端实际设置为准。 |
更换界面版本时先退出旧进程。两个实例同时运行，可能争用监听端口，也可能互相覆盖系统代理设置。
打开“关于本机”，按芯片或处理器名称选择对应的 DMG 安装包。
芯片架构决定安装包，不要仅凭电脑年份或机身型号推断。点击屏幕左上角系统菜单，打开“关于本机”：显示“芯片”且名称为 Apple M 系列，选择 ARM64；显示 Intel 处理器，选择 x64。使用与设备匹配的版本，可减少额外兼容层带来的差异。
打开 DMG 后，将应用拖入“应用程序”目录，再从该目录启动。不要长期从挂载的磁盘映像运行，否则更新和配置保存的位置容易混淆。遇到系统阻止打开的提示，先阅读“隐私与安全性”中的具体原因，确认来源后按系统提供的入口处理，不要直接执行不明来源的终端命令。
查看桌面客户端首次连接步骤 →| 检查项 | 选择与处理方法 |
|---|---|
| 系统环境 | 使用仍受支持的 macOS。最低系统版本可能随客户端更新变化，以当前应用的启动提示为准。 |
| 芯片架构 | Apple M 系列选 ARM64；Intel 处理器选 x64。下载前在“关于本机”核对。 |
| 应用位置 | 将应用复制到“应用程序”目录，保留配置存储权限，关闭磁盘映像后再使用。 |
| 代理范围 | 系统代理由应用是否读取系统设置决定；需要 TUN 时，另行检查网络权限与路由设置。 |
安装成功后，先使用系统代理验证订阅与服务器配置，再考虑启用 TUN。分开验证，排查范围更小。
优先选择 v2rayNG。2015 年后的主流手机通常选 arm64，架构不确定时再考虑通用版。
v2rayNG 使用 Xray 内核，适合在安卓设备上导入订阅、选择服务器和设置分应用代理。下载 APK 后，由系统安装器完成安装；需要授权时，只为当前使用的浏览器或文件管理器临时开启“允许安装未知应用”，安装结束后可收回该权限。
首次启动连接时会出现系统 VPN 授权对话框，确认后客户端才能接管对应流量。手机通常不能同时启用两套 VPN 服务；已有其他 VPN、工作资料网络策略或使用 VPN 接口的过滤应用时，应先确认是否存在占用。分应用代理只改变应用覆盖范围，不会替代服务器配置。
v2flyNG 是基于 V2Fly 内核的安卓备选客户端。选择它的依据应是配置要求，而不是把不同内核当作界面主题。相似的导入方式不代表协议参数和扩展能力完全一致；已有配置涉及特定传输或扩展选项时，先确认客户端与内核是否支持，再进行迁移。
两个安卓客户端的配置存储彼此独立。切换前先导出必要信息，再在目标客户端重新导入并检查路由、DNS 与应用范围。测试时先停止另一客户端的连接，避免把 VPN 服务占用误判为订阅失效。导出文件和订阅链接都应妥善保存。
了解客户端与内核的区别 →| 检查项 | 选择与处理方法 |
|---|---|
| 系统兼容 | 以当前 APK 的系统安装提示为准。厂商定制系统与受管理设备还可能有额外限制。 |
| 应用架构 | 2015 年后的主流手机通常选 arm64；部分设备系统仍有限制，不确定时尝试通用版。 |
| 连接权限 | 允许系统 VPN 授权。连接前检查其他 VPN 服务是否正在运行。 |
| 后台运行 | 连接频繁在锁屏后中断时，检查电池优化、后台活动与厂商任务管理设置。 |
先按发行版选择 deb 或 rpm，再核对 x64 与 ARM64。以下入口为图形桌面客户端。
包格式与处理器架构是两项独立条件。Debian、Ubuntu 系通常使用 deb；使用 rpm 包管理器的发行版选择 rpm。相同扩展名并不保证系统库版本一定兼容，尤其是软件包要求的运行环境高于当前系统时，应根据包管理器报错检查依赖，不要强制忽略依赖继续安装。
使用系统软件安装器打开下载的包，阅读变更清单并完成授权。安装后从应用菜单启动 v2rayN，先导入配置并验证普通代理连接。桌面环境的系统代理支持程度不同，部分程序需要自行填写本地代理地址；不要把“安装成功”直接等同于“所有应用都已接管”。
查看 deb/rpm 部署与开机自启动说明 →| 检查项 | 选择与处理方法 |
|---|---|
| 桌面环境 | 需要可运行图形应用的桌面会话；本页不是纯命令行服务的部署入口。 |
| 架构名称 | amd64、x86_64 通常对应 x64；arm64、aarch64 对应 ARM64。以系统显示的架构为准。 |
| 包与依赖 | 按发行版选择 deb 或 rpm，让系统包管理器处理依赖；旧系统可能无法满足当前包的运行条件。 |
| 网络权限 | 普通代理先验证本地监听；TUN 与路由调整需要额外权限，不建议始终以高权限运行整个桌面会话。 |
配置开机自启动前，先确认手动启动和连接均正常。自动启动失败与服务器连接失败应分别排查。
安装包只负责部署客户端。首次运行时，服务器列表为空是正常状态。准备好有权使用的订阅地址后，在客户端的订阅管理入口新建分组，填写名称与完整地址，再执行更新。不要把订阅地址填进服务器地址栏，也不要把网页中的说明文字一起复制进去。更新后仍为空时，先查看日志，区分地址错误、访问失败与格式不兼容。
选中服务器后，桌面端先检查系统代理设置，安卓端先确认 VPN 授权。打开一个已知可访问的页面验证连接，再检查其他应用。系统代理只向愿意读取系统设置的程序提供代理入口，因此浏览器可用而终端不可用，并不直接说明客户端安装失败。需要进一步接管应用流量时，再阅读 TUN 与路由配置说明，一次只修改一类设置。
路由、DNS 和应用范围会共同影响请求的去向。遇到连接问题时，记录当前模式和日志中的错误，再逐项恢复或调整。不要同时更换安装包、订阅、DNS 与路由模式，否则很难确认是哪一步解决了问题。客户端能够启动、订阅能够更新、服务器能够连接，是三个独立的检查节点。
更新前使用客户端提供的备份或导出功能，记录订阅分组、自定义路由、DNS 和监听端口。桌面端先退出托盘中的旧进程，再进行安装；安卓端通常可覆盖更新同一签名的应用。若系统提示签名冲突，不要直接卸载旧应用，先确认备份可用，再决定如何迁移。卸载可能连同应用数据一起删除。
卡片中的版本文字与安装包文件名可能来自版本清单的不同字段，发布过程中不一定同时更新。安装后的实际版本以客户端“关于”或应用信息页面为准。完成更新后，先检查原有订阅与路由是否保留，再验证连接；确认工作正常后，才清理旧目录或旧安装包。
客户端负责管理配置与启动连接，不随安装包提供可用服务器。需要准备有权使用的订阅地址或服务器配置，导入后更新订阅、选择服务器，再设置系统代理或 VPN 模式。订阅地址可能包含访问凭据，不要公开分享。
首次安装可先选采用新一代跨平台界面的 Desktop 桌面版；熟悉经典操作布局的用户可选经典稳定的 WPF 版。两种入口均为 x64 安装包。切换界面版本前先备份配置，不要让两个客户端同时占用同一监听端口。
2015 年后的主流手机通常优先选择 arm64，但最终以系统支持的应用架构为准。无法确定架构或 arm64 包提示不兼容时，可尝试通用版。若提示与现有软件包冲突，应先检查应用来源和签名兼容性，不要直接删除现有配置。
同一应用的正常覆盖更新通常保留设置，但配置迁移仍可能受版本跨度、安装方式和存储权限影响。更新前先使用客户端的备份或导出功能，记录订阅分组、路由与 DNS 设置。退出旧进程后再安装，确认连接正常后再清理旧目录。
先检查浏览器下载记录，确认任务已完成且磁盘空间足够。网络中断时重新下载，不要修改扩展名强行打开。Windows 的 ZIP 包需要先解压；macOS 的 DMG 需要打开后将应用拖入应用程序目录；Android 的 APK 由系统安装器处理；Linux 应按发行版选择 deb 或 rpm。
先检查配置而不是反复安装。确认订阅已更新、服务器已选中，再检查系统代理或 VPN 权限、路由模式与 DNS 设置。系统代理只影响读取该设置的应用，终端或部分独立程序可能需要单独设置代理。根据日志中的具体错误继续排查。