Clash Verge Rev Service Mode 安装失败，不要直接改订阅或 YAML。这个报错发生在系统服务层：Windows 要把 clash-verge-service.exe 注册成服务，macOS 要安装 helper/LaunchDaemon；这些动作失败时，Mihomo 还没进入真正的 TUN 路由阶段。

这篇只按官方仓库、v2.5.1 Release 和 Clash Verge Rev 文档整理。没有覆盖企业安全软件策略、公司 MDM、非官方二次打包版本，也不把社区 issue 里的个例写成官方结论。

安装失败和启动失败不是同一件事

先把现象分清楚。Service Mode 的安装失败，通常出现在点击安装、更新服务或授权 helper 的阶段；启动失败则是服务已经装上，但无法拉起 Mihomo 或 TUN。

你看到的现象更可能卡在哪里该看的位置
点安装后立刻失败安装包不完整、权限不足、旧服务残留安装目录、系统服务、官方卸载命令
Windows 服务列表找不到相关服务install-service.exe 没运行成功services.msc、PowerShell、事件查看器
macOS 反复要求授权 helperapp 路径、旧 LaunchDaemon、系统后台项目/Applications、/Library/LaunchDaemons、系统设置
服务能安装但 TUN 打不开Mihomo/TUN 启动阶段logs/service、防火墙、TUN 配置
更新后原本正常的服务失效版本升级、旧服务路径残留Release 版本、卸载后重装服务

Clash Verge Rev 文档把服务模式解释为独立于 CVR 应用之外的 clash-verge-service 进程；它拿到管理员授权后，用来拉起需要更高权限的服务。也就是说，服务模式不是订阅格式转换器，不会修复节点为空、策略组缺失或 YAML 字段错误。

版本和安装包来源先收紧

官方仓库说明 Clash Verge Rev 是基于 Tauri 的 Mihomo GUI，面向 Windows、macOS 和 Linux。GitHub Release 页面标记 v2.5.1 发布于 2026-05-20；Release 说明里也写了 Windows 不再支持 Win7，并分别提供 Windows x64/ARM64 setup、macOS Apple M 芯片和 Intel 芯片 dmg。

Windows 侧不要拿 resources 目录里的单个 exe 拼安装。官方安装文档列出的 Windows 文件清单里，服务模式相关文件包括：

  • clash-verge-service.exe
  • install-service.exe
  • uninstall-service.exe
  • verge-mihomo.exe
  • verge-mihomo-alpha.exe

缺任何一个，都先回到 GitHub Release 重新安装。下载源不明、解压残缺、同步盘搬移安装目录，都会让服务安装阶段找不到正确文件。

macOS 侧同样要从 dmg 正常安装到 /Applications。官方安装文档写明当前 macOS 支持 MacOS 12 及以上；macOS 11 用户需要自行替换带 go124 标签的 Mihomo 内核，但这不是推荐路径。Service Mode 安装失败时，不建议在 macOS 11 上继续堆补丁排查，先升级系统或退回不依赖 TUN 的普通系统代理模式。

Windows：看服务注册，不看按钮颜色

Windows 上点击安装 Service Mode 后，客户端按钮显示失败只是第一层提示。系统有没有真实注册服务，要到系统里看。

打开管理员 PowerShell：

Get-Service | Where-Object {$_.Name -match "clash|verge|mihomo"}

如果没有任何结果，说明安装动作没有成功写入 Windows Service。下一步看三件事：

  1. Clash Verge Rev 是否用管理员权限启动。
  2. 安装目录 resources 下是否存在 install-service.exe 和 clash-verge-service.exe。
  3. Windows 事件查看器里是否有 Service Control Manager 相关错误。

如果服务存在但状态不是 Running，可以继续查：

Get-Service | Where-Object {$_.Name -match "clash|verge|mihomo"} | Select-Object Name, Status, StartType

服务存在但启动后马上停止，才进入日志阶段。此时不要马上改订阅。先把旧服务卸掉，再重新安装：官方卸载文档给了 Windows 的两种删除 service 方法，一种是在软件设置菜单里删除虚拟网卡旁的服务，另一种是在安装目录的 resource 文件夹用 cmd 运行 uninstall-service.exe。

安全软件是 Windows 上的高频干扰项，但不要直接写成“关掉就好”。更稳的做法是看拦截记录：它拦的是服务注册、clash-verge-service.exe 启动，还是 verge-mihomo.exe 创建网络接口。三者对应的处理不一样。

macOS：旧 helper 和 LaunchDaemon 要清干净

macOS 上 Service Mode 安装失败，常见不是 YAML 问题，而是系统不让 helper 正常落地。官方卸载文档列出的 macOS 服务名是：

io.github.clash-verge-rev.clash-verge-rev.service

