V2rayU
macOS 菜单栏上的 V2Ray 轻骑兵——不打扰，却始终在线
V2rayU 是一款专为 macOS 设计的 V2Ray 客户端。它不像 ClashX 那样拥有复杂的策略组体系，也不像 Surge 那样集成了抓包和重写，但它用最朴素的方式完成了代理工具最本质的使命：在菜单栏安静地驻留，用最小的资源占用提供稳定、快速的连接。如果你对 macOS 上的代理客户端感到眼花缭乱，V2rayU 就是那个“刚刚好”的选择——它简单，但绝不简陋。
对代理还不太熟悉？请先阅读 什么是“机场”？ 和 Clash 使用教程 建立基础。等你明白了节点、订阅和分流的关系，V2rayU 就是你 Mac 菜单栏上那枚不声不响，却从不断线的网络哨兵。
一个极简的定义：
V2rayU = macOS 原生菜单栏应用 + V2Ray 内核 + 纯粹的代理连接体验
它自身不提供任何代理节点，必须通过机场订阅链接、手动添加服务器或扫码来获得“航线”。与 v2rayN 在 Windows 上的定位类似，V2rayU 专注于 V2Ray 协议本身，没有 Clash 那样的规则策略组，也没有 Surge 那种脚本重写，但它把“连接”这件事做到了极致：启动快、占用低、稳定可靠。
它的工作流程清晰而直接：
机场订阅 / 手动节点
↓
导入 V2rayU
↓
V2Ray 核心接管
↓
按预设模式（全局/PAC/手动）分流
↓
目标服务器
在 macOS 代理客户端层出不穷的今天，V2rayU 依然有一群忠实拥趸，靠的是以下优点：
与 ClashX 一样，V2rayU 驻留在 macOS 菜单栏，没有独立的大窗口。点击图标即可展开节点列表、切换模式、管理订阅。对于追求 Dock 栏干净、桌面整洁的用户来说，这种交互方式非常自然。它会安静地待在右上角，只有你需要它时才出现。
V2rayU 使用原汁原味的 V2Ray 内核，对 V2Ray 系协议的支持非常完善：
- VMess（V2Ray 经典协议）
- VLESS（包括 XTLS-Vision 等新特性，取决于内核版本）
- Trojan
- Shadowsocks
- Socks5 / HTTP 代理
虽然它的协议列表不如 Sing-Box 那样覆盖了 Hysteria2 和 TUIC，但对于绝大多数使用 V2Ray 系节点的用户来说，已经绰绰有余。
V2rayU 的实现非常精简，没有多余的界面框架，因此启动速度和资源占用都控制得很好。在旧的 MacBook Air 或 Mac mini 上也能流畅运行。它的后台连接极其稳定，很少出现无故断开的问题，适合需要长时间挂机的场景。
V2rayU 内置了 PAC 模式（基于代理自动配置脚本），可以根据国内 IP 库自动判断哪些流量走代理、哪些直连。相比全局模式，PAC 模式能大幅提升国内网站的访问速度，同时保持国外服务的可达性。如果你需要更精细的按域名分流，可以和 ClashX Pro 配合使用。
V2rayU 是开源项目，代码托管在 GitHub，社区开发者持续维护。用户可以免费使用全部功能，无需付费或订阅。
V2rayU 的安装包通常以 .dmg 格式发布，你可以在其官方 GitHub 仓库找到，或者通过我们维护的资源页面统一获取：
📦 Clashforwinodws 官方 Releases 页面
▲ 该页面汇总了本 Wiki 涉及的多款客户端资源。在 Releases 列表中找到 V2rayU 开头的 .dmg 文件下载即可（如果没有，可前往 V2rayU 的原作者仓库获取）。
安装步骤：
- 下载
.dmg文件，打开后将 V2rayU 图标拖入「应用程序」文件夹。 - 首次启动时，macOS 会弹出安全提示，前往「系统设置 - 隐私与安全性」中点击「仍要打开」。
- 启动后，菜单栏右上角会出现 V2rayU 的图标（通常是一个飞机或 V 字图标），点击即可展开菜单。
▲ 菜单栏上的小图标，就是你与 V2rayU 的全部交互入口
机场提供的 V2Ray 订阅链接是批量添加节点的标准方式：
https://your-airport.com/sub?target=v2ray&token=xxxx在 V2rayU 中操作：
- 点击菜单栏图标，选择 订阅 → 订阅设置。
- 在弹出窗口中点击“添加”，粘贴订阅链接，可自定义备注名称。
- 点击“确定”后，回到菜单栏图标，选择 订阅 → 更新订阅。
- 节点更新完毕后，在菜单栏的服务器列表中即可看到所有节点。
▲ 订阅管理窗口简洁明了，支持多机场共存
如果订阅下载失败，请参考 Clash 使用教程 中的订阅排错部分，关于 User-Agent 和链接格式的解决方法在 V2rayU 中同样适用。
V2rayU 的所有功能都集成在菜单栏图标的下拉菜单中，没有独立的主窗口。菜单结构如下：
菜单顶部是所有节点的列表，按导入顺序或延迟排序。每个节点前面有一个圆点，绿色代表当前选中，灰色代表未选中。点击节点名称即可切换，同时该节点会被设为活动服务器。
菜单中部提供了三种代理模式的快速切换：
- 全局模式：所有流量走代理。
- PAC 模式：国内直连，国外走代理（推荐）。
- 手动模式：只使用系统代理设置，不自动分流。
通过菜单可以快速更新订阅、添加新订阅、删除旧订阅。订阅更新时，菜单栏图标会显示旋转动画。
点击菜单底部的“设置”进入偏好设置，可调整：
- 本地端口：HTTP/SOCKS5 代理端口。
- 开机自启：是否随系统启动。
- 自动更新订阅：设置定时更新间隔。
- 协议与传输配置：手动添加节点时的详细参数。
菜单中提供“查看日志”选项，可以打开实时日志窗口，查看连接过程中的详细信息，用于排查问题。
| 模式 | 行为 | 适用场景 |
|---|---|---|
| 全局模式 | 所有流量走代理 | 需要统一 IP、测试节点 |
| PAC 模式 | 国内 IP 直连，境外 IP 走代理 | 日常使用，最推荐 |
| 手动模式 | 仅设置系统代理，不做自动分流 | 需要精细控制时（可搭配其他工具） |
绝大多数情况下，保持 PAC 模式 就能获得很好的平衡：国内网站如淘宝、B站直连，速度快；国外网站如 Google、GitHub 走代理，稳定可达。如果你需要按域名或应用进行更精细的分流，可以搭配 ClashX Pro 的规则引擎使用。
V2rayU 使用 V2Ray 核心的标准 JSON 配置格式，与 v2rayN 的节点定义部分互通。你可以将 v2rayN 导出的节点链接（vmess://、vless:// 等）直接粘贴到 V2rayU 中导入，或者通过二维码扫描功能添加节点。反过来，V2rayU 的节点也可以导出为链接，在其他 V2Ray 生态客户端中使用。
一个典型的 VMess 节点链接示例：
vmess://eyJ2IjoiMiIsInBzIjoi5L+u5a6a6IqC54K5Iiw...
在 V2rayU 中，你可以直接从剪贴板导入这样的链接，无需手动填写任何字段。如果你有 Clash 配置想要转换为 V2Ray 节点，可以使用在线转换工具或参考 Clash 使用教程 中的转换部分。
V2rayU 虽然专注于 V2Ray 协议，但它与 Clash 生态的配合非常自然：
- 你可以在 Mac 上用 V2rayU 作为日常轻量连接器，同时在 iPhone 上使用 Quantumult X 或 Surge 作为移动端主力，通过同一份机场订阅保持节点同步。
- 如果你需要复杂的规则分流和重写功能，可以使用 ClashX Pro 作为主力，而用 V2rayU 作为备用或快速测试工具。
- 在 Windows 上，你还可以使用 v2rayN 或 WinXray，这些工具与 V2rayU 的节点格式兼容，可以互相导入导出。
其他可搭配的客户端还包括 Sing-Box、 Hiddify Next、 karing 等。 这种多工具协同的自由，正是 Clash 发展史 中开放生态带来的红利。
- 确认菜单栏中已选中有效节点（节点前有绿点）。
- 尝试切换到 全局模式，如果能上网则说明 PAC 规则需要更新。
- 检查系统代理设置是否被其他 VPN 软件篡改。
- 检查订阅链接是否完整，是否包含
token=参数。 - 在浏览器中直接打开链接，确认能返回节点文本。
- 部分机场对 User-Agent 有限制，可在 V2rayU 设置中自定义 UA。
- macOS 的终端默认不遵循系统代理。你可以在终端中手动设置环境变量：
export https_proxy=http://127.0.0.1:1087。 - V2rayU 的本地端口默认可能是 1087（HTTP）和 1086（SOCKS5），请以设置中为准。
- 将「应用程序」文件夹中的 V2rayU 拖入废纸篓，然后删除
~/Library/Application Support/V2rayU目录即可。
| V2rayU | ClashX | ClashX Pro | |
|---|---|---|---|
| 内核 | V2Ray | Clash Premium | Clash.Meta |
| 协议支持 | VMess, VLESS, Trojan, SS 等 | SS, VMess, Trojan 等（Premium 内核） | VLESS, Hysteria2, TUIC 等 Meta 全协议 |
| 规则引擎 | PAC / 全局 / 手动 | 完整 Clash 规则引擎 | 完整 Clash.Meta 规则引擎 + TUN |
| 交互方式 | 纯菜单栏 | 纯菜单栏 | 菜单栏 + 可选仪表板 |
| 适合用户 | 使用 V2Ray 节点、追求轻量稳定的用户 | 传统 Clash 用户、喜欢菜单栏操作 | 需要新协议和完整系统接管的专业用户 |
如果你主要使用 VLESS 或 VMess 节点，且不需要复杂的规则策略，V2rayU 是 macOS 上最省心的选择。如果你已经深度使用 Clash 生态，并且需要一套规则同时管理多个机场和自建节点，那么 ClashX Pro 会更合适。两者可以共存，按需切换。
V2rayU 是 macOS 上那把低调而锋利的 V2Ray 军刀。它没有华丽的外壳，也没有繁复的功能，却用最纯粹的方式解决了最核心的需求：稳定、快速、安静地连接你需要的网络。
开始使用 V2rayU 只需三步：
下载 .dmg 安装 → 导入机场订阅 → 菜单栏选择节点，点击开启
之后，它就会一直待在右上角，像 macOS 自带的功能一样默默工作。如果你想探索更丰富的分流规则或协议支持，本 Wiki 中的其他客户端指南会为你打开更大的世界。
—— 下一篇推荐：WinXray 使用指南，看 Windows 平台如何用同样纯粹的方式完成一键代理。
本文档由
Clashforwinodws/Clash-for-Winodows
社区维护
页面地址：
https://clashforwinodws.github.io/Clash-for-Winodows/