安装包 / 平台索引

V2Ray 客户端下载

先选操作系统,再按处理器架构与包格式下载。安装后,使用已有的订阅地址或节点配置完成连接。

  • 四个平台,三款图形客户端
  • 桌面端使用 v2rayN
  • 移动端按订阅兼容性选型

按平台选择安装包

v2rayN

首推
x64 · ZIP7.24.1

Desktop 使用新一代跨平台界面,适合首次安装或在不同桌面系统间切换的用户。WPF 是经典稳定版,适合熟悉传统菜单和托盘操作的用户。两套界面不需要同时装,也不要假定切换后会自动继承设置。

解压后再运行安装程序

先把 ZIP 完整解压到本机目录,再从解压后的文件夹启动安装程序。不要直接在压缩包预览里双击其中的程序;预览工具可能只把单个文件解到临时目录,安装时就找不到同一包内的其他文件。

如果安装程序提示缺少运行环境,记下提示里的组件名称、版本和架构,再按提示补齐。反复切换桌面版与 WPF 版并不能解决缺少依赖的问题。设备由单位管理时,先确认软件安装策略,不要用其他账户绕过限制。

已有配置时,先在旧客户端记录订阅分组、本地端口和当前代理模式,备份后再退出托盘进程。新客户端首次启动时先确认端口未被占用,再导入配置,最后开启系统代理。这样能区分配置迁移的问题和本地端口冲突。

Windows 系统要求

检查项适用条件
系统类型本页两包均为 x64,核对「系统 → 关于」中的系统类型。
运行环境以当前所选版本的安装提示为准。

只看到「64 位」还不够,继续确认处理器类型。x64 与 ARM64 都是 64 位,但不是同一架构。

下载前核对
安装后验证

  • 同一设备只启用一个客户端进行测试
  • 先验证连接,再调整分流

新装与升级分开处理

新装只需为当前设备选一个包。升级前则应记录客户端名称、系统架构和原安装渠道,并单独备份订阅与手动配置。订阅可以重新拉取节点,但本机调整过的分流、端口和代理模式不一定随订阅恢复。

如果下载后系统把文件识别成网页,先看下载是否完整结束,以及文件类型是否符合所选入口。不应靠手动改扩展名继续安装。下载失败与安装失败的分界很明确:前者没有拿到预期格式的文件,后者才由系统安装器给出报错。

在另一台设备上准备安装文件时,以目标设备的系统和架构为准。把安装包复制过去并不会转移客户端的订阅配置;共享配置时,另选支持的导入方式,并妥善保管带有访问权限的订阅地址。

查看客户端对比

按顺序验证网络路径

首次启动后先确认程序能正常打开,接着导入订阅并手动更新。确认列表中出现预期条目,再选一个已知可用的节点测试。订阅拉取成功与节点建立连接是两次不同的请求,其中一次成功不能证明另一次正常。

先用一个可以确认代理设置的应用做对照,测试时只改一个选项。系统代理依赖应用读取系统设置;TUN 则涉及虚拟网络接口、系统权限和匹配范围。不要在首次排查时同时修改模式、DNS 与路由规则,否则很难定位是哪项设置改变了结果。

用同一应用、同一目标地址对比开启前后的表现。只在开启后失败时,先查看客户端的日志;两种状态都失败时,从本机网络开始查。记录问题时保留报错与发生步骤,删去订阅地址及其他访问凭据。

查看 v2rayN 配置教程

下载与安装
常见问题

桌面版和 WPF 版需要同时安装吗?

不需要。初次安装可选桌面版;已有 WPF 操作习惯或配置的用户可继续选 WPF。切换前备份配置并退出旧客户端,避免两个实例同时占用本地代理端口。

通用 APK 能解决所有安装失败吗?

不能。通用包主要用于覆盖更多处理器架构,不能解决系统版本不足、安装权限受限或应用签名冲突。优先查看系统安装器给出的原因,再决定是否更换包。

怎么区分 deb 和 rpm?

Debian、Ubuntu 系发行版通常使用 deb,Fedora、RHEL 系发行版通常使用 rpm。包格式匹配后仍要确认处理器架构与发行版依赖;文件能打开不等于可以安装。

下载客户端后,为什么列表是空的?

客户端安装包不提供订阅或节点。请向服务提供方或网络管理员获取与所选客户端兼容的配置,再按教程导入。不要把带访问凭据的订阅地址发到公开渠道。

启动正常,但打开网页失败,应该重装吗?

先不用重装。确认客户端能更新订阅、已选中节点,并检查应用是否使用了预期的代理模式。记录首条相关错误;若暂停代理后仍无法联网,先检查系统网络。