可以按官方文档的思路先停止并卸载旧服务，再重新授权：

sudo launchctl stop io.github.clash-verge-rev.clash-verge-rev.service
sudo launchctl unload /Library/LaunchDaemons/io.github.clash-verge-rev.clash-verge-rev.service.plist

然后检查两个位置：

  • /Library/LaunchDaemons/
  • /Library/PrivilegedHelperTools/

如果里面仍有旧版本残留，先退出 Clash Verge Rev，再按官方卸载文档清理。清理后从 /Applications 里的 Clash Verge Rev 重新打开，不要从 dmg、下载目录或同步盘直接运行。macOS 对应用签名、路径和后台 helper 比 Windows 更敏感，路径变化后反复弹授权并不罕见。

如果系统设置里出现网络扩展、VPN 或后台项目授权提示，先处理系统授权。Apple 的 Network Extension 文档说明相关能力由系统框架管理，应用界面里的开关不能绕过系统批准。

logs/service 里找哪几类词

Clash Verge Rev 官方日志文档写得很明确：当前版本 logs 目录默认放 GUI 日志，另有 service 目录存放内核日志；排查问题要根据类型看不同日志。Service Mode 安装失败，应优先看 service 目录和当天日期的最新日志。

操作顺序：

  1. 在 Clash Verge Rev 设置里把日志级别改成 DEBUG。
  2. 完全退出应用，再重新打开。
  3. 复现一次 Service Mode 安装失败。
  4. 打开 logs/service，找当天日期、序号最大的日志。

日志关键词可以这样读：

日志线索更像哪一层处理方向
permission denied系统权限或 helper 授权Windows 管理员启动；macOS 重建 helper
service not installed服务注册没完成重新安装官方包，卸载旧服务后再装
file not found安装目录或资源文件缺失回到 GitHub Release 重新安装
address already in use端口被占用，不是安装失败查 mixed-port、external-controller 和旧客户端
failed to create tun device服务已进入 TUN 阶段查防火墙、虚拟网卡和 Mihomo TUN 字段

只要日志已经进入 failed to create tun device，问题就从“安装不上服务”转到“TUN 启动失败”。这时可以去看已有的服务模式权限或 TUN 排查文章，不要继续反复点安装按钮。

订阅问题什么时候才值得看

Service Mode 的安装阶段跟订阅质量没有直接关系。只有一种情况需要回头看订阅：服务已经安装并运行，Mihomo 能启动，但打开系统代理或 TUN 后没有任何可用节点、策略组为空，或日志提示 profile 解析失败。

如果你在同一台电脑上同时测试 Windows、macOS 和手机客户端，订阅格式最好保持清楚：Clash Verge Rev 用 Clash/Mihomo YAML，sing-box 用 JSON，V2Ray 系客户端用对应 URI 或 JSON。需要统一多端导出时，可以准备一份配套订阅线路做格式对照；但它解决的是 profile 内容，不会替代 Windows Service 或 macOS helper 安装。

版本和系统限制

这几个限制要提前接受：

  • Windows 7 不在当前 Clash Verge Rev Release 支持范围内；v2.5.1 Release 已写明 Windows 不再支持 Win7。
  • macOS 官方安装文档写的是支持 MacOS 12 及以上。
  • macOS 11 替换 Mihomo 内核属于折中办法，不适合作为 Service Mode 安装失败的常规修复。
  • 企业电脑、MDM、EDR、安全软件策略可能禁止安装服务或 privileged helper，这类限制不是 Clash Verge Rev 内部设置能单独解决的。
  • Linux 也有 Service Mode，但本文只处理 Windows 和 macOS；systemd、Polkit、deb/rpm 安装失败不在这里展开。

如果你的机器属于公司管控设备，先别继续用管理员命令硬装。能打开普通系统代理就先用普通模式；TUN 和 Service Mode 需要系统级权限，管控策略不放行时，客户端无法凭界面开关解决。

验证安装是否真的恢复

修完后做三步验证，不要只看 UI 上的绿色状态：

  1. Windows 打开 services.msc 或 PowerShell，确认相关服务存在并处于 Running；macOS 用 launchctl list | grep clash 看服务是否出现。
  2. Clash Verge Rev 重启后，logs/service 里没有新的安装失败、helper 拒绝或文件缺失错误。
  3. 打开 TUN 前，先用普通系统代理访问一个你常用的测试网站；普通模式正常后，再打开 TUN 看日志是否进入 Mihomo 连接阶段。

第 3 步很关键。普通系统代理都不通时，Service Mode 装上也只是把错误往后推；TUN 正常但节点不可用时，重点才回到 profile、Mihomo 规则和订阅格式。

下一步看哪类故障

Service Mode 安装恢复后，问题如果还在，按日志换文章看：