排障指南
Clash 规则集拉取失败？Rule Provider 写法与更新排查步骤｜实战手册
远程规则集：rule-providers 的 url、path、interval、behavior 与 RULE-SET 引用对齐；按 HTTP/TLS、404、解析与缓存逐项对照日志，区分「更新失败」与规则顺序、策略组拼写问题；与站内规则分流长文互补，专注可操作的排障路径。
深度解析 Clash 代理客户端配置技巧，涵盖订阅导入、规则分流、TUN 全局代理等实用教程，帮助你从新手快速成长为进阶用户，充分发挥 Clash 的强大功能。 Clash Verge Rev 的订阅导入失败、规则集更新与节点切换问题，在这里出现的频率最高。
分类：排障指南 · 共 18 篇
这里汇总了 18 篇 Clash 排障指南 相关的文章，从基础概念到具体操作逐步展开，适合按顺序通读，也适合直接检索定位问题。
远程规则集：rule-providers 的 url、path、interval、behavior 与 RULE-SET 引用对齐；按 HTTP/TLS、404、解析与缓存逐项对照日志，区分「更新失败」与规则顺序、策略组拼写问题；与站内规则分流长文互补，专注可操作的排障路径。
开启 TUN 时 macOS 拦截系统扩展或网络扩展：在系统设置 → 隐私与安全性找到「已被阻止」提示并允许，按需重启后再开 TUN；说明与仅系统代理的差异，并给出验证虚拟网卡是否接管流量的顺序，与站内泛化 TUN 长文、Verge 教程互补。
全局模式仍「仅浏览器通」：厘清 Clash Global、系统代理与 TUN 的分工；Windows UWP 回环与 TUN 服务权限、macOS 网络扩展与环境变量；配合 Mihomo 日志区分「流量未进内核」与「规则/DNS 待调」，附逐步清单。
已开 Sniffer 仍无法按 Netflix 等流媒体域名分流：核对 mihomo 嗅探开关、根级 override-destination、规则顺序（DOMAIN-SUFFIX 须在 GEOIP/IP 规则前）、以及 fake-ip 与 DNS；附可复制 YAML 与排查清单。
节点列表延迟测试全失败或「全红」：先理解 Clash 延迟测试与 url-test 健康检查测的是什么，再按 DNS（fake-ip）、UDP/STUN、TUN 与系统代理逐项缩小范围，区分线路问题与本机解析或防火墙问题；附可对照清单。
Clash 已开而 docker pull 仍慢：分清宿主机代理、Docker 引擎 HTTP/HTTPS 代理、WSL2 后端与容器内 HTTP_PROXY；Docker Desktop 图形界面与 daemon、host.docker.internal 与 NO_PROXY、镜像仓库域名规则命中，与 WSL2 路由/MTU 教程互补。
Clash 与 WSL2 并存时默认路由、Hyper-V 虚拟网卡度量、系统代理与 TUN 差异、分流绕过与 MTU/PMTU：宿主正常子系统无网或间歇断线的逐步排查与命令清单，可选镜像网络与代理对齐。
多设备共享电脑 Clash：先确认手机与电脑同网段无 AP 隔离，再查绑定地址 0.0.0.0、Allow LAN、mixed-port 与 HTTP/SOCKS 对齐，最后放行 Windows 防火墙与 macOS 入站连接，附逐步清单。
安卓端无法连接、订阅更新失败或频繁断线：从浏览器校验订阅 URL、排除代理环路，到电池优化、后台限制与双 VPN 冲突，附整体排查顺序。
克隆大仓、拉 LFS、脚本读 raw.githubusercontent.com 或 Workflow 下载缓存时，一半是 API、一半是 CDN——宽泛直连会把其中一条链留在烂路上。本文为 GitHub、Actions 归档域名并写同名 Clash 规则，兼顾本机与公司 Runner。
ollama pull 若长时间停在 pulling manifest，多半是 registry 元数据与后续 blob 下载走了不同出口，或终端根本没进 Clash。本文按 OCI 链路拆开写规则与镜像例外。
<strong>npm</strong>／<strong>pnpm</strong>／<strong>yarn</strong> 卡顿或 <strong>ETIMEDOUT</strong>：多为元数据能通过而 <strong>tarball CDN</strong> 被宽泛 <strong>GEOIP</strong> 抢规则。本篇把 <strong>registry.npmjs.org</strong> 与包体下载拆开，置顶 <strong>Clash</strong> DOMAIN／策略组并做好国内与国内镜像<strong>直连</strong>。
Windows 桌面端 Discord：安装更新进度 0%、语音房内断续掉线——为 discord.com、CDN、gateway.discord.gg、discord.media 等建独立策略组并置顶规则；对齐系统代理与 TUN；语音单独核对 UDP/RTP 与节点；并与 Steam／Epic 游戏 UDP 分流顺序对照，附 YAML 骨架与检查清单。
国内站仍走代理变慢：规则自上而下命中即停，GEOIP CN 常被更早的 DOMAIN／远程规则集或 MATCH 兜底抢走；联调 fake-ip、系统 DoH 与 IPv6，用日志反推插入 DIRECT 段的位置；与规则分流教程互补，并区分 Sniffer 流媒体面与仅浏览器通代理路径。
已开外部控制却仍打不开 Yacd／Metacubexd 或自定义面板：逐项核对 YAML 里 external-controller 的监听地址与端口、mixin 合并是否静默改口、secret 与控制台基址、HTTPS 页的 Mixed Content、以及 Docker／WSL 端口映射与本机防火墙；与端口占用主线文互补，curl 先试再谈 Web UI。
能上网但 Steam 商店/社区异常、下载为零或联机进房失败：为 steampowered、steamcommunity 等建独立策略组并置顶规则，联调系统代理、TUN 与 DNS；下载区分 CDN 与区服，UDP 与 NAT 单独对照节点与排障长文。
安装或升级后无法启动、日志或界面报 7890/7891 等端口被占用：在 Windows 用 netstat 与 PowerShell 将端口对应到进程 PID，任务管理器或 taskkill 处理冲突，或改 mixed-port 并重链系统代理、Allow LAN 与脚本的端口；区分 WSL2 路由与纯端口占用。
公共热点强制门户：系统代理与 TUN 下认证页打不开的机理与「先认证、后代理」顺序；RFC1918 与门户域名置顶 DIRECT、DNS 与 fake-ip 联调；各系统简要提示，与 Allow LAN、系统代理/TUN、WSL2 路由文互补。