客户端发行包 / 平台选择
V2Ray 客户端下载
桌面端选择 v2rayN;Android 端优先选择 v2rayNG,也可按配置需求选择 v2flyNG。先选系统,再核对处理器架构与包类型。
v2rayN
Windows x64 · 7.24.1
首推
桌面版采用新一代跨平台代理界面,适合首次安装或希望在不同桌面系统上沿用相近操作的用户。WPF 版保留经典 Windows 界面,适合已经熟悉旧版菜单与配置流程的用户。两者是同一客户端的界面版本,不需要为了支持某种订阅而同时安装。
这里的两个入口都是含安装程序的 ZIP。先解压到可写目录,再打开其中的安装程序;不要直接从压缩包预览窗口运行。升级或切换界面版本前,记录正在使用的配置位置并退出托盘中的旧客户端。
v2rayN
macOS · 7.24.1
从苹果菜单打开「关于本机」。显示 Apple M 系列芯片时选 Apple Silicon 包;显示 Intel 处理器时选 x64 包。选择依据是当前这台电脑的芯片,不是序列号、购买年份或另一台电脑上正在使用的版本。
打开 DMG 后按磁盘映像内的说明将应用复制到目标位置,再从目标位置启动。首次启动遇到系统提示时,先核对提示属于架构、系统版本还是设备管理策略;重新下载另一架构的包并不能解决系统版本限制。
v2rayNG
Android · Xray · 2.2.6
首推
2015 年后的主流手机可优先选 ARM64;准确依据是设备系统支持 arm64-v8a。无法确认支持的 ABI 时,可先选通用版。通用版包含多种架构组件,通常体积更大,但它不会改变最低 Android 版本要求。
卡片版本来自发行清单,可能与入口指向的文件名不同。若要升级现有安装,以所选包的实际版本和发行渠道为准,安装前再核对系统安装界面显示的信息。
v2flyNG
Android · V2Fly · 1.10.31
备选
适合已有 V2Fly 配置并希望延续原有使用方式的用户。确认设备支持 arm64-v8a 时选 ARM64;不清楚设备 ABI 时选通用版。更换客户端前,先检查原配置使用的协议、传输与安全层能否被目标客户端识别。
更换客户端不是覆盖升级。先保留原配置,再在新客户端中验证一条连接;验证期间不要让两个客户端同时尝试接管本机流量。
v2rayN
Linux · 7.24.1
ARM64 deb
ARM64 rpm
先按发行版选择包格式,再核对架构。Debian、Ubuntu 系统通常选择 deb;这里的 rpm 带有 el10 标识,应核对目标发行版及其依赖要求。包管理器能识别 rpm 格式,并不代表这个 rpm 能在当前系统中运行。
安装顺序 / 配置迁移
安装前核对的三项信息
系统版本与架构分别确认
安装失败时,先分清是包选错,还是设备不满足运行条件。系统版本决定哪些接口和运行库可用,架构决定包中的程序能否在当前环境中执行。这两个条件不能互相推导。同为六十四位的两台电脑,一台可能使用 x64,另一台可能使用 ARM64;即使处理器相同,安装了不同版本的操作系统后,能运行的客户端版本也可能不同。远程协助时,应该请对方读取目标设备的信息,而不是用自己的设备型号推断。
包格式与安装方式对应
扩展名决定下载完成后由什么程序处理。ZIP 先解压,DMG 先打开磁盘映像,APK 由 Android 的安装界面处理,deb 和 rpm 交给对应包管理器。浏览器打开下载记录不意味着安装已经完成。若系统界面显示文件打不开,先确认下载已结束且所选格式属于当前系统。不要通过重命名扩展名尝试在另一平台安装;名称改变不会转换软件包或其中的可执行程序。
区分新装、覆盖升级与换客户端
新装只需要选对包与运行环境;覆盖升级还要考虑版本、发行渠道和现有数据。换客户端则要单独检查配置兼容性,不能把能导入订阅当成所有条目都可用。若原客户端维护了多个分组,先记下当前选中的分组、常用服务器、代理模式与自定义路由。备份文件若包含订阅地址或认证信息,应保存在受控位置,不要随故障截图上传或转发。
首次启动与升级后的验证
安装结束后先确认界面能正常打开,再导入一条有权使用的配置做测试。不要同时变更订阅、路由规则和接管模式,否则失败时难以判断是哪一项引入了问题。如果先前使用的是系统代理,升级后可以先沿用它验证遵循系统代理的应用;有需要时再单独验证 TUN。两种模式的接管范围不同,浏览器测试成功,并不证明其他应用也在使用同一条路径。
迁移时建议按「分组可见 → 条目可读 → 单条连接可用 → 目标应用可访问」的顺序检查。订阅更新后看不到条目,应先查导入或更新日志;条目已出现但无法连接,再检查配置的协议、传输方式和安全层;客户端显示连通而目标应用没有变化,则优先查看代理模式与路由命中情况。按这三个层次排查,比直接重装更容易保留原有设置和诊断线索。
如果仅在升级后出现问题,先记下发生故障的步骤与系统提示,再与备份中的设置逐项对照。桌面端也要检查旧进程是否仍在托盘中运行,以及退出后系统代理是否按预期恢复。移动端切换前先停止上一款客户端的连接。需要图形界面操作步骤时,参阅订阅导入与连接教程;若怀疑条目与内核不兼容,先查协议与内核手册。
下载与安装常见问题
Windows 桌面版和经典 WPF 版怎么选?
首次安装可从桌面版开始;希望沿用经典 Windows 界面和菜单布局时,选 WPF 版。切换版本前先备份配置,首次启动新版本时避免让两份客户端同时修改系统代理。
Android 能升级安装但提示签名不一致怎么办?
先确认已安装版本的发行渠道,优先从同一渠道获取更新。若确定要切换渠道,先备份配置并确认可以恢复,再卸载旧版后安装新版。卸载可能清除应用数据。
macOS 下载后提示应用不适用于这台电脑怎么办?
先在关于本机中核对芯片或处理器,再对照发行说明确认系统版本。Apple Silicon 选 ARM64 包,Intel 机型选 x64 包。架构正确也不代表当前系统版本满足要求。
Linux 能用同一种包格式安装在所有发行版上吗?
不能。先选发行版使用的 deb 或 rpm,再核对处理器架构和目标发行版。特别是带 el10 标识的 rpm,不应仅因系统支持 rpm 就跨发行版强制安装。
安装成功后为什么客户端里没有服务器?
客户端安装包不含订阅或服务器配置。打开客户端后,导入你有权使用的订阅地址或单条服务器配置;若名单仍为空,先检查导入或更新日志。