v2rayN Desktop
当前版本 7.24.1
新一代跨平台 UI,设置入口、订阅分组和路由页面采用统一的桌面界面结构。适合新安装用户,也适合需要在不同桌面系统之间保持接近操作路径的用户。
- 架构x64
- 界面Desktop
- 用途新安装与日常配置
CLIENT PACKAGES / CURRENT RELEASES
按操作系统、处理器架构与界面类型选择安装包。桌面端使用 v2rayN,Android 首选 v2rayNG,需要 v2fly 内核实现时可选择 v2flyNG。
PLATFORM SELECTOR
先切换到当前设备的平台,再核对架构和包格式。平台标签会同步到页面地址,重新打开链接时可直接恢复到对应下载区。
WINDOWS / X64
Windows 提供 Desktop 与经典 WPF 两种界面。首次安装且希望桌面端与其他平台保持接近的界面结构,可选 Desktop;已经熟悉旧版菜单、托盘操作与 WPF 布局,可继续选择经典 WPF。两个安装包都是 Windows x64 入口,不需要同时安装。
当前版本 7.24.1
新一代跨平台 UI,设置入口、订阅分组和路由页面采用统一的桌面界面结构。适合新安装用户,也适合需要在不同桌面系统之间保持接近操作路径的用户。
当前版本 7.24.1
Windows 经典稳定版,保留熟悉的 WPF 窗口、菜单与托盘交互。已有配置迁移前,应先记录订阅分组、路由模式和本地监听端口,避免新旧目录混用造成判断困难。
| 核对项 | 要求 | 处理方法 |
|---|---|---|
| 处理器架构 | x64 | 在“设置 → 系统 → 系统信息”查看系统类型;本页 Windows 包面向 64 位桌面系统。 |
| 安装权限 | 可运行安装程序 | 系统弹出权限确认时,核对应用名称与本次操作,再继续安装。 |
| 配置迁移 | 先记录现有设置 | 重点记录订阅地址、分组、路由模式、本地端口和开机启动状态。 |
| 连接前提 | 订阅或节点配置 | 安装结束后导入配置,更新订阅并选择节点,然后再启用系统代理或 TUN 模式。 |
Desktop 与 WPF 是两种客户端界面选择,不是两个必须连续安装的组件。若从旧版本迁移,建议先关闭正在运行的客户端和系统代理,再进行安装,完成后检查本地监听端口是否与其他网络工具冲突。
MACOS / ARM64 · X64
macOS 安装包按芯片分为 Apple Silicon 与 Intel 两种。打开系统菜单中的“关于本机”,查看“芯片”或“处理器”字段:Apple M 系列选择 arm64,Intel 处理器选择 x64。架构对应正确,可以减少安装失败和运行兼容层带来的额外判断。
当前版本 7.24.1
适用于搭载 Apple M 系列芯片的 Mac。安装包使用 arm64 架构,适合当前主流 Mac 设备。下载后打开磁盘映像,将应用放入“应用程序”目录,再从该目录启动。
当前版本 7.24.1
适用于“关于本机”中显示 Intel 处理器的 Mac。该入口为 x64 磁盘映像。若系统显示 Apple 芯片,不应仅凭设备外观或购买年份判断,应返回选择 Apple Silicon 版本。
| 核对项 | 选择依据 | 操作说明 |
|---|---|---|
| 芯片架构 | Apple M 系列或 Intel | 通过“关于本机”查看,不按屏幕尺寸、机型名称或购买时间猜测。 |
| 安装位置 | 应用程序目录 | 打开 DMG 后将客户端放入“应用程序”,不要长期从磁盘映像窗口直接运行。 |
| 网络权限 | 按所选模式授权 | 启用系统代理或需要网络扩展权限时,根据系统提示完成授权,再回到客户端检查状态。 |
| 菜单栏状态 | 确认客户端仍在运行 | 关闭主窗口不一定退出进程;调整配置前先从菜单栏图标打开客户端。 |
首次启动后先导入订阅,再执行一次订阅更新。若节点已经出现但浏览器连接方式没有变化,应检查当前路由模式、系统代理状态以及客户端是否仍在后台运行,而不是反复更换安装包架构。
ANDROID / ARM64 · UNIVERSAL
Android 客户端按固定顺序提供 v2rayNG 和 v2flyNG。v2rayNG 使用 Xray 内核,作为主要选择;v2flyNG 使用 v2fly 内核,适合明确需要该内核实现的配置。2015 年后发布的主流手机通常可优先选择 arm64,无法确认架构时再选通用版。
当前版本 2.2.6
Android 图形客户端,使用 Xray 内核,提供订阅管理、节点选择、路由设置、分应用代理和系统 VPN 服务接入。多数近年手机直接选择 arm64;通用版用于架构不明确或 arm64 包无法安装的设备。
当前版本 1.10.31
使用 v2fly 内核的 Android 客户端,适合配置提供方明确要求 v2fly 实现,或需要核对两套内核行为差异的场景。普通安装流程仍是导入订阅、选择节点、授权 VPN 服务并启动连接。
| 核对项 | 建议选择 | 说明 |
|---|---|---|
| 近年主流手机 | arm64-v8a | 2015 年后发布的多数主流设备可先尝试 arm64 包,体积与目标架构更集中。 |
| 架构无法确认 | 通用版 | 设备资料不完整,或 arm64 安装时提示架构不兼容,可改用 Universal 包。 |
| 首次连接 | 允许 VPN 服务 | 系统授权用于建立本地虚拟网络接口;拒绝后客户端无法接管应用流量。 |
| 后台运行 | 调整省电策略 | 连接频繁在锁屏后中断时,将客户端加入系统省电白名单,并允许必要的后台活动。 |
安装完成后不要同时启动两个 Android 客户端建立 VPN 服务。切换客户端前先停止当前连接,再导入配置并观察日志。若订阅能更新但节点无法连接,应按系统时间、节点参数、网络权限和路由设置的顺序排查。
LINUX / DEB · RPM
Linux 安装包按发行版包管理体系和处理器架构拆分。Debian、Ubuntu 及其衍生发行版选择 deb;Fedora、Rocky Linux、AlmaLinux、RHEL 系发行版选择 rpm。执行 uname -m 后,输出 x86_64 选择 x64,输出 aarch64 选择 arm64。
当前版本 7.24.1
先确定发行版使用 deb 还是 rpm,再确认处理器架构。x64 是多数传统桌面电脑和服务器工作站的选择;arm64 常见于 ARM 桌面设备与开发板。包格式和架构必须同时匹配,不能只依据文件名中的版本号选择。
执行 uname -m 显示 x86_64 时使用。
执行 uname -m 显示 aarch64 时使用。
| 发行版或环境 | 包格式 | 架构判断 |
|---|---|---|
| Debian、Ubuntu 及衍生版 | deb | x86_64 选 amd64;aarch64 选 arm64。 |
| Fedora、Rocky Linux、AlmaLinux、RHEL 系 | rpm | x86_64 选 x86_64;aarch64 选 aarch64。 |
| 桌面会话 | 需要图形环境 | v2rayN 是图形客户端,应在可用的桌面会话中启动并管理配置。 |
| 系统代理 | 按桌面环境设置 | 连接后仍需确认桌面环境是否读取系统代理,终端程序则可能需要单独设置代理环境变量。 |
安装包管理器若报告依赖问题,应先阅读完整错误信息并通过当前发行版的软件源补齐依赖。不要在 deb 与 rpm 之间反复尝试。客户端启动后,先检查配置目录权限、桌面托盘支持和本地端口占用,再导入订阅。
INSTALLATION ROUTE
下载只完成客户端准备。后续还要导入配置、选择节点、设置流量接管方式并验证访问路径。按顺序处理,可以把安装问题、配置问题与网络问题分开判断。
Windows 用户在 Desktop 与经典 WPF 中选择一种;Mac 用户依据芯片字段选择 arm64 或 x64;Android 用户优先判断 arm64 与通用版;Linux 用户同时核对发行版包体系和 uname -m 输出。安装包无法打开或提示架构不兼容时,应返回这一环节,而不是修改节点参数。
桌面端按系统安装流程放置应用,Android 按系统提示完成安装。首次建立连接时,系统可能要求网络、VPN 服务或相关扩展权限。权限用于客户端建立本地流量入口;授权完成后返回客户端,确认连接状态已经变化。
客户端本身不附带订阅和节点。订阅链接应添加到对应的订阅分组入口,再执行更新;单节点分享链接则通过剪贴板导入或扫描入口添加。导入后先确认服务器地址、端口、协议和传输字段已经显示,再进行下一步。
从节点列表中选中目标配置,然后根据使用范围选择系统代理、TUN、VPN 服务或客户端提供的对应模式。只启动客户端但没有启用流量接管方式,浏览器和其他应用通常不会自动经过客户端。分流规则还会决定哪些目标使用代理出站、直连出站或阻断处理。
先打开一个明确可访问的普通网页,确认 DNS 解析、TCP 连接和浏览器访问是否正常;再检查需要代理的目标。若失败,记录发生时间并查看客户端日志。超时、TLS 握手、DNS、路由未命中和本地端口占用属于不同问题,应依据日志关键词分别处理。
PACKAGE DECISIONS
型号相同不代表安装包可以跨平台或跨架构使用。下载前完成下面四项判断,安装阶段遇到的问题会明显减少。
Windows 安装包、macOS 磁盘映像、Android APK、Linux deb 与 rpm 分别由各自系统处理。文件扩展名是第一层判断依据。把其他系统的包复制到当前设备,不会转换成可执行的本平台应用。
x64、arm64、amd64、aarch64 是常见架构标记,其中 amd64 与 x64 对应同一类 64 位桌面架构,aarch64 与 arm64 对应 ARM 64 位架构。Mac 以“关于本机”为准,Linux 以 uname -m 为准,Android 无法确认时使用通用版。
deb 与 rpm 不只是扩展名不同,它们对应不同的软件包管理体系。使用系统原生包格式,有利于安装器处理依赖、菜单入口与后续卸载。不能根据文件体积或名称长短来决定包格式。
桌面端统一使用 v2rayN。Android 默认选择 v2rayNG;只有配置要求或排查目标明确指向 v2fly 内核时,再考虑 v2flyNG。切换客户端不会自动修复过期订阅、错误节点参数或系统时间偏差。
DOWNLOAD FAQ
以下问题集中处理版本选择、芯片架构、安装包格式和首次连接。订阅更新、节点超时、DNS 与系统代理问题可继续前往故障排查页面。
Desktop 版采用新一代跨平台界面,适合希望使用统一桌面体验的新安装用户;经典 WPF 版延续 Windows 原生界面与既有操作习惯,适合需要熟悉菜单结构的用户。两者都用于 Windows x64,选择其中一个安装即可。更换界面版本前,建议先记录订阅分组、路由模式和本地监听端口。
打开系统菜单中的“关于本机”,查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon arm64 版本;显示 Intel 处理器时选择 Intel x64 版本。不要仅依据设备颜色、屏幕尺寸或购买年份判断,因为相近外观的机型可能使用不同架构。
2015 年后发布的主流 Android 手机通常使用 arm64 架构,可优先下载 arm64 版。无法确认设备架构,或 arm64 安装包提示不兼容时,再使用通用版。通用版覆盖范围更广,但它不是所有设备都必须选择的默认入口。
Debian、Ubuntu 及其衍生发行版使用 deb;Fedora、Rocky Linux、AlmaLinux、RHEL 系发行版使用 rpm。还需要根据 uname -m 的输出选择 x86_64 或 arm64 架构。若无法确定发行版归属,可以先读取 /etc/os-release 中的名称与系列信息。
客户端安装完成后仍需导入可用的订阅地址或单节点配置,选择目标节点,再启用系统代理、VPN 服务或对应的接管模式。客户端本身不附带订阅和节点。若节点已经导入但连接失败,应先检查设备时间、节点参数、当前网络和客户端日志。
从订阅导入、节点选择、系统代理设置开始配置;遇到订阅失败、节点超时或浏览器与终端表现不一致时,按症状进入对应文档。