v2rayN
7.24.1经典 WPF 版
经典稳定版,保留熟悉的 Windows 界面。已有操作习惯、希望继续使用经典布局时可选。
下载v2rayN WPF 版 ZIP 分发包 · Windows x64下载得到 ZIP 文件后,先完整解压到普通目录,再打开其中的安装程序并按提示完成安装。不要直接在压缩包预览中运行;也不要让两份客户端同时接管系统代理。
先选操作系统,再选处理器架构。桌面使用 v2rayN;Android 首选 v2rayNG,按配置需求选择 v2flyNG。
安装包与连接配置分开准备。已有订阅或配置文件,可在安装后按配置教程导入。
两个 x64 安装入口,按界面偏好选择一个。先完成安装,再导入订阅与调整系统代理。
经典稳定版,保留熟悉的 Windows 界面。已有操作习惯、希望继续使用经典布局时可选。
下载v2rayN WPF 版 ZIP 分发包 · Windows x64下载得到 ZIP 文件后,先完整解压到普通目录,再打开其中的安装程序并按提示完成安装。不要直接在压缩包预览中运行;也不要让两份客户端同时接管系统代理。
| 检查项 | 选择与要求 | 查看位置 |
|---|---|---|
| 处理器 | 本页两个入口均为 x64 包,面向 Intel / AMD 64 位桌面环境。 | 设置 → 系统 → 关于 → 系统类型。 |
| 系统与依赖 | 使用仍获维护的 64 位 Windows;具体最低版本与运行组件要求,以当前包的安装提示为准。 | 先查看系统版本;安装时留意缺失组件或不兼容提示。 |
| 安装权限 | 安装程序或写入受保护目录时可能需要管理员确认;日常运行按实际功能需求授权。 | 确认安装目标目录可写,避免从临时压缩目录启动。 |
桌面版与 WPF 版的区别主要在界面实现和操作布局,不应把其中一版理解为自动获得更快连接。连接结果仍取决于服务器、配置与网络路径。更换版本前先保存现有订阅分组、路由和自定义设置,不能只复制窗口截图作为备份。
首次启动后,先确认本地监听端口,再启用系统代理。教程中常见的 10808 与 10809 只是常见设置示例,不保证当前客户端同时监听这两个端口;应用应使用客户端实际显示的协议与端口。
同一款 v2rayN,分为 Apple Silicon 与 Intel 两种架构。先查看“关于本机”,再选择对应安装包。
适用于芯片一栏显示 Apple M 系列的 Mac。优先选择与芯片一致的原生架构包。
下载v2rayN · Apple Silicon DMG 磁盘映像 · arm64打开 DMG 后,按映像内提示将应用放入“应用程序”目录,再从该目录启动。首次运行出现系统安全提示时,先核对应用来源与提示内容,再决定是否在系统设置中允许打开。
| 检查项 | 选择与要求 | 查看位置 |
|---|---|---|
| 处理器架构 | Apple M 系列选择 arm64;Intel 处理器选择 x64。 | 苹果菜单 → 关于本机 → 芯片或处理器。 |
| 系统兼容性 | 使用仍获维护的 macOS,具体最低版本以当前应用包的要求为准。 | 关于本机查看系统版本;启动时检查兼容性提示。 |
| 应用与权限 | 应用目录需可写;改变系统代理时可能需要系统授权。 | 应用程序目录、系统设置中的隐私与安全性及网络设置。 |
将应用复制到固定目录后再使用,有助于避免磁盘映像被推出后找不到程序。系统代理是桌面应用接入本地代理的方式之一,不等于所有应用都会遵循该设置;终端和部分独立网络工具可能需要单独配置。
如果导入后能启动但没有预期流量,先检查客户端是否已选择服务器,以及系统代理是否指向当前监听端口。不要先反复更换架构包:架构不匹配通常表现为安装或运行问题,而不是某一个网站单独无法访问。
首选 v2rayNG;已有配置明确依赖 V2Fly 时,再选择 v2flyNG。两款应用都需要有效配置与系统连接授权。
v2rayNG 使用 Xray 内核。导入配置后先选择一个服务器,再启动连接;系统弹出 VPN 连接请求时,阅读请求并确认授权。出现钥匙或 VPN 标识只代表连接服务已启动,仍需实际验证应用访问。
v2flyNG 是 V2Fly 内核的图形客户端备选。它与 v2rayNG 的配置能力并非完全相同,尤其要留意协议、传输与安全设置。不要把切换客户端当成无需检查配置的通用修复方法。
| 检查项 | 选择与要求 | 操作提示 |
|---|---|---|
| 应用架构 | arm64 包要求设备支持 arm64-v8a;不确定时可选通用版。 | 设备处理器为 64 位,不一定代表系统提供了相同的应用运行环境。 |
| 系统版本 | 系统需满足当前 APK 的最低版本要求,以安装器提示为准。 | 通用包只扩大架构覆盖,不会降低应用的系统版本要求。 |
| 安装权限 | 需要为打开 APK 的浏览器或文件管理器允许此次安装来源。 | 只向本次实际使用的来源授权,完成后可按需收回。 |
| 连接与后台 | 连接需要 VpnService 授权;后台持续运行受系统电池策略影响。 | 与其他 VPN 类应用避免同时连接,按需调整电池优化设置。 |
安装器提示“应用未安装”时,不要立即卸载旧应用。先确认下载已完成、存储空间充足、架构与系统版本合适,再检查当前已安装应用与新包是否来自兼容的签名渠道。需要重新安装前,先备份仍要保留的配置。
连接在锁屏后中断,往往需要检查电池优化、后台活动与系统清理策略,而不是再次下载安装包。若只想让部分应用使用代理,应在客户端中检查分应用设置,并确认当前选择的是“仅代理所选应用”还是“绕过所选应用”。
先按发行版选择 deb 或 rpm,再确认 x64 / arm64。以下入口均为 v2rayN 图形桌面应用。
适用于使用 deb 包管理体系的兼容发行版。常见 Intel / AMD 64 位电脑选择 x64。
下载v2rayN · deb x64 DEB 软件包 · amd64 ARM 设备:下载 deb arm64 →适用于采用 RPM 包管理的兼容发行版。安装前由包管理器确认依赖与发行版兼容性。
下载v2rayN · rpm x64 RPM 软件包 · x86_64 ARM 设备:下载 rpm arm64 →用发行版的软件安装器打开下载的包,先阅读依赖与兼容性提示再确认安装。RPM 文件名中的发行版标记不是所有 RPM 系统都兼容的保证;遇到依赖冲突时,不要强行忽略依赖。
| 检查项 | 选择与要求 | 查看位置 |
|---|---|---|
| 包管理体系 | Debian / Ubuntu 系通常选择 deb;RPM 系选择 rpm,并检查具体发行版兼容性。 | 系统说明、软件管理器与发行版版本信息。 |
| 处理器架构 | x64 对应 amd64 / x86_64;arm64 对应 aarch64。 | 系统设置中的关于页面或硬件信息页面。 |
| 运行环境 | 需要图形桌面环境与当前软件包所需的运行库。 | 由软件安装器检查依赖,安装后从应用菜单启动。 |
| 代理接入 | 桌面代理设置的实际支持情况取决于桌面环境与应用。 | 检查系统网络设置及应用自身的代理设置。 |
Linux 的架构名称容易混淆:amd64 不只用于某一家处理器,通常指通用 x86 64 位架构;aarch64 则对应 ARM 64 位。包格式与处理器架构是两个独立条件,不能因为发行版使用 deb 就直接选择任意 deb 文件。
安装完成后先启动图形客户端,确认配置可读取、端口可监听,再处理应用代理。桌面系统代理与终端环境变量是不同路径;浏览器能连接,并不意味着终端命令会自动使用同一个入口。
安装程序、连接配置和应用代理是三个不同环节。
查看系统、架构与安装包格式,避免在安装失败后才反复试包。升级已有客户端前,先在应用中备份需要保留的订阅分组、服务器条目、路由规则和自定义设置。不同客户端、不同界面版本之间不保证所有设置都能直接迁移,涉及自定义 JSON 时尤其应保留一份独立副本。
本页提供的是客户端程序,安装完成不等于已经有可用连接。应准备有权使用的订阅地址、分享链接或配置文件,再按客户端菜单导入。订阅更新失败时,先检查地址是否完整、是否仍有效,以及更新请求使用的网络路径;不要把同一地址连续导入多个分组,这会增加后续排查难度。
桌面先选择服务器并确认本地监听,再设置系统代理;Android 先完成连接授权,再验证需要使用代理的应用。排障时一次只改一项,记录修改前后的表现。日志中的连接被拒、超时和配置解析错误对应不同阶段,不能统一归因于安装包问题。
先排除包格式和架构问题,再检查配置与连接。
首次使用可先选桌面版 Desktop,它采用新一代跨平台界面。经典 WPF 版是经典稳定版,适合熟悉原有 Windows 界面的用户。两者都需导入有效配置,不要同时开启两份客户端的本地监听与系统代理。
2015 年后的主流手机通常选择 arm64,但最终应以设备支持的应用 ABI 为准。无法确认架构时可选择通用版;通用版包含多种架构支持,文件通常更大。如果提示无法安装,还应检查系统兼容性、下载是否完成以及已有应用的签名是否一致。
v2rayNG 使用 Xray 内核,是本页 Android 首推客户端;v2flyNG 使用 V2Fly 内核,作为按配置需求选择的备选。两者支持的具体字段与功能并不完全一致。已有配置应先确认所需内核,再决定使用哪款客户端。
打开苹果菜单中的“关于本机”。芯片一栏显示 Apple M 系列时选择 Apple Silicon;处理器一栏显示 Intel 时选择 Intel。安装包需要与机器架构对应,不能只根据电脑外观或购买年份判断。
先按发行版包管理体系选择:Debian、Ubuntu 及兼容发行版通常使用 deb,Fedora 等采用 RPM 包管理的发行版通常使用 rpm。再按处理器选择 x64 或 arm64。包格式相同也不代表所有发行版版本都兼容,仍需检查包管理器给出的依赖要求。
客户端负责读取配置和建立连接,安装本身不会提供服务器或订阅。需要导入有权使用的有效配置,选择服务器,再设置桌面系统代理或授予 Android VPN 连接权限。连接仍失败时,按配置有效性、本地端口、代理模式和日志的顺序检查。
安装已完成但连接异常,可继续查看常见问题;需要理解配置字段时,查看入站、出站与路由参考。