v2rayN
首推 7.24.1Desktop 桌面版使用新一代跨平台 UI;WPF 版保留经典稳定的 Windows 界面。两种界面都用于管理连接配置、订阅与代理设置,选择依据是使用习惯和系统兼容情况,不是连接速度。
按系统选客户端,再选架构与包格式。桌面使用 v2rayN;安卓优先 v2rayNG,另提供 v2flyNG 备选。
本页提供 x64 安装入口。先在“设置 → 系统 → 系统信息”确认系统类型,再选择界面版本。
Desktop 桌面版使用新一代跨平台 UI;WPF 版保留经典稳定的 Windows 界面。两种界面都用于管理连接配置、订阅与代理设置,选择依据是使用习惯和系统兼容情况,不是连接速度。
| 检查项 | 选择依据 |
|---|---|
| 处理器架构 | 本页两个包均为 x64;32 位系统不能直接使用。ARM 设备应先确认系统的 x64 应用兼容能力。 |
| 系统环境 | 优先在仍获系统更新的 Windows 环境使用;具体系统与运行环境要求以所选安装程序提示为准。 |
| 安装位置 | 使用当前账户可访问的位置,完整解压后运行,不要直接在压缩包预览窗口中启动程序。 |
| 权限与代理 | 常规系统代理与 TUN 的权限需求不同。只有启用需要提升权限的功能时,才按提示授权。 |
安装后先打开主窗口,导入订阅并选择一个服务器。需要浏览器使用代理时,在“系统代理”中选择“自动配置系统代理”,再核对“设置 → 参数设置”里的本地混合监听端口。端口以当前客户端显示为准,不能只照抄其他教程中的数字。若浏览器有独立代理扩展,也要检查它是否覆盖了系统设置。
从旧版迁移时,先备份订阅分组和自定义路由,再关闭旧进程。不要同时打开 Desktop 与 WPF 来测试同一个端口,否则端口占用与系统代理写入会混在一起。先确认新版本能正常连接,再处理旧目录。后续连接步骤见系统代理教程。
打开苹果菜单中的“关于本机”。显示 Apple 芯片时选 Apple Silicon;显示 Intel 处理器时选 Intel。
macOS 使用桌面界面。安装包按处理器架构区分,订阅管理与路由配置的基本思路相同;系统代理和权限提示则由 macOS 管理,不应照搬 Windows 的系统设置路径。
| 检查项 | 选择依据 |
|---|---|
| 处理器架构 | Apple 芯片选 arm64;Intel 处理器选 x64。以“关于本机”显示的信息为准。 |
| 系统环境 | 使用仍获系统更新的 macOS;所需最低版本以当前安装包或应用启动提示为准。 |
| 安装格式 | 打开 DMG 后按窗口指引安装到“应用程序”,不要长期从挂载的磁盘映像中运行。 |
| 网络权限 | 按功能需要处理系统提示;先确认系统代理,再考虑是否需要启用 TUN。 |
初次启动如果被系统阻止,先核对系统弹窗中的应用名称、下载来源与具体原因,再查看“系统设置 → 隐私与安全性”中的相关提示。不要用批量关闭系统安全机制的方式绕过提示,也不要在不清楚作用的情况下复制终端命令。架构选错和权限未授予是不同问题,应分开处理。
安装完成后,先导入已有配置,再选定服务器。系统代理启用后,部分应用仍可能沿用自己的代理设置;终端程序也不一定自动读取系统代理。验证时先使用遵循系统设置的浏览器,并观察客户端日志。若停止使用客户端,先清除系统代理,再退出应用,避免系统仍指向已经关闭的本地监听端口。
2015 年后的主流手机优先选择 arm64;不确定设备架构时可用通用版。设备系统是否支持该架构仍是最终依据。
使用 Xray 内核的安卓图形客户端。首次配置可先选 v2rayNG,再按订阅提供的连接参数导入;具体协议与传输功能要以当前客户端和服务端配置的共同支持情况为准。
使用 V2Fly 内核的安卓备选客户端。适合已有兼容配置、希望使用该内核生态的场景。不要假定两款应用支持的全部参数完全相同,迁移前应检查订阅格式与传输设置。
| 检查项 | 选择依据 |
|---|---|
| 处理器与系统架构 | arm64 对应 arm64-v8a;硬件支持 64 位不等于所装系统一定提供 64 位应用环境。 |
| 系统版本 | 最低 Android 版本以当前 APK 的安装提示为准;通用版并不能解决系统版本过低的问题。 |
| 安装权限 | 只为用于打开 APK 的浏览器或文件管理器按需允许安装,完成后可撤销该来源权限。 |
| 连接授权 | 启动代理时按系统提示确认 VPN 连接;通常不能同时运行两个占用系统 VPN 通道的应用。 |
安装成功不等于已经导入连接。打开客户端后添加订阅分组,粘贴已有订阅地址并执行更新,再选择一个配置启动。系统首次请求 VPN 授权时,先确认发起请求的是当前客户端。连接标识只说明系统建立了本地 VPN 通道,不能单独证明远端服务器可用,仍需实际访问并查看日志。
如果锁屏后连接中断,先检查电池优化和后台运行限制,不要反复更换 APK 来处理后台调度问题。若安装提示与已有应用冲突,可能与签名或安装来源有关,先备份配置再判断是否需要卸载;直接卸载通常会丢失应用内数据。两款应用切换测试时,保持相同节点与网络条件,便于区分客户端设置和服务器问题。
先确定发行版的包管理格式,再确认 CPU 架构。文件扩展名与架构都要匹配,不能只看客户端名称。
Linux 桌面版提供 deb 与 rpm 两类安装包。优先使用发行版自带的软件安装工具处理依赖,安装后从应用菜单启动。下面两个主入口均为 x64,arm64 设备使用对应的小字入口。
| 检查项 | 选择依据 |
|---|---|
| 桌面环境 | 本页提供图形客户端,需具备可运行桌面应用的会话环境,不是服务器命令行部署包。 |
| 架构名称 | amd64 与 x86_64 对应本页 x64 包;arm64 与 aarch64 对应本页 arm64 包。 |
| 发行版与依赖 | deb、rpm 仅是格式分类,具体系统库和版本依赖需由包管理器检查,不建议强制忽略依赖安装。 |
| 代理与权限 | 桌面系统代理只影响遵循该设置的应用;TUN 需要额外权限与环境支持,不能与系统代理视为同一功能。 |
安装器报告缺少依赖时,先保留完整错误信息,再查看所用发行版版本是否满足要求。不要把其他发行版的系统库随意复制到本机,也不要通过修改扩展名把 rpm 当成 deb 安装。图形应用无法启动时,可以先检查桌面会话、文件访问权限与已有进程,避免将所有启动问题都归因于连接配置。
连接验证从最小范围开始:先导入一个可用配置,确认内核能启动,再在一个明确使用代理的应用中测试。桌面代理、浏览器独立代理、终端环境变量可能分别生效,修改其中一项不会自动改写其他项。启用 TUN 前先完成普通代理验证;若只有特定应用无法访问,优先检查该应用的代理读取方式,而不是重新安装整个客户端。
安装之后
已有配置的设备,更新前保留订阅分组、自定义路由、DNS 设置和本地端口记录。备份中可能含有连接凭据,应存放在个人可控的位置,不要发送到公开讨论区。更换界面版本、安装来源或客户端名称时,不能假定配置会自动迁移;完成导入后逐项检查,再移除旧版本。
安装包提供的是客户端,不包含可用订阅。添加已有订阅并更新后,选中一个服务器进行测试。Tcping 用于观察目标端口连通情况,真连接测试更接近实际代理请求;两者都不能保证所有网站始终可用。测试失败时先核对订阅有效期、系统时间和节点参数,不必马上改动路由与 DNS。
先确认普通系统代理能正常工作,再按需要配置分流或 TUN。每次调整后记录设置项和结果,避免同时改端口、DNS 与路由导致原因难以判断。退出客户端前检查系统代理是否已经恢复;网页突然无法访问时,也要确认系统没有继续指向已关闭的本地端口。
配置流程见订阅导入与首次连接教程;已经安装但无法访问时,转到v2rayN 问题诊断,按症状排查。
下载相关问题
首次安装可先选 Desktop 桌面版,它使用新一代跨平台界面。习惯经典 Windows 界面可选 WPF 版。两者都要导入连接配置;切换前先备份现有配置,不要同时开启两个客户端的系统代理或 TUN 模式。
2015 年后的主流手机优先尝试 arm64,但仍要以设备系统实际支持的架构为准。不确定架构或 arm64 提示不兼容时,可选通用版。通用版包含更多架构,通常文件更大;换包之前先确认系统版本与可用存储空间。
版本文本与各架构安装包路径来自清单的不同字段,更新进度可能不同。本页保留清单给出的文件名,不根据版本文字推算地址。安装后的实际版本以客户端关于页面为准;不要手动改写下载地址中的版本数字。
客户端安装包不包含可用的连接配置。需要导入已有订阅或节点,更新订阅后选择服务器,再按应用需要开启系统代理或 TUN 模式。先测试单个节点,再核对监听端口、路由预设与浏览器代理设置。
保留订阅分组、自定义路由、DNS 设置和本地端口记录,备份文件应存放在个人可控位置。先退出客户端再更新,完成后检查配置是否正确迁移。不要同时启动旧版和新版,也不要在公开截图中展示订阅地址或连接凭据。
下载中断时先检查浏览器下载记录、磁盘空间与当前网络,再重新下载对应安装包。安装失败时记录完整提示,确认系统、处理器架构和包格式一致。不要通过关闭全部安全防护来处理问题;已有客户端的代理残留也应单独检查。