Clash 启动日志:先分清窗口退出和内核退出

点开客户端后窗口消失,先确认托盘或菜单栏里是否还有图标。部分客户端关闭窗口后仍在后台运行;另一些客户端的窗口还在,却因为内核子进程退出而显示连接失败。排查时记下点击启动的时间,只重试一次,然后对照同一时间段的界面日志、内核日志和系统记录。这样可以避免把几次启动中不同的报错混在一起。

  • 窗口还能打开:如果客户端提供「日志」与「内核日志」两个入口,先看内核日志中最早出现的错误,再看界面日志有没有写出被启动的内核路径和实际加载的配置路径。
  • Windows 窗口一闪而过:打开「事件查看器」→「Windows 日志」→「应用程序」,按启动时间找相关错误。若有「应用程序错误」记录,查看出错的应用程序名称和模块名称,分清退出的是客户端本身还是内核。普通的配置加载失败不一定会出现在这里。
  • macOS 窗口一闪而过:在「应用程序」→「实用工具」→「控制台」查找对应时间的崩溃报告。没有报告时,再查客户端保存的启动日志;有的进程会在打印错误后主动退出,不会产生崩溃报告。
日志片段接下来查什么
yaml: line 12打开实际加载的 YAML,从第 12 行往上检查缩进和列表结构。
address already in use按同一条日志里的地址、端口和协议查监听进程。
no such file or directory先看缺的是内核、配置还是规则文件,按报错中的完整路径检查。
exec format error检查内核文件格式以及安装包是否对应当前系统和处理器架构。

YAML 配置错误:从报错行退回到上一个字段

日志报第 12 行,不一定是第 12 行写错。比如第 11 行的字符串引号没有闭合,解析器可能读到下一行才报错。先按日志给出的路径打开文件,用纯文本编辑器显示行号和空白字符。支持订阅合并或覆写的客户端,内核读到的往往是生成后的配置,而不是订阅原文。用生成文件定位问题,找到原因后再修本地覆写或订阅来源,免得下次更新把修改盖掉。

先查格式,再查规则引用

  1. 同级字段对齐,缩进使用空格而不是 Tab。像 mixed-port: 7890 这样的键值对,英文冒号后留一个空格。检查上两三行有无半截引号,以及列表项前是否漏了 -。
  2. 如果文件开头是 <!doctype html>,下载到的可能是登录页或错误页。回到订阅来源确认地址和输出格式,不要把网页当 YAML 修,也不要把带访问令牌的订阅地址发到公开排查帖里。
  3. 如果日志指向策略组或规则集不存在,核对规则末尾的目标是否与 proxy-groups 中的名称一致,以及 RULE-SET 引用是否对应 rule-providers 中的键。YAML 格式能解析,不代表其中的引用有效。配置从 mihomo 换回旧 Clash 内核时,还要确认该版本是否支持所用字段和规则类型。

用本地最小配置隔离订阅和覆写

先通过客户端导出,或在客户端退出后备份原配置,再把下面几行另存为 test.yaml,不要覆盖现用订阅。示例只监听本机的混合代理端口,规则命中后一律直连,不测试代理节点。若 7890 已被占用,先按下一节确认可用端口,再进行实际启动测试。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - MATCH,DIRECT

如果手头有同版本的独立 mihomo 可执行文件,可以用 -t 检查配置。下例在 Windows PowerShell 中运行,假定当前目录已有 mihomo.exe、test.yaml 和一个用于本次测试的空目录 clash-test-home:

.\mihomo.exe -t -d .\clash-test-home -f .\test.yaml

这里的 -d 指定内核工作目录,-f 指定配置文件。测试通过后,还要真正启动一次才能确认监听端口和客户端启动流程都正常。测试原配置时,若它依赖工作目录中的规则或其他资源,换到空目录可能另外报缺文件;不要把这类报错当成 YAML 语法错误。

7890 端口被占用:按地址和协议确认进程

