CLIENT FILES / 客户端安装包
V2Ray 客户端下载
v2rayN 桌面客户端,v2rayNG 与 v2flyNG 安卓客户端。先选系统,再选处理器架构。
客户端永久免费、代码开源。安装包不包含连接配置;首次使用需另行导入订阅或分享链接。
Windows 客户端。桌面版与经典界面。
v2rayN
Windows / x64 / Desktop · WPF
Desktop 桌面版采用新一代跨平台 UI,适合首次安装,或希望在不同桌面系统上保持相近操作方式的用户。经典 WPF 版是面向 Windows 的经典稳定版,保留熟悉的窗口布局。两项入口对应不同界面实现,不代表不同代理协议,也不应仅凭界面版本判断连接能力。
此处两项安装包均面向 x64 系统。先在 Windows 的“设置 → 系统 → 系统信息”中查看“系统类型”,确认运行的是适用架构。下载得到 ZIP 文件后,先解压到可写目录,再运行包内安装程序。不要直接从压缩预览窗口启动,以免关联文件尚未解压,造成启动或路径错误。
已有配置时,先导出备份,再切换 Desktop 或 WPF。不要让两个客户端同时修改系统代理或争用同一监听端口。安装完成后检查“自动配置系统代理”、活动服务器与路由设置;能够打开主窗口,只说明程序已启动,并不表示浏览器流量已经进入代理。
Windows 安装条件
| 检查项 | 选择与要求 |
|---|---|
| 系统与处理器 | Windows x64;系统版本与运行组件要求以所选安装器提示为准。 |
| 文件处理 | 下载 ZIP 后完整解压;安装目录与用户配置目录需有相应读写权限。 |
| 代理权限 | 常规系统代理与 TUN 的权限需求不同;TUN 可能需要管理员权限和虚拟网络接口组件。 |
macOS 客户端。按芯片选择 DMG。
v2rayN
macOS / Apple Silicon · Intel
打开系统菜单中的“关于本机”,查看“芯片”或“处理器”一栏。显示 Apple 芯片的设备选择 Apple Silicon,即 arm64 安装包;显示 Intel 处理器的设备选择 Intel,即 x64 安装包。设备购买年份不是可靠依据,优先读取系统报告中的实际硬件信息。
下载后打开 DMG,按磁盘映像中的提示将客户端放入应用程序目录,再从应用程序目录启动。不要长期从挂载映像内运行,否则后续移除映像、更新程序或访问配置时可能遇到路径变化。首次启动如出现系统安全提示,应先核对应用来源和提示内容,再按系统提供的设置流程处理。
导入配置后,系统代理只影响遵循该设置的应用。需要 TUN 时,应按客户端提示授予所需权限,并注意与其他网络扩展的冲突。更换客户端或停止使用前,先恢复系统代理,再退出程序;直接删除应用并不等于系统中的代理设置已经恢复。
macOS 安装条件
| 检查项 | 选择与要求 |
|---|---|
| 芯片架构 | Apple Silicon 选择 arm64;Intel 处理器选择 x64,不按机型名称猜测。 |
| 系统版本 | 需满足当前应用构建的最低系统要求;若提示系统过旧,先确认系统兼容情况。 |
| 安装与权限 | 应用程序目录需可写;更改代理或启用虚拟网络接口时可能要求系统授权。 |
Android 客户端。Xray 首选与 V2Fly 备选。
v2rayNG
Android / Xray 内核
v2rayNG 采用 Xray 内核,适合在安卓设备上导入订阅、选择活动配置并通过系统 VPN 接口接管流量。2015 年后的主流手机通常优先选择 arm64;如果设备系统仍是其他架构,或无法确认运行环境,可选择通用版。通用版的用途是覆盖更多架构,不表示功能比 arm64 版更多。
下载 APK 后,系统可能要求允许当前浏览器或文件管理器安装应用。确认来源后,仅为实际执行安装的应用授予所需权限。首次建立连接时,Android 会显示 VPN 连接授权;这是客户端创建本地虚拟网络接口的系统流程,不代表订阅已导入,也不等于远端连接已经成功。
连接后如出现锁屏断开,应先查看系统对后台运行和电池优化的限制,再检查订阅是否有效。多数设备同一时间只允许一个常规 VPN 服务工作,其他使用 VPN 接口的应用可能与客户端冲突。测试前应明确当前由哪个应用接管流量,避免在多个服务之间反复切换。
v2flyNG
Android / V2Fly 内核
v2flyNG 是采用 V2Fly 内核的安卓备选客户端,适合已有对应配置或需要核对 V2Fly 行为的场景。选择它之前,应确认订阅使用的协议与传输设置能够由该客户端和内核版本识别。界面中的导入方式相近,并不意味着所有 Xray 专属设置都能直接迁移。
arm64 与通用版的选择方法和前述安卓安装包一致。迁移时优先重新导入标准分享链接或订阅,再逐项核对路由、DNS 与应用分流,不要直接覆盖另一款客户端的数据目录。两款客户端可以分别保存配置,但实际连接时应只启用其中一个 VPN 服务。
Android 安装条件
| 检查项 | 选择与要求 |
|---|---|
| 系统架构 | 主流 64 位系统优先 arm64;架构不明时可选通用版,最终以安装兼容提示为准。 |
| 安装权限 | 允许执行安装的浏览器或文件管理器安装 APK;系统版本需满足当前包的要求。 |
| 网络与后台 | 首次连接需 VPN 授权;持续运行还可能受系统后台限制、电池优化及其他 VPN 服务影响。 |
Linux 客户端。先分包格式,再分架构。
v2rayN
Linux / deb · rpm / x64 · arm64
deb 通常用于采用 Debian 包管理体系的发行版,rpm 用于采用 RPM 包管理体系的发行版。先确认发行版支持的包格式,再查看处理器架构。文件名中的 amd64 与 x86_64 都表示常见的 x64 架构;arm64 与 aarch64 表示 ARM 64 位架构,不能只看扩展名就直接安装。
这些入口提供图形桌面客户端,需要可用的桌面会话与相应运行依赖,不是面向仅有终端环境的服务端安装步骤。下载后可使用发行版的图形软件安装器打开对应文件;若提示依赖无法满足,应先核对发行版版本和包的目标环境,不要强制忽略依赖继续安装。
系统代理能否被应用读取,取决于桌面环境及应用自身的网络实现。TUN 则还涉及虚拟网络接口、权限和系统路由。首次使用建议先验证普通系统代理,再按需求启用 TUN。若其他代理服务已占用端口,应先停止冲突服务或修改监听配置,避免把启动失败误判为订阅故障。
Linux 安装条件
| 检查项 | 选择与要求 |
|---|---|
| 包管理体系 | 按发行版选择 deb 或 rpm;扩展名匹配仍需核对系统库与依赖要求。 |
| 处理器架构 | x64 对应 amd64 或 x86_64;ARM 64 位对应 arm64 或 aarch64。 |
| 桌面与权限 | 需图形桌面会话及可写配置目录;安装系统软件、创建虚拟网络接口可能需要提权。 |
SECTION 02 / 安装与更新
安装包选择。区分架构、版本与配置。
处理器架构不是系统名称
同一个操作系统可能运行在不同处理器上。平台选对而架构选错,仍然可能无法安装或启动。优先查看系统信息,不通过浏览器外观、设备品牌或购买年份推断。遇到“此应用无法运行”一类提示时,先检查架构,再判断是否缺少运行组件,避免反复下载同一份不适用的文件。
版本字段与包文件名分别读取
卡片明细展示清单提供的版本文字,各按钮分别指向对应架构文件。清单版本字段与文件名可能不完全一致,应结合安装器和客户端“关于”页面确认实际安装版本。文件名里的版本数字不是可自由替换的下载参数;手工修改路径可能得到不存在的文件。
更新前保留可回溯的设置
更新程序前,导出当前配置并保存自定义路由。订阅链接可能包含访问凭据,不应放进公开截图、聊天记录或公开文档。停止连接、退出旧程序后再更新,可减少端口占用与文件写入冲突。新版本启动后先检查活动配置和路由,再恢复日常使用。
兼容性由多个层次共同决定
安装包能否运行取决于系统与依赖;分享链接能否导入取决于客户端解析能力;连接能否建立还取决于内核支持、参数和远端服务状态。三类问题应分别判断。Xray 与 V2Fly 的功能并非完全相同,涉及具体协议与传输组合时,可查阅协议参考,再确定客户端选择。
SECTION 03 / 首次配置
下载后的配置顺序。从导入到验证。
-
导入订阅或分享链接
安装完成后先取得有效配置。订阅地址与单条分享链接不是同一种输入:订阅通常放在订阅分组中更新,分享链接可通过剪贴板导入。输入后检查客户端是否生成可选择的配置项;如果列表为空,先核对格式与订阅访问状态,不要立即修改系统代理。
-
选中配置并设置流量入口
在列表中设置活动配置,再选择系统代理或 TUN。系统代理依赖应用读取代理设置;TUN 使用虚拟网络接口处理流量,权限和接管范围不同。首次排查时保留一种明确的入口,避免同时叠加多个代理工具。路由规则决定哪些请求直连、代理或阻断,并非打开开关后所有流量都会走同一路径。
-
确认连接与应用实际行为
先查看客户端日志是否出现启动或配置错误,再进行真连接测试,最后检查目标应用的访问结果。端口探测只能说明部分链路可达,不能替代完整代理连接验证。若客户端测试正常而浏览器异常,应继续检查浏览器代理、DNS 与路由规则,不必立刻重装客户端。
查看完整快速上手教程,或在选型指南中比较三款客户端的适用场景。
SECTION 04 / 下载问题
安装包常见问题。选择、更新与启动。
Windows 桌面版与经典 WPF 版怎么选?
首次安装可先选择 Desktop 桌面版,它采用新一代跨平台界面。经典 WPF 版保留 Windows 经典稳定界面,适合已有操作习惯的用户。两者都需要导入有效的连接配置;切换界面版本前应先导出配置,不能只凭界面相似就直接覆盖程序目录。
Android 应选 arm64 还是通用版?
2015 年后的主流手机通常优先选择 arm64,但最终仍以设备运行的系统架构为准。处理器支持 64 位,不等于系统一定运行 64 位环境。不能确认架构,或 arm64 包提示不兼容时,可尝试通用版;通用版包含多种架构,通常占用更多下载与存储空间。
安装客户端后还需要订阅或分享链接吗?
需要。安装包只提供图形客户端与流量处理功能,不包含可直接使用的连接配置。应从可信来源取得订阅或分享链接,再在客户端内导入。导入成功后仍需选择活动配置、设置代理方式,并确认应用流量是否按预期经过代理。
更新安装前怎样保留已有设置?
先在客户端中导出配置,单独保存自定义路由和订阅信息,再停止连接并退出程序。保持同一应用和处理器架构,按安装器提示更新。跨客户端迁移不保证设置字段兼容;更新后应检查活动配置、监听端口、系统代理与路由模式,不要立即删除备份。
安装包打不开或提示架构不兼容怎么办?
先核对平台、处理器架构与文件类型。Windows 下载项是 ZIP 压缩包,需要解压后再运行其中的安装程序;macOS 使用 DMG,Android 使用 APK,Linux 按发行版选择 deb 或 rpm。若仍无法安装,应记录系统版本与完整错误提示,区分系统兼容问题和安装权限问题。
版本文字与安装包文件名不同,应该看哪里?
版本文字与各架构文件路径来自清单中的独立字段,两者可能存在差异。下载时应同时核对所选平台、架构、文件名及安装器显示的版本;安装后以客户端关于页面显示的实际版本为准。不要通过手工修改下载地址中的版本数字来寻找其他安装包。
连接失败、订阅更新与分流问题见常见问题。