Clash Verge Rev 服务模式安装失败：状态自查与 3 平台分头修复

点了「安装服务」，弹窗报错，或者干脆没反应，TUN 开关还是灰的。Clash Verge Rev 服务模式安装失败大多卡在三类地方，跟你用哪个系统直接相关。别急着重装第五遍——先确认服务装没装上，这一步决定后面往哪查。Windows 上多半是管理员权限或国产杀软拦了；macOS 上常见的是公司电脑的安全软件不让装；Linux 上则是官方还没修好的老问题，试再多遍结果也一样。

先确认服务到底装上没有

官方对这个服务的定位说得很直白：它唯一的作用就是让你不必用管理员模式也能启用 TUN。服务装不上不等于软件坏了，系统代理照样能用，只是 TUN 这条路暂时走不通。

判断只看一处：软件里的 系统信息 → 运行模式。

• 显示 Sidecar，或者点「安装服务」直接报错，服务根本没装上，往下按你的系统对号入座。
• 显示 Service / 服务模式，TUN 却依然连不上网，服务是好的，卡在别处，看文末那节的分流。

还有个更硬的锚点。报错弹窗或日志里只要出现 IPC path、「命名管道」、「系统找不到指定的文件」这几个字样，几乎都指向服务没有正确安装或者没跑起来，不用再怀疑是节点或订阅的问题。软件安装目录下那两个文件，install-service.exe 和 uninstall-service.exe，后面几节会反复用到，先记住它们在哪。

Windows 下服务装不上的五种成因

这五条按「最容易排掉的先试」排序，不是按官方文档的顺序。每条末尾都有一句怎么算修好了，改完立刻能验，不用一路做到底再回头看。

普通账户权限不足，改用管理员模式按顺序装

装 Windows 服务本来就要管理员权限，这是最常撞上的一条。典型表现有三种：点「安装服务」报「连接到服务命名管道失败：系统找不到指定的文件」；想绕开、手动去目录里跑 install-service.exe，窗口一闪而过；更让人摸不着头脑的是，切到管理员模式打开面板后，那个「安装服务」按钮反而不见了。

顺序是有讲究的。照 GitHub 上一位用户亲测、且被维护者标记为已解决的步骤走：

1. 用管理员模式运行软件（在程序属性里勾「以管理员身份运行此程序」也行）。
2. 先打开「系统代理」让程序正常启动起来，别一上来就切 TUN。
3. 在程序内部把模式切换到 TUN。
4. 进 系统信息 → 运行模式，点那个蓝色盾牌（管理员）图标，选「安装服务模式」。

装好之后，往后默认用 TUN 模式启动就正常了。怎么算修好：运行模式那一栏从 Sidecar 变成 Service。

国产杀毒软件拦掉了服务安装动作

这一条官方在 Windows 常见问题页里写得毫不含糊：360、金山毒霸这类杀毒软件会拦截服务模式的安装，给出的解决方案就是不要用国产杀毒软件。实际表现通常是装到一半闪退，或者装完看着成功、放上一两分钟软件自己退了，再开还起不来。

退出杀软或者把软件目录加进白名单，再装一次。怎么算修好：安装过程从头到尾不中断，软件也不再自己退出。

2.5.x 版报 IPC path not ready，是状态文件损坏

升到 2.5 系列之后，不少 Windows 用户点安装服务会撞上 IPC path not ready。这条有个很关键的版本边界：官方 issue 里的报告者交叉验证过，问题只在 2.5.* 上出现，退回 2.4.7 后装服务和卸服务都不再报任何错。

根据那份报告，根子在一个损坏的状态文件——他把 desired-state.json 用二进制查看器打开，里面全是 0。日志表现同样特别：走到 [Service] install service 这一行之后就没了下文，既没有报错也没有返回。

• 成本最低的一步：彻底退出软件（托盘也要退），到任务管理器里结束残留的内核进程，再装一次。
• 急着用可以退回 2.4.7 过渡。这是绕开不是根治，该 issue 目前仍处于开启状态，官方还没给出正式版的修复结论。

怎么算修好：安装弹窗不再出现那句 IPC path not ready，运行模式转为 Service。

弹窗提示找不到 VCRUNTIME140.dll

刚重装完系统的机器最容易碰上这个。官方对它的定性是操作系统缺少 VC 运行环境所需的库，修法就是把微软的运行库补上，官方 Windows 常见问题页里直接给了三个微软官方直链，按你的架构挑一个：vc_redist.x64.exe、vc_redist.x86.exe、vc_redist.arm64.exe，都在 aka.ms 域名下。

还有个值得留意的时间点：官方在文档里注明，2.0 版本之后的安装器会自动检测并安装 VC 运行库。所以今天还撞上这个弹窗，多半说明你手里那份安装包偏老，顺手换成 官方下载页 上的新版更省事。怎么算修好：装完运行库重开软件，点安装服务不再弹 dll 缺失。

服务装上了，开机之后又没了

另一种老毛病是服务明明装好了，下次开机又不见，得反复手动点安装，超级管理员账户和普通账户都试过照样掉。官方目前没有根治办法。能接受的话有两条路：要么每次开机重装一遍服务，要么干脆改用管理员模式直接开 TUN，代价是开机自启也得配成管理员启动。

