基础认知
区分内核、客户端与代理服务，明确模式切换的作用范围。
Clash Meta、mihomo 内核和图形客户端是什么关系？
Clash Meta 是该内核项目曾使用的名称，项目现以 mihomo 名称维护。内核负责代理协议、规则匹配、DNS 和连接处理；图形客户端在内核之外提供订阅管理、策略选择、系统代理及日志界面。客户端名称不同，不代表所用内核一定不同。排查配置兼容问题时，先在关于页面或启动日志中确认内核名称与版本，再核对对应文档。更新图形界面也不一定同时更新内核，部分客户端需要在内核管理中另行操作。
安装 Clash Meta 客户端后，为什么还需要订阅？
客户端提供连接和分流能力，本身不等于代理服务。可用配置通常需要包含代理服务器地址、端口、认证信息，以及引用这些代理的策略组和规则。订阅是分发这类配置的一种方式，应向实际服务提供方取得；已有自建服务器时，也可以自行编写配置文件。导入前确认订阅格式适配 Clash 或 mihomo，并把订阅链接视为访问凭据保存。不要把完整链接贴进公开日志、截图或在线转换页面，尤其注意链接查询参数中的认证字段。
规则模式、全局模式和直连模式应该怎么选？
日常分流通常选择规则模式，即 mode: rule，连接会按 rules 从上到下匹配，命中后交给对应策略。全局模式把交给内核处理的连接送入全局策略，仍需选择可用代理；它不会自动接管未进入内核的应用。直连模式让内核处理的连接直接访问目标。排查时可短暂切换全局模式，判断问题是否来自规则，但测试后应恢复原模式。模式与流量接管方式是两回事：开启全局模式并不能替代系统代理或 TUN，也不能保证所有 UDP 流量都进入代理。
Clash for Windows 停更后，原配置还能迁移吗？
多数基础 YAML 配置可以迁移，但需要区分原始订阅、客户端覆写和脚本。先导出订阅地址，备份本地配置、自定义规则及策略组名称，再安装仍在维护的 mihomo 内核客户端。优先导入原始订阅并确认基础连接，随后逐项恢复覆写内容。旧客户端的脚本接口、配置目录和系统集成功能不一定兼容，不能只复制整个程序目录。迁移完成后关闭旧客户端的系统代理、后台服务和开机启动，避免两个内核争用端口或重复修改路由。
安装配置
从订阅获取到内核启动，优先核对返回内容、监听端口与系统权限。
订阅导入失败或更新后失效，应该先检查什么？
先在配置或订阅管理中手动更新，查看返回状态与错误正文。401 或 403 通常表示认证、权限或访问策略有问题，404 需要核对地址，超时则先确认订阅域名是否可达。若下载成功但提示解析失败，检查返回内容是否其实是登录页面、错误页面，或并非 Clash 配置格式。更新订阅前保留可用配置副本，不要反复删除重建。还要检查客户端是否设置了通过当前代理更新订阅；当前代理不可用时，可在网络条件允许的情况下改为直连更新，再联系服务提供方确认订阅有效期。
mixed-port: 7890 是什么，端口冲突怎样处理？
mixed-port 是同时接受 HTTP 和 SOCKS 代理连接的混合监听端口，7890 只是常见设置，不是固定要求。应用手动设置代理时，应填写客户端实际监听的地址与端口，本机通常使用 127.0.0.1。若启动日志出现 address already in use，先退出其他代理客户端和残留内核进程，再检查端口占用。也可以改用空闲端口，但必须同步修改系统代理、浏览器插件及命令行环境变量。部分客户端会覆写订阅中的端口，应以设置界面和启动日志显示的最终值为准。
TUN 模式提示权限不足，怎样确认服务是否正常？
TUN 需要创建虚拟网络接口并调整路由，通常依赖管理员权限或客户端提供的特权服务。在 Windows 上先查看服务模式是否已安装并启动，再按客户端要求授权；在 macOS 上完成辅助程序安装与系统授权；Linux 上检查服务账户是否具有所需网络权限。不要仅看到 TUN 开关开启就认定接管成功，应同时查看接口创建和路由设置日志。若提示设备被占用，先停止其他 VPN 或虚拟网卡服务。权限恢复后重启内核再试，不建议通过关闭防火墙或扩大控制接口暴露范围来绕过错误。
修改 config.yaml 后报错，怎样定位 YAML 缩进问题？
先保留报错文件，再根据日志中的行号及前后几行检查结构。YAML 缩进使用空格，不使用制表符；同层键保持对齐，列表项使用短横线，键名后的冒号与值之间保留空格。行号往往指向解析器无法继续的位置，真正的问题可能在上一行。若内核程序可直接运行，可用 mihomo -t -f config.yaml 做配置测试，路径应指向实际文件。还应确认策略组和规则引用的名称确实存在。订阅管理型客户端宜在覆写入口修改，直接编辑下载缓存可能在下一次更新时被覆盖。
使用技巧
处理自定义规则、开机自启、多设备同步与 DNS 路径。
Clash 自定义规则放在哪里，为什么新增后没有生效？
规则模式按 rules 的顺序匹配，自定义规则应放在可能提前命中的宽泛规则之前，尤其不能放在最终 MATCH 之后。例如 DOMAIN-SUFFIX,github.com,PROXY 需要存在名为 PROXY 的策略或代理组，名称区分具体字符。优先使用客户端的规则覆写或前置规则入口，避免订阅更新覆盖修改。保存后重新加载配置，并通过连接详情检查实际命中的规则和策略链。已经建立的长连接可能继续使用原路径，测试前可关闭对应连接再重新访问。域名规则也无法直接匹配应用硬编码的纯 IP 请求。
Clash 开机自启后仍不能联网，需要检查哪些开关？
开机启动客户端、启动内核、启用系统代理和启用 TUN 是不同状态，应分别确认。先重启系统，查看客户端是否已进入后台、当前配置是否加载、内核是否成功监听端口，再检查系统代理或 TUN 的恢复状态。服务模式还需确认系统服务的启动类型与运行状态，避免界面已启动而特权服务尚未就绪。若登录时网络尚未连接，订阅更新和连接测试可能暂时失败，可以等待网络就绪后重试。不要同时启用多个客户端的开机启动；切换客户端时应先清理旧程序留下的代理与服务设置。
电脑和手机可以共用一份订阅与配置吗？
可以共用订阅来源，但应先确认服务允许的设备数量与同时连接限制。代理列表和规则通常便于复用，TUN、DNS 监听地址、接口名称、文件路径及外部控制接口则可能需要按设备覆写。建议把通用配置交给订阅管理，把端口和系统集成设置留在各设备的客户端中。同步文件时不要公开带认证的订阅地址，也不要把控制接口的访问凭据提交到公开仓库。更换设备后应检查策略组选择是否恢复；即使配置文件相同，系统网络栈、VPN 权限和后台策略也可能使实际行为不同。
怎样检查 Clash DNS 泄漏，fake-ip 是否等于全部接管？
fake-ip 通过虚拟地址映射保留域名信息，不等于所有 DNS 请求都自动进入内核。检查时先确认 dns.enable 已开启，再核对系统 DNS、TUN 的 DNS 劫持规则，以及浏览器或应用是否单独启用了加密 DNS。结合内核日志和系统网络设置判断查询路径，在线检测页面显示的解析器位置只能作为线索。修改 DNS 后应清理系统与浏览器缓存，并重新建立连接。不要因为检测结果与预期不同就随机叠加多组 nameserver；先明确哪些请求由系统解析、哪些交给内核，以及上游 DNS 连接采用何种路由。
故障排查
按症状做对照测试，每次只改一项设置，并保留可恢复的配置。
节点测试超时，是服务器不可用还是配置有问题？
测试超时只说明在规定时间内没有完成指定测试请求，不能单凭这一项认定服务器已经失效。先确认系统时间准确、订阅已经更新，再检查日志中的域名解析失败、连接被拒绝、握手失败或认证错误。比较同一配置在另一网络上的表现，可帮助区分本地网络限制与远端故障；也可切换同一策略组中的其他代理进行对照。若只有测速失败但实际访问正常，应检查测速地址及超时设置。向服务提供方反馈时保留错误类型和发生时间，隐藏服务器认证信息，不要只发送一张超时截图。
系统代理已开启，为什么终端或某些应用仍然直连？
系统代理只是向遵循该设置的应用提供代理地址，并不是透明接管。部分终端程序读取 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY 环境变量，另一些程序只认自身的代理选项；浏览器插件也可能覆盖系统设置。先确认内核正在运行，再用 curl -I -x http://127.0.0.1:7890 https://example.com 显式指定代理测试，并把端口改为实际监听值。若显式代理可用，重点检查应用的代理来源和排除列表。需要接管不遵循系统代理的应用时，可评估 TUN 模式，但仍应检查路由、权限及与其他 VPN 的冲突。
Windows 商店应用无法连接，怎样处理 UWP 回环限制？
部分受 AppContainer 隔离的应用不能直接访问本机回环代理，因此浏览器正常而特定应用失败时，需要检查回环限制。先确认受影响应用确实使用本机代理，再使用客户端提供的回环豁免工具，或在管理员终端中运行 CheckNetIsolation LoopbackExempt -s 查看当前豁免列表。手动添加时使用 CheckNetIsolation LoopbackExempt -a -n= 后接目标应用的包系列名称，不能填开始菜单显示名。只对需要的应用授权，不要批量放开所有应用。也可测试 TUN 接管作为替代路径，但是否有效仍取决于应用网络行为及路由配置。
Android 锁屏后断连或耗电偏高，怎样排查后台运行？
先在系统设置的应用管理中找到客户端，检查电池用量、后台活动和自启动权限；具体菜单名称因厂商系统而异。锁屏断连时可允许后台运行，并观察 VPN 状态是否仍然存在，同时确认没有其他 VPN 应用接管连接。耗电偏高则先查看是否存在频繁重连、订阅反复更新或持续输出调试日志，再比较关闭不必要的连接测试后的变化。不要一次修改所有省电选项，应每次调整一项并在相近网络条件下观察。信号较弱、热点共享和大量后台请求也会增加耗电，不能只按客户端电量占比判断内核异常。
仍需定位问题：查看按症状组织的故障排查流程 →