V2rayU
V2rayU 是 macOS 上开源的 V2Ray 客户端，用 Xray 和 sing-box 双内核，需要 macOS 14 及以上。本页说明该下哪个文件、怎么导入订阅，以及四种运行模式的区别。
本站是非官方的 V2Ray 中文指南，与 V2rayU 开发者无关；下载链接都指向 GitHub 官方发布页。
- 系统要求
- macOS 14+
- 内核
- Xray · sing-box
- 价格
- 免费
- 开源协议
- GPL-3.0
- 官方仓库
- yanue/V2rayU ↗
按系统下载
正式版 v5.4.0 · 2026-10-30。下面的按钮都直接指向 GitHub 官方发布页里的文件，本站不提供安装包。
V2rayU 是什么
V2rayU 是 macOS 上的代理客户端：它常驻在菜单栏，把你导入的节点交给内核去连接，并负责设置系统代理、PAC、Tun 模式和路由规则。它本身不提供节点。
- 系统要求：macOS 14（Sonoma）及以上（v5.0.0 起）。
- 内核：Xray-core 和 sing-box。README 说明它会根据协议、传输方式和安全设置自动选择兼容的内核；Tun 模式由 sing-box 实现。
- 支持协议：VMess、VLESS、Trojan、Shadowsocks、SSR、SOCKS5、Hysteria、Hysteria2、TUIC、AnyTLS、Naive（README 列出）。
- VLESS Encryption：v5.3.2 起支持这类节点（需要 Xray-core 25.8.31 及以上）。
- 界面语言：简体中文、繁體中文、English。
仓库的几个分支
V2rayU 的 GitHub 仓库有点特别：默认分支叫「rm」，打开仓库首页几乎看不到内容。v5 的源码和说明在 main 分支，旧版 v4（基于 V2Ray 内核）在 master 分支。安装包统一在 Releases 里，本页的下载按钮也直接指向那里。
下载与安装
| 你的 Mac | 下载 |
|---|---|
| Apple 芯片（M1 及以后） | V2rayU-arm64.dmg |
| Intel 芯片 | V2rayU-64.dmg |
-
不确定芯片：点左上角苹果菜单 →「关于本机」，「芯片」写 Apple M 开头的是 Apple 芯片，「处理器」写 Intel 的是 Intel。
-
用上面「按系统下载」的按钮下载 dmg，打开后把 V2rayU 拖进「应用程序」。
-
第一次打开时如果提示无法验证开发者，到「系统设置」→「隐私与安全性」里点「仍要打开」。
-
打开后 V2rayU 会出现在屏幕右上角的菜单栏里。
导入订阅和节点
下面的名称取自 V2rayU 源码里的简体中文语言文件。
导入订阅：
-
在 V2rayU 的「订阅」里选「添加订阅」，「订阅地址」粘贴机场给的订阅地址并保存。
-
选「立即同步订阅」，节点会出现在「服务器」里。
导入单个节点： 复制 vless://、vmess:// 链接后，用「导入与分享」里的「从剪贴板导入服务器」；或者用「扫描屏幕二维码」。v5.4.0 起，机场网页上的 v2rayu://、clash://、sing-box:// 一键导入链接也能直接拉起 V2rayU，导入前会先确认。
导入后可以用「延迟测试」和 v5.4.0 新增的「下载测速」挑选节点。
四种运行模式
| 模式 | 作用（README 和界面说明） |
|---|---|
| 全局模式 | 设置系统 HTTP、HTTPS、SOCKS 代理，浏览器等程序自动走代理 |
| PAC 模式 | 设置系统 PAC 代理，按 PAC 规则判断直连还是走代理 |
| 手动模式 | 清除系统代理，需要自己在浏览器（例如配合 SwitchyOmega 插件）里设置 |
| Tun 模式 | 通过虚拟网卡实现透明的系统级代理，所有流量经 sing-box 转发 |
一般用全局模式加路由规则即可；有程序不走系统代理时再切到 Tun 模式。Tun 模式的原理和系统代理的区别见 TUN 模式（以 v2rayN 为例，原理相同）。
常用设置
- 开机启动：设置里的「开机启动」。
- 订阅自动更新：「自动从订阅更新服务器」。
- 自动选最快节点：「自动选择最快服务器」。
- 菜单栏显示延迟：「托盘图标显示延迟值」。
- 备份和换机：v5.4.0 起可以把节点、订阅、路由和设置打包成一个 zip，在新电脑上导入。
V2rayU 的官方地址是哪个？
只有 GitHub 仓库 github.com/yanue/V2rayU，安装包在它的 Releases。GitHub 上还有名字相近、README 照抄 V2rayU 介绍的其他仓库，以及自称「V2rayU 官网」的网站，都不是这个仓库，不要从那里下载。
PyPI 上的 v2rayU 是同一个软件吗？
不是。PyPI 上叫 v2rayU 的包是另一个项目（服务器端的多用户管理工具），和 macOS 客户端 V2rayU 无关。
V2rayU 支持 macOS 13 或更早的系统吗？
v5 系列从 v5.0.0 起只支持 macOS 14（Sonoma）及以上。系统更旧的 Mac 可以用 v2rayN（macOS 13.6 及以上）。
V2rayU 和 v2rayN 选哪个？
只用 Mac、喜欢菜单栏小工具选 V2rayU；同时在 Windows 上用、希望两边操作一样选 v2rayN。两者都开源免费，订阅地址通用。对比见 V2Ray Mac 客户端。
从 V2rayU v4 升级到 v5 会丢失节点吗？
v5 改用 SQLite 存数据，提供了「导入 v4 数据」功能，可以把旧版的服务器和订阅导入新版；v5.3.2 的发布说明还写明会一并迁移路由规则。
V2rayU 的日志和配置文件在哪里？
README 列出的位置：应用日志 ~/.V2rayU/V2rayU.log，内核日志 ~/.V2rayU/core.log，Tun 日志 ~/.V2rayU/tun.log，当前内核配置 ~/.V2rayU/config.json。
打开时提示「无法验证开发者」？
打开「系统设置」→「隐私与安全性」，在页面下方找到 V2rayU，点「仍要打开」。