v2rayN
桌面图形客户端 · x64
两种入口均为 ZIP 压缩包。先解压,再运行其中的安装程序;不要在压缩包预览窗口中直接启动。
客户端安装包
桌面端选 v2rayN,安卓端优先选 v2rayNG。先确认操作系统,再选择对应的处理器架构与安装格式。
按平台选择
切换平台可查看对应安装包。桌面端使用同一款客户端,安卓端按内核兼容性选择主用或备选应用。
桌面图形客户端 · x64
两种入口均为 ZIP 压缩包。先解压,再运行其中的安装程序;不要在压缩包预览窗口中直接启动。
| 检查项 | 要求与选择 |
|---|---|
| 操作系统 | 建议使用仍在安全维护期内的 Windows 11 x64;具体最低要求以所下载版本的安装提示为准。 |
| 处理器 | 本页为 x64 安装包。可在“设置 → 系统 → 系统信息”查看系统类型。 |
| 运行环境 | 按安装程序提示准备相应运行环境。WPF 版若提示缺少 .NET 桌面运行库,应匹配所需架构及主版本。 |
| 目录与权限 | 使用当前账户可读写的目录。一般代理设置先用普通权限;TUN 功能可能要求额外权限。 |
安装后先启动客户端主界面,确认程序能正常保存设置,再导入订阅。若新旧界面同时安装,避免让两份程序一起启动并争用本地监听端口。需要迁移时,先导出配置,再逐项核对订阅分组和路由设置,不要直接假定两套界面的所有配置文件可以互相覆盖。
遇到启动窗口一闪而过,应优先查看报错和运行环境,而不是反复更换节点。若客户端能够打开、只有访问失败,则应转向服务器参数、系统代理与路由检查;这两类问题的排查起点不同。
macOS 图形客户端 · DMG
打开左上角苹果菜单 → 关于本机:显示“芯片 Apple M…”选 arm64,显示“处理器 Intel…”选 x64。
| 检查项 | 要求与选择 |
|---|---|
| 系统兼容 | 使用仍在安全维护期内的 macOS,并确认安装包支持当前系统版本;旧系统应先核对应用启动提示。 |
| 处理器 | Apple Silicon 对应 arm64;Intel 对应 x64,不根据电脑购买年份猜测架构。 |
| 安装位置 | 打开 DMG,按窗口提示将应用放入“应用程序”,再从该目录启动。 |
| 系统授权 | 系统代理与 TUN 的授权不同。只有启用相关功能时才处理对应权限提示。 |
DMG 是磁盘映像,不是应用的长期运行目录。完成复制后,可推出磁盘映像,再从“应用程序”启动客户端。这样可以避免更新时仍在旧映像中运行,也便于在系统权限设置中识别同一个应用。
首次打开若受到系统安全机制拦截,先阅读提示并在“系统设置 → 隐私与安全性”查看原因。确认来源与应用身份后,再按系统提供的流程处理;不要把关闭系统整体保护当作常规安装步骤。若提示系统版本不兼容,权限调整并不能解决,应先处理兼容性。
连接前可先使用系统代理验证浏览器访问。只有应用不读取系统代理、确有接管需求时,再考虑 TUN。授权失败、代理设置未生效和服务器无法连接属于不同环节,应结合客户端日志分别判断。
Xray 内核 · Android 图形客户端
首次连接需要接受 Android 的 VPN 连接授权。导入订阅后,先选中节点,再启动连接。
V2Fly 内核 · Android 图形客户端
仅在配置与内核兼容时选择备选客户端。不要为了导入同一条订阅而同时开启两款应用的 VPN 连接。
| 检查项 | 要求与选择 |
|---|---|
| 系统兼容 | 以 APK 安装器给出的最低 Android 版本要求为准;使用正常接收安全更新的设备更便于排查系统问题。 |
| 应用架构 | arm64-v8a 对应 64 位 ARM 应用环境;处理器支持 64 位不一定代表系统允许安装全部 64 位应用。 |
| 安装授权 | 仅向实际用于打开 APK 的浏览器或文件管理器授权安装来源,完成后可关闭该授权。 |
| 后台连接 | 首次连接授予 VpnService 权限。若息屏后断开,再检查厂商的后台运行与省电限制。 |
从文件管理器打开 APK 后,先核对应用名称和安装提示。已有同名应用却无法覆盖安装时,常见原因是签名不同或系统禁止降级;不要直接卸载旧应用,否则本地配置可能随之删除。先备份订阅与设置,再判断是否需要迁移。
两款安卓客户端的内核不同,不应仅根据界面相似就认为配置完全通用。特别是协议扩展、加密参数和新传输方式,必须与订阅要求对应。连接建立后再设置分应用代理,并确认列表采用的是“仅代理所选应用”还是“绕过所选应用”,避免把相反的规则误当作连接故障。
Linux 图形客户端 · deb / rpm
软件包格式由发行版决定,处理器架构由设备决定。两项都要匹配,不能只按文件扩展名选择。
| 检查项 | 要求与选择 |
|---|---|
| 桌面环境 | 需要可运行图形应用的桌面会话;纯命令行服务器不适用本页图形客户端安装流程。 |
| 处理器 | amd64、x86_64 对应 x64;aarch64 对应 arm64。可在系统信息中查看。 |
| 包管理体系 | 按发行版选择 deb 或 rpm,并使用系统软件安装器检查所需依赖。 |
| 权限与网络 | 安装软件包可能需要管理员授权;日常运行先用普通用户,启用 TUN 时再处理相关权限。 |
通过发行版的软件安装器打开安装包,可以提前查看依赖与架构是否满足要求。若出现库版本不足,不建议强行跳过依赖检查;相同的 rpm 或 deb 扩展名,并不意味着软件包适用于每一个发行版版本。
启动后若没有托盘图标,应先确认桌面环境是否支持对应的状态区域,不要据此判断程序没有运行。系统代理在不同桌面环境中的覆盖范围也可能不同:先确认客户端入站已正常监听,再检查应用是否读取系统代理。命令行工具和独立网络组件可能还需要各自设置代理。
选择安装包时,按“操作系统 → 处理器架构 → 包格式”的顺序判断。系统名称决定程序能否运行;架构决定二进制文件是否适配处理器与系统环境;包格式决定由哪一种安装工具处理。任意一项不匹配,都可能出现无法打开、应用未安装或依赖不满足等提示。
x64 通常用于 Intel 与 AMD 的 64 位桌面处理器;arm64 通常用于 Apple Silicon、安卓手机及部分 Linux 设备。名称中的 amd64 并不表示只能在 AMD 处理器上运行,x86_64 也不是另一种独立架构。无法确认时,优先读取操作系统的“系统信息”,不要根据设备外观或购买年份判断。
三款客户端均为免费开源软件。Project V 是相关技术生态的起点,V2Fly 与 Xray 是不同的内核发展分支;图形客户端在内核之上提供订阅管理、路由与代理设置。应用名称相近不代表更新周期、协议能力和配置结构完全一致,迁移前应核对实际使用的功能。
若页面无法访问,先确认本地网络本身可用,再检查节点参数、系统时间和日志错误。出现端口占用时,应排查是否还有另一份客户端正在运行;出现授权失败时,应检查系统权限;出现远端连接超时时,再检查服务器端口和传输设置。按层次排查可以避免把所有问题都归为安装包故障。
完成基本连接后,再逐项设置路由分流、DNS 或 TUN。每次只调整一个变量并保留上一次可用配置,便于判断变化带来的影响。具体界面操作可继续阅读快速上手,字段含义与规则结构可查阅配置大全。
更新前先导出重要配置,特别是手工维护的路由规则、DNS 设置、订阅分组和服务器参数。订阅可以重新获取节点,但不一定恢复客户端中的分组顺序、绕行列表或局部覆盖项。配置备份应保存在仅本人或获授权用户可访问的位置。
安装新版本前,先停止代理连接并退出旧程序。桌面端应确认托盘进程也已结束,避免旧进程占用文件或本地端口。安卓端若无法覆盖安装,应先检查签名和版本限制,而不是立即删除已有应用;卸载可能同时删除本地数据。
更新完成后,核对所选内核、入站端口、系统代理和路由模式,再进行一次实际访问测试。若新版本行为与原先不同,先对照保留的设置,不要反复导入订阅覆盖现场。需要回退时,也应保留新旧两份配置备份,避免跨版本直接覆盖造成进一步问题。
下载完成不等于安装完成,安装完成也不等于旧程序已退出。排查“更新后仍是旧界面”时,可先确认启动入口指向哪个应用目录。长期保留多份解压目录的用户,尤其需要区分当前运行位置与刚下载的文件位置。
安装包只提供客户端程序,不包含可用的服务器或订阅。安装完成后,需要导入有权使用的订阅地址或服务器配置,选择服务器,再设置系统代理或相应的流量接管方式。首次使用可按快速上手页面逐步完成。
先查看系统显示的处理器架构。Apple Silicon 选择 arm64,Intel Mac 选择 x64;Windows 本页提供 x64 包;Linux 同时区分架构与 deb、rpm 包格式。2015 年后的主流安卓手机通常可选 arm64,但仍应以设备支持的应用架构为准,无法确认时可选通用版。
建议先备份订阅分组、服务器配置、自定义路由规则和 DNS 设置,并记录当前内核与代理模式。退出客户端后再安装更新,保留原有配置备份直至确认连接正常。订阅地址和导出的配置可能包含访问凭据,不应公开分享。
先核对安装包对应的系统与处理器架构,再查看系统提示的具体原因。Windows 检查解压是否完整、运行环境和目录权限;macOS 在系统设置的隐私与安全性中查看拦截原因;Android 检查安装来源授权与现有应用签名;Linux 检查包格式及依赖。不要仅为启动程序而长期关闭系统安全功能。
需要同时满足订阅格式可识别、节点协议受支持和传输参数兼容三个条件。v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核,两者的协议与参数支持并不完全相同。导入成功不代表所有节点都能连接,应按订阅提供方说明选择客户端,并避免同时启用两款客户端的 VPN 连接。