排障指南
GitHub clone／Actions 总超时？Clash 分流仓库与 CDN（2026） · 进阶解读
克隆大仓、拉 LFS、脚本读 raw.githubusercontent.com 或 Workflow 下载缓存时，一半是 API、一半是 CDN——宽泛直连会把其中一条链留在烂路上。这篇为 GitHub、Actions 归档域名并写同名 Clash 规则，兼顾本机与公司 Runner。
不是教程，更像是日记：把当时遇到的现象、处理过程和最后结论记下来，也许能帮你省下一次同样的排查。 这里的 Clash Verge Rev 条目多半来自真实使用过程：问题是什么、怎么定位、最后怎么处理的。
分类：排障指南 · 共 18 篇
本专题汇总 18 篇「排障指南」相关文章，全部来自实际使用与排障过程，附带可直接套用的配置片段与验证方式。
克隆大仓、拉 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 路由文互补。
远程规则集：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 与排查清单。
节点列表ping 值测试全走不通或「全红」：先理解 Clash ping 值测试与 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 冲突，附全貌排查顺序。