macOS 与 Linux 的情况不一样

换个系统，卡点完全变了。Windows 那五条在这里基本用不上，别照搬。

macOS：先看是不是安全软件不让装

官方在 macOS 常见问题页里点明了这个场景：公司配发的电脑往往装有安全管控类软件，它们会禁止软件安装服务。官方给的解决方案也很直接：关掉安全软件，或者找 IT 管理员把这个应用加进白名单。个人的 Mac 撞上的概率低得多。

顺带提醒一句，macOS 那边还有一条名字很像、成因完全不同的问题叫「软件包损坏」，指的是旧版本还在运行时装新版本，结果两个包都坏了，处理办法是先彻底卸干净再装。它跟服务装不上不是一回事，看到报错文案相似别往一处想。

Linux：这几条是官方还没修的 bug

Linux 用户搜这个问题，前排会撞见一堆发行版相关的帖子——Fedora 装不上、Ubuntu 缺提权组件、socket 路径对不上。有一件事值得先知道：这些报告在官方仓库里目前都还开着，官方至今没有给出修复结论。

意思就是换发行版、重装软件、翻遍设置，多半不会有结果。与其耗在这上面，不如换条路走。

• 绕行方案：服务的作用只是免掉管理员权限，那就直接用 root 或 sudo 权限启动，TUN 一样能开，只是每次启动要提权。
• 跟进方式：到官方仓库的 issue 区搜 Linux service，关注编号 7157、6978、7015 这几条，修好了会在那里出结论。

卸载残留服务后重装的正确顺序

上面几条都试过还是不行，就走这条兜底路径。反复点安装按钮之所以没用，往往是上一次失败留下的残留还占着位置，新的装不进去。官方给的标准入口就是软件目录里的 uninstall-service.exe，官方卸载文档页也列了三个系统各自删除服务的办法。

1. 完全退出软件，托盘图标也要右键退出，不能只关窗口。
2. 打开任务管理器，把残留的内核进程结束掉（名字里带 mihomo 或 clash 的那些）。
3. 用管理员身份运行软件目录下的 uninstall-service.exe，等它跑完。
4. 重新用管理员身份打开软件，按前面那套顺序再装一次服务。
5. 回到 系统信息 → 运行模式 核对，显示 Service 才算成功。

第 1、2 步最容易被跳过，也最影响成败。软件看着关了，内核进程还在后台跑着，卸载动作就会做不干净。

服务装好了，还是开不了 TUN

如果运行模式已经是 Service，TUN 也开了，网页却打不开，那就不是这篇要解决的了。这种情况的根因通常落在虚拟网卡、防火墙或者订阅配置上，排查思路和上面完全不同，按 TUN 模式无法上网排查 那篇的两类症状对照着走。还没搞清 TUN 该怎么开、服务模式在整套流程里是什么位置，可以先看 TUN 模式怎么开。

Clash Verge Rev 服务模式常见问题

不装服务模式就不能用 TUN 吗？

能用。官方说得很清楚，服务模式唯一的作用就是让你不必用管理员模式启用 TUN。用管理员身份运行软件，TUN 照样开得起来。装服务的价值在于配了开机自启之后不用每次都提权，图省事、不介意管理员启动的话，跳过它也不影响使用。

服务装失败会影响系统代理上网吗？

不影响。系统代理和 TUN 是两条独立的路径，服务只服务于后者。装不上的时候先把系统代理打开，浏览器该怎么用怎么用，不必停在这里干等。

卸载软件时服务会跟着卸干净吗？

不一定，所以官方专门写了一页卸载说明，三个系统各有各的删除方法。稳妥的做法是卸载软件之前先跑一次 uninstall-service.exe，再卸主程序。装过服务又直接删程序目录的，残留很可能还挂在系统里，下次重装就会遇到装不上的怪现象。

回退旧版本能解决装不上的问题吗？

只有 IPC path not ready 那条对得上。它有明确的版本边界，退到 2.4.7 确实不再报错。其余四种成因跟版本没关系，退版本纯属白费工夫。订阅、节点、规则都存在用户数据目录里，跟程序本体分开，退版或重装都不会丢。

公司电脑装不了服务怎么办？

公司管控的机器上，安全软件禁止安装系统服务是常态，Windows 和 macOS 都一样。官方给的路子是关掉安全软件或者找管理员加白名单，可这两件事普通员工往往都做不了。做不了就走管理员模式那条路，或者只用系统代理。

服务装好了要一直开着管理员权限吗？

不用，这正是装服务的意义。只有安装那一次需要管理员权限，装完之后普通账户启动软件也能开 TUN。要是发现每次都还得提权，回头看看运行模式是不是又掉回 Sidecar 了。

服务这关过了，接着看这几篇把后面几步配顺：TUN 怎么开、开完要注意什么，看 TUN 模式怎么开；开了却上不了网，走 TUN 模式无法上网排查；遇到别的报错先翻 常见问题；重装或换版本只认 官方下载页 的 GitHub 直链；第一次装、想从头对一遍流程的，看 安装教程。文中的报错文案、修复步骤与版本信息核对自官方文档与官方仓库 issue，采集于 2026 年 7 月 25 日。