mixed-port 是 HTTP 与 SOCKS 代理共用的监听端口;external-controller 则是控制接口地址。实际报错也可能来自 DNS 的监听地址。若日志里写的是 listen tcp 127.0.0.1:7890,查 TCP 7890;若报的是控制接口 127.0.0.1:9090,只改混合端口不会解决控制接口冲突。0.0.0.0:7890 这样的通配地址也要留意,它可能已经覆盖回环地址上的监听需求。

Windows:先找监听记录,再核对 PID

netstat -ano -p tcp | findstr ":7890"

看「本地地址」列是否正好以 :7890 结尾,并确认状态为 LISTENING。筛选结果也可能包含远端端口恰好是 7890 的连接,不能把那一行当成占用者。最后一列是 PID,可到「任务管理器」→「详细信息」查对应进程。若报错写的是 UDP,用 netstat -ano -p udp 查对应本地端口,UDP 结果没有 TCP 的监听状态列。

macOS:直接列出 TCP 监听者

lsof -nP -iTCP:7890 -sTCP:LISTEN

从输出的 COMMAND 和 PID 列确认进程。如果是 UDP 端口,改用 lsof -nP -iUDP:7890,把 7890 换成日志里的实际端口。普通账户未必能看到所有进程;空结果也可能是占用者已经退出,最好在报错刚出现时对照检查。

内核文件缺失:核对路径、安装包和系统架构

客户端界面和代理内核是两个部分。应用图标还在,不代表启动时要调用的内核文件还在。便携版只把主程序拖出压缩包、升级后仍引用旧目录,都可能让界面找不到内核。日志若写的是启动子进程失败,先确认报错路径指向可执行文件;如果路径指向规则集、地理数据或配置文件,应恢复对应资源或修正工作目录,而不是替换内核。

  1. 确认文件位置。在日志所列的完整路径查看文件。便携包应整体解压到本地目录,保留原有目录结构;安装版优先用同一客户端的发行包修复,不要把其他客户端的内核随意改名放进去。
  2. 确认系统与架构。Windows 在「设置」→「系统」→「系统信息」中查看「系统类型」,区分 x64 和 ARM64。macOS 通过苹果菜单 →「关于本机」区分 Apple 芯片和 Intel 处理器。发行页标注 arm64、x64 或 universal 时,按项目的系统与架构说明选择。
  3. 确认是否被系统拦截。Windows 可在「Windows 安全中心」→「病毒和威胁防护」→「保护历史记录」核对时间和路径。macOS 可在「系统设置」→「隐私与安全性」查看对应提示。如果包的来源不明或系统报告具体风险,先停止运行,从项目的可信发行渠道重新获取;不要为排查关闭全局防护。
  4. 确认是不是 TUN 启动失败。如果日志已经显示配置载入和本地代理开始监听,随后才出现虚拟接口、路由或权限错误,内核并不缺失。能打开客户端时,先关闭其 TUN 选项再试普通监听;通过本地配置控制时,可在测试副本中把现有 tun 段内的 enable 改成 false,不要另写第二个同名段。若关闭后能启动,再按该客户端的说明单独检查其服务或权限要求。

最小配置也闪退:隔离客户端状态,再逐项恢复

如果同版本独立内核能够用最小配置启动,而图形客户端仍是一打开就退出,下一步查客户端自己的状态,例如自动恢复的上次配置、自动启用的 TUN,或升级后残留的内核路径。先正常退出应用并确认后台没有残留进程,再按该客户端文档找到数据目录。若项目支持重建用户数据,可先备份,再把旧目录临时改名,让应用生成新目录;不要直接删除旧目录,也不要把新旧数据一次性混拷。

  1. 先用空白状态打开界面,只加载最小配置。退出后再打开一次,确认不会因恢复上次状态而再次闪退。
  2. 恢复订阅并确认能启动,再单独恢复覆写和规则。每加回一项就重新启动一次;最后才恢复系统代理或 TUN。只有最小直连配置能启动,说明已隔离部分原因,并不能证明订阅节点可用。
  3. 若仍不能启动,记录系统版本、客户端版本、内核版本、最近一次变更,以及第一条报错前后的几行。提交日志前遮住订阅地址、令牌、节点凭据和本地用户名;只留最后一行退出提示,通常不足以判断原因。