V2rayU

Mac 服务器、订阅、核心切换与诊断教程

一、软件介绍与系统准备

V2rayU 是原生 macOS 菜单栏客户端，5.x 使用 SwiftUI 与 SQLite，支持 Xray、sing-box、TUN、流量统计、诊断以及多种协议。官方 5.x 发布说明要求 macOS 14 Sonoma 或更高版本。升级用户应先从 v4 导出或记录服务器和订阅；即使 v5 支持导入旧数据，也不要把唯一副本交给自动迁移。

从官方 GitHub Releases 下载与芯片对应的 DMG，也可使用项目提供的 Homebrew Cask。打开 DMG 后拖入“应用程序”，首次启动按系统提示允许网络扩展、代理或 TUN 权限；遇到拦截时只在“隐私与安全性”核对应用名称后放行。不要混装 v4 与 v5 后同时启动，也不要运行第三方破解包。

添加配置前退出其他系统代理和 VPN，记录当前 DNS 与代理。服务入口 https://ss.6nn.net/ 只有提供 V2rayU 能解析的协议或订阅时才能使用。订阅、服务器、UUID、证书与日志属于敏感信息，公开截图前必须遮蔽。

二、安装、配置与连接步骤

1. 打开服务器页

启动 V2rayU 后进入 Servers，检查左侧核心状态、服务器列表和菜单栏图标。若旧数据未出现，先使用官方迁移入口，不要覆盖旧数据库。

图1　步骤1：在 Servers 页面检查核心状态与服务器列表。

2. 新增或编辑服务器

点击新增或编辑，按实际协议填写地址、端口、用户 ID、加密、TLS 和传输方式；保存后先选择一条服务器做最小测试。

图2　步骤2：新增或编辑服务器，并核对协议参数。

3. 添加订阅并更新

进入 Subscription 新增自己合法取得的 URL，执行更新后检查节点数量、名称和协议；失败时先在浏览器验证返回内容。

图3　步骤3：在 Subscription 页面添加订阅并执行更新。

4. 选择核心并连接

在设置中选择兼容核心，路由先用规则模式，DNS 与 TUN 保持默认。回到菜单栏选定服务器并启动系统代理。

图4　步骤4：选择兼容核心、目标服务器与规则模式后连接。

5. 运行诊断

打开 Diagnostics，依次检查核心、端口、DNS 和路由；再用浏览器与终端验证 HTTPS、域名和出口。需要全局接管时才启用 TUN。

图5　步骤5：使用 Diagnostics 检查核心、端口、DNS 与路由。

三、连接与连通性测试

先用系统代理模式启动，观察菜单栏速度、Ping 与流量是否变化，再访问 https://ss.6nn.net/ 和合规 IP 查询页。Diagnostics 应显示核心与端口正常；浏览器和终端测试结果应一致。确需 TUN 时，在基础模式通过后再启用，并确认系统授权。停止后检查系统代理、DNS 和 VPN/TUN 状态已经恢复。

四、常见问题与排查

v5 无法启动时先确认 macOS 14+ 与芯片包正确。旧配置不见时使用官方迁移入口或重新添加订阅，不要删除旧数据库。TUN 已开但断网时关闭 TUN、恢复系统 DNS，先验证系统代理模式。切换核心后节点失败时检查协议是否受该核心支持。菜单栏无速度时确认核心已启动并查看诊断日志。

五、安全使用与维护

建议先选一个节点、一个核心和默认规则建立基线，再逐步启用订阅、DNS 或 TUN。更新前备份数据库与配置，记录客户端版本、芯片、核心版本、端口、出口、Ping 和错误时间。休眠唤醒、切换网络和重启系统后各验证一次自动恢复；若菜单栏状态与实际出口不一致，应先停止核心再重新启动。每次只修改一个项目，并在完全停止代理后复测；提交日志时删除地址、账号、UUID 与授权头。

不要为了兼容旧版同时运行两个 V2rayU，也不要安装陌生证书或长期关闭 macOS 安全功能。仅在合法、获授权的网络环境中使用。

六、参考与下载来源

V2rayU 官方仓库：https://github.com/yanue/V2rayU

V2rayU 官方 Releases：https://github.com/yanue/V2rayU/releases

Homebrew Cask：v2rayu：https://formulae.brew.sh/cask/v2rayu

配套线路与服务入口：https://ss.6nn.net/

资料核验日期：2026-09-04　｜　正文中文字符数：842