节点手册NODE HANDBOOK
服务安装排查

Clash Verge Rev安装服务失败怎么办?program not found与运行模式排查

先确认问题发生在“服务安装”而不是“TUN已启动但不能上网”,再按Is Admin、Running Mode和特定版本Issue逐层排查。

节点手册编辑部 · · 8分钟阅读
先看结论
  • 首页仍提示“Install Service”、报program not found或运行模式无法切到Service:看本文。
  • 运行模式已经是Service,但一开TUN就断网:转到TUN无法上网排查。
  • 系统代理也不能联网:先检查订阅、节点或规则,不要把所有问题归因于服务。
  • 先保存错误原文与系统信息;不要公开订阅URL、令牌和完整日志。

先区分三类相似问题

现象问题层应阅读
反复提示Install Service / 安装失败权限、服务文件、安装流程本文
Running Mode为Service,但TUN断网虚拟网卡、路由、DNSTUN排查
不开TUN,系统代理也无网络节点、规则、系统代理系统代理排查

这三类问题使用同一个客户端界面,但证据和修复路径不同。混在一起重装或重置网络,反而会丢失最有用的错误信息。

动手前先保存四项证据

  1. 记录Clash Verge Rev版本与操作系统版本。
  2. 在首页System Info查看Is Admin和Running Mode。
  3. 复制安装服务时的完整错误文本,例如是否含program not found。
  4. 记录错误发生时的Running Mode、Is Admin与完整版本号,不上传私人订阅或节点信息。

官方项目讨论明确建议用System Info里的Is Admin: true判断客户端是否真的获得管理员权限,而不是只凭“我点过管理员运行”推测。

情况一:System Info仍显示Is Admin false

官方讨论#7475的环境是Windows 11、Clash Verge Rev 2.5.1。报告者称自己右键以管理员身份运行,但诊断信息仍显示Running Mode: Sidecar与Is Admin: false;被采纳回答指出,真正处于管理员状态时应显示Is Admin: true,并建议尝试当时的后续构建及Service模式。

这条讨论能支持的判断只有:不要凭“点过管理员运行”推测权限,应以诊断信息为准。它不能证明所有版本都应使用同一升级包,也不能证明一次UAC确认必然修复服务。

情况二:错误包含program not found

官方Issue #8138记录的是Windows 11、v2.5.7+autobuild个案:普通用户模式安装时报program not found,完全退出后以管理员身份运行,System Info显示管理员模式,报告者称随后可以安装服务。这个个案支持先核对权限与运行模式,但不能证明所有同名错误都由同一原因造成。

  1. 完全退出客户端后,以管理员身份重新运行并完成UAC确认。
  2. 回到System Info核对Is Admin: true,再尝试一次安装服务。
  3. 若仍失败,保存版本、Windows版本、Running Mode和错误原文;不要仅凭program not found猜测具体缺失文件。
  4. 安装包只从官方Releases获取。讨论#7475的报告者后来提到更新后仍有旧版本冲突;这只是个案记录,因此本站不把“重装”写成标准修复。

情况三:提示service and cores未满足

官方Issue #8023记录的是Windows 10、v2.5.4/2.5.5个案,错误为installation finished without satisfying the requested service and cores,日志还出现核心路径安全检查。这个报告只证明这些版本和环境出现过该错误。

  1. 先确认自己的错误文本和版本是否与Issue一致;不同错误不要套用同一处理。
  2. 不要照抄Issue中的ACL修改、删除服务或清理系统目录操作。路径权限属于安全边界,改错会扩大风险。
  3. 查看官方Releases与同版本Issues,优先使用项目后续稳定版本验证;一次只测试一个版本并记录Running Mode。
  4. 若服务模式已正常、只有TUN流量失败,停止重装,转到TUN路由和DNS排查。

情况四:升级后才出现服务或核心错误

服务安装和核心文件随版本变化。先在官方Releases核对当前稳定版本和已知问题,再决定升级或回退;不要跨多个版本反复覆盖安装。

  • 升级前导出必要配置,订阅URL单独保管,不放进公开日志。
  • 一次只测试一个版本,记录安装结果和Running Mode。
  • Issue中的个案只证明特定环境出现过问题,不代表所有用户都应使用同一个旧版本。

2026-10-28核对官方Releases页面时观察到v2.5.8,页面标注日期为2026-10-09。版本会继续变化,执行前应重新查看官方页面。

什么时候停止重复尝试

编辑建议:如果完整版本、Running Mode、Is Admin和错误原文已经保存,而同一操作仍复现,就不要继续修改ACL、删除系统服务或运行陌生脚本。应按完全相同的版本与错误检索官方Issues;受管设备则联系管理员。这个停止原则是风险控制建议,不是GitHub Issue验证过的修复效果。

本文不能保证什么

官方Issue和讨论是问题证据,不是对所有Windows版本通用的修复承诺。本文没有在每一种安全软件、受管设备或旧版Windows上实测,也不会建议修改未知ACL、删除系统服务或运行陌生脚本。若错误涉及特定文件路径,应先脱敏用户名、设备名和订阅信息。

来源与核验日期

资料核验:2026-10-28。主要依据:

文章由AI辅助整理并由本站按可验证边界编辑;没有把Issue评论改写成官方通用修复。

常见问题

为什么每次开启TUN都提示Install Service?

先看System Info里的Running Mode。如果仍是User,说明客户端没有在服务模式运行;再核对Is Admin、完整版本号和安装错误原文。

Is Admin为true就一定能安装成功吗?

不一定。Is Admin为true仅确认诊断信息显示管理员状态,不保证服务安装成功,也不能据此排除所有权限问题;应按完全相同的错误与版本查找Issue。

报program not found应该下载单独的服务文件吗?

不建议从陌生来源单独下载。应只使用官方完整安装包;错误本身不证明某个文件缺失,先核对Is Admin、Running Mode、版本和错误原文。

Issue #8023适用于所有版本吗?

不适用。该Issue记录的是Windows 10上的v2.5.4/2.5.5环境和特定错误文本;版本、错误或日志不同,就不能直接套用其中的原因判断。

安装服务后TUN还是无法上网怎么办?

先在System Info确认Running Mode已经是Service。只有服务模式正常、开启TUN后仍无法联网时,才转到TUN文章检查虚拟网卡、路由和DNS;这些是排查方向,不是仅凭现象就能确认的原因。

可以把完整日志发到公开Issue吗?

先脱敏。删除订阅URL、令牌、节点密码、用户名、设备名、内网地址和可识别路径,只保留版本、时间和必要错误行。

也可以前往全部文章浏览。