v2rayN
首推7.24.1 · Windows x64
客户端安装包 / 系统与架构
v2rayN 桌面版,v2rayNG 与 v2flyNG 安卓版。
先选系统,再核对芯片架构。版本文字位于客户端卡片内,安装说明紧随对应入口。
同一款 v2rayN,两种界面。首次安装先选 Desktop;沿用经典界面可选 WPF。
7.24.1 · Windows x64
| 核对项 | 选择依据 | 安装前操作 |
|---|---|---|
| 系统与架构 | 本页提供 Windows x64 包 | 在“设置 → 系统 → 系统信息”中查看系统类型。 |
| 运行环境 | 以所选版本提示的运行时要求为准 | 启动提示缺少运行组件时,先补齐对应架构的组件。 |
| 使用权限 | 常规系统代理通常不需要管理员权限 | 启用 TUN 时,再按客户端提示授予所需权限。 |
下载完成后,把压缩包解压到可写目录,不要直接在压缩软件的预览窗口内运行安装程序。若系统提示程序正在使用,先退出托盘中的 v2rayN,再检查是否仍有旧实例运行。Desktop 与 WPF 的配置读取位置、迁移方式可能随版本变化;切换界面前先导出配置,不要直接覆盖旧目录。
首次打开时先导入订阅或服务器参数,选中要使用的配置,再设置“自动配置系统代理”。系统代理只影响遵循该设置的应用;浏览器可用并不等于所有程序都会被接管。需要虚拟网卡处理更多程序流量时,再阅读TUN 模式说明,不要在首次启动时同时改动路由、DNS 和网络模式。
如果界面能启动而连接失败,应先看日志中的具体错误。缺少运行组件、服务端不可达和订阅字段不兼容是不同问题。重复安装同一个包通常不会修复服务器参数错误,也不会为客户端补充连接配置。
使用 v2rayN。打开“关于本机”查看芯片名称,再选择对应的 DMG。
7.24.1 · macOS
| 核对项 | 选择依据 | 安装前操作 |
|---|---|---|
| 芯片 | Apple Silicon 为 arm64;Intel 为 x64 | 在系统菜单中打开“关于本机”。 |
| 系统版本 | 以当前应用包的最低系统要求为准 | 确认系统版本满足要求后再安装。 |
| 网络权限 | 系统代理与 TUN 的授权需求不同 | 仅在使用对应功能时处理系统授权提示。 |
打开 DMG 后,按安装窗口提示把应用放入“应用程序”目录,再从该目录启动。不要长期从挂载的磁盘映像中运行应用,否则更新和权限处理可能与预期不同。安装结束后可以推出磁盘映像,下载的 DMG 只作为安装介质保留。
如果系统阻止首次打开,先确认下载来源及提示内容,再按系统提供的入口处理。不要为了运行一个应用而关闭整套系统安全机制。遇到“不兼容”提示时,优先核对芯片架构与系统版本;权限提示、架构不匹配和文件尚未下载完成不能用同一种操作解决。
导入配置后,先在默认网络模式下检查连接。某些应用自带独立代理设置,另一些应用不读取系统代理;切换系统代理后,需要在目标应用中重新建立连接再测试。退出客户端前应恢复合适的系统代理状态,避免系统继续把请求发往已经停止的本地监听端口。
先选 v2rayNG。需要 V2Fly 内核兼容路径时,再考虑 v2flyNG。
2.2.6 · Android
1.10.31 · Android
| 核对项 | 选择依据 | 安装前操作 |
|---|---|---|
| 架构 | arm64 或通用版 | 查看设备系统架构,无法确定时先选通用版。 |
| 系统兼容 | 以 APK 声明的最低系统要求为准 | 保留足够存储空间,确认下载已经完成。 |
| 安装权限 | 只为当前使用的下载或文件管理应用授权 | 按系统提示允许安装,结束后可关闭该来源权限。 |
| 连接权限 | 启动 VPN 模式时由系统确认 | 阅读授权提示;同一用户空间通常只保留一个活动 VPN。 |
手机使用 64 位处理器,不一定代表系统支持 64 位应用。若 arm64 包无法安装,不要反复点击同一个文件;先核对系统 ABI,再尝试适合的通用版。若安装提示与现有应用冲突,应检查签名来源及版本关系。不要直接卸载旧应用来绕过提示,卸载可能同时移除本地配置。
首次启动后,从剪贴板、二维码或订阅分组入口导入配置,检查服务器地址、端口及传输设置,再启动 VPN。系统出现连接授权弹窗属于建立 VPN 通道的步骤,不代表远端服务器已经连通。需要分别验证域名解析、目标应用访问和日志状态。
后台连接被系统结束时,可检查电池优化、后台运行限制和其他 VPN 应用,而不是立即更换安装包。v2rayNG 与 v2flyNG 的菜单和字段支持并不完全一致;切换前保留原始订阅,不要把某个客户端导出的专用配置当成另一款客户端必然可读的格式。
使用 v2rayN 图形客户端。先区分 deb 与 rpm,再确认 x64 或 arm64。
7.24.1 · Linux
| 核对项 | 选择依据 | 安装前操作 |
|---|---|---|
| 包格式 | deb 或 rpm | 在系统信息与软件管理器中确认发行版体系。 |
| 处理器 | x64 对应 amd64 / x86_64;arm64 对应 aarch64 | 不能只按发行版名称判断架构。 |
| 桌面环境 | 需要可运行图形应用的桌面会话 | 确认显示环境和安装器所列依赖完整。 |
| 系统兼容 | 包格式相同不代表所有发行版版本都兼容 | 依赖无法满足时先核对系统版本,不强制忽略依赖。 |
deb 与 rpm 是软件包格式,不是代理协议。下载后用发行版自带的软件安装器打开,查看它列出的依赖和安装位置,再确认安装。包名中的 amd64 与 x86_64 都表示常见的 x64 架构;arm64 与 aarch64 则表示另一类处理器架构,两者不能互换。
Linux 桌面环境对系统代理的读取方式并不完全一致。客户端设置系统代理后,某些应用仍可能使用自身的网络选项;先在目标应用里确认实际代理路径,再判断是否需要 TUN。不要为方便而长期以高权限运行整个图形客户端,按功能需求处理必要的授权即可。
如果安装器报告依赖不满足,先保存原有配置并查看具体依赖名称。把 rpm 改扩展名为 deb、强行跳过依赖或重复安装都不能解决二进制兼容问题。升级时建议保持同一包管理渠道,避免手动解压副本与已安装应用并存后,启动了错误的程序版本。
安装之后
安装包解决程序部署,连接仍取决于配置。先验证最小路径,再调整分流与 DNS。
客户端不附带可用的服务器。准备有权使用的订阅地址、分享链接或手动参数,在导入前核对格式与客户端支持情况。订阅地址中的路径和查询参数可能包含凭据,不应出现在公开截图或求助记录中。
导入后检查地址、端口、协议、传输和 TLS 设置。能够显示在列表中只代表解析成功;服务端状态、认证参数与传输组合仍需实际连接验证。排查时保留一份原始配置,避免多次修改后失去对照。
查看导入与连接教程 →桌面系统先从系统代理开始,Android 则通过客户端的 VPN 模式建立本地接管路径。接管方式决定哪些应用流量进入客户端;路由规则再决定这些流量走代理、直连还是阻断,两者不是同一个开关。
首次连接只改必要参数,确认访问与日志正常后,再逐项加入订阅分组、域名规则和 DNS 策略。出现异常时,一次回退一项更容易定位原因。需要了解规则顺序或自定义出站时,再转到进阶配置。
查看路由与 DNS 配置 →安装包只提供客户端程序,不包含可用的服务器连接配置。需要自行准备有权使用的订阅链接或服务器参数,导入后选择配置,再设置系统代理或 VPN 模式。订阅地址可能包含访问凭据,不要公开分享。
首次安装可先选桌面版 Desktop,它采用新一代跨平台界面。经典 WPF 版是 Windows 下的经典稳定版,适合已经熟悉原有界面的用户。两者都是 v2rayN;本页的两个 Windows 入口均为 x64 安装包,不要把它们当作不同处理器架构。
2015 年后的主流手机通常可先选 arm64,但最终仍以系统支持的 ABI 为准。较旧设备或无法确定架构时可选通用版。处理器支持 64 位不一定表示系统也是 64 位;出现无法安装或解析软件包错误时,应同时检查系统版本、剩余空间与现有应用签名。
v2rayNG 使用 Xray 内核,是本页 Android 的首推选择;v2flyNG 使用 V2Fly 内核,作为备选。应按现有配置需要的协议、传输与字段支持选择,不能仅凭分享链接能够导入就认定所有参数都可运行。切换客户端前保留原有配置,并停止另一个应用的 VPN 连接。
版本文字和安装包入口来自清单中的不同字段,更新时间可能不一致。页面会分别读取对应字段,不把文件名里的数字改写成版本标签。若发现两者不同,先保留现有配置,下载后查看应用内的关于信息,再判断是否执行更新。
先使用客户端提供的导出或备份功能,保留服务器配置、订阅分组、路由规则和自定义 DNS 设置。关闭正在运行的旧进程,再安装同一来源、同一架构的新包。跨界面版本或跨客户端迁移时,不要默认配置目录与所有字段都兼容;先验证新版本,再清理旧副本。