为什么「本地大模型」要比网页 AI 多拆一层域名?
站内已有大量围绕 网页对话、开放平台 API、IDE 插件市场 的 Clash 分流稿,例如 《ChatGPT 与 OpenAI 域名单独分流》。那些场景的核心矛盾,多是「浏览器里哪些主机名要同一出口」。而当你用 Ollama 或同类工具在机器上跑 本地大模型 时,瓶颈常常换成另一条链:模型下载 与元数据校验要同时命中注册库、对象存储、以及可能的 Hugging Face 上游——它们既不是单一 api.*,也不保证落在同一 CDN 前缀下。
于是会出现一种典型误判:浏览器访问文档站「看起来正常」,终端里 ollama pull 却反复卡在拉 blob、校验 manifest,或进度条走到一半长时间不动。把全局节点来回切换,有时能「碰」对,但既不稳定也难复盘。更稳妥的做法,是把 Ollama 拉模型 涉及的主机名当成一整张「下载面」来维护:在 Clash 分流 里为注册库与 HF 系分别准备策略组,并保证规则命中顺序不被巨型直连表提前吃掉。
「总超时」在终端里通常长什么样?
社区讨论里常见描述包括:长时间停留在「pulling manifest」「downloading」百分比、TLS 握手后无数据、或偶发 EOF / connection reset 后自动重试。若你同时配置了 Hugging Face 镜像或自定义端点,还可能看到前半段走镜像域名、后半段仍回源官方 CDN,从而出现同一命令内两种延迟特征。另一种容易忽略的情况是:下载线程并发较高时,其中几条连接走了 DIRECT,其余走了代理,表现为「总体不慢但偶尔某块哈希校验失败」,让人误以为是磁盘或模型文件损坏。
与纯网页场景不同,本地推理 工具往往不经过系统浏览器代理,而是直接由运行时发起 HTTPS;若你仅给浏览器装了插件或 PAC,而内核层规则没有把相关域纳入 TUN/透明代理,终端仍会像「半直连」。因此本文默认你在本机已启用 Clash 系客户端的系统代理或 TUN 模式 之一,并能在连接日志里看到 ollama 进程的出站记录。
动手写规则前:先抓包列清主机名
在改 rules: 前,用一次完整 ollama pull 模型名 配合客户端日志或系统抓包,把失败会话里出现的主机名记下来。产品迭代与镜像策略会变,下表是理解维度上的归纳,务必以你本机实测为准:
- Ollama 官方库与站点:常见包括
ollama.com、以及用于库索引与下载协调的registry.ollama.ai(或同职能子域)。它们负责 manifest、blob 调度与版本信息,是「能不能开始下」的第一关。 - Hugging Face 主站与短链:
huggingface.co、hf.co等,用于模型页、API、以及部分跳转;若你的模型源显式指向 HF,相关请求应与大型文件下载段策略一致,否则会出现元数据走代理、blob 直连被 QoS 的组合拳。 - LFS 与大文件 CDN:实际权重往往经
cdn-lfs.huggingface.co或同类主机分发;这类域名若被「CDN 全直连」类远程规则提前命中,而上游仍期望与主站同出口,就可能产生隐蔽超时。 - 你自选的 HF 镜像或国内库镜像:例如社区常用的
hf-mirror.com等(以镜像提供方文档为准)。镜像域名应与官方 HF 段分开或并列成组,便于在日志里对照「究竟走镜像还是回源」。 - 证书与脚本外链:偶尔还会夹杂统计、前端资源或第三方对象存储;若只给主域写了规则而漏掉其中一段,会表现为偶发失败而非必现。
策略组:给注册库、HF 与镜像各开一条车道
建议至少准备两组:OLLAMA(覆盖官方库与注册相关主机)与 HUGGINGFACE(覆盖 HF 主站、LFS/CDN 与你确认要同路出口的子域)。若使用镜像,再建 HF_MIRROR 或并入 HUGGINGFACE 但在规则上分条书写,避免「镜像与官方混在一组里却想分别对照」时看不清日志。每组只收你对大文件稳定传输敏感的节点;模型下载 往往比网页浏览更吃长时间吞吐与丢包,不必与默认 PROXY 混用同一「看视频」节点。
在 rules: 中,把所有与 Ollama、Hugging Face、镜像相关的 DOMAIN / DOMAIN-SUFFIX 行放在足够靠前的位置。Clash 系自上而下首次命中即停止:若一条「国内直连」或 GEOIP,CN 比你写的 HF 行更靠前、且误吞了某 CDN 名,你准备的 Clash 分流 就不会生效。
YAML 示意:顺序比「节点有多快」更关键
下例仅说明组名与层级关系;实机请以你的客户端导出、内核版本与订阅名为准。
# proxy-groups excerpt
proxy-groups:
- name: OLLAMA
type: select
proxies:
- 适合大文件长连接的节点
- 备用节点
- DIRECT
- name: HUGGINGFACE
type: select
proxies:
- 与 OLLAMA 可相同或独立
- DIRECT
# rules excerpt — place BEFORE broad DIRECT / GEOIP / giant lists
rules:
- DOMAIN-SUFFIX,ollama.com,OLLAMA
- DOMAIN-SUFFIX,registry.ollama.ai,OLLAMA
- DOMAIN-SUFFIX,huggingface.co,HUGGINGFACE
- DOMAIN-SUFFIX,hf.co,HUGGINGFACE
- DOMAIN-SUFFIX,cdn-lfs.huggingface.co,HUGGINGFACE
# Mirror hostnames you actually use (examples; verify locally):
# - DOMAIN-SUFFIX,hf-mirror.com,HUGGINGFACE
- MATCH,PROXY
实践建议:
- 优先
DOMAIN/DOMAIN-SUFFIX,排查日志时一眼可读;慎用DOMAIN-KEYWORD,避免误伤无关业务。 - 与远程规则集协同时,务必读清合并顺序;参见《Rule Providers 进阶》,避免「列表 A 已直连、列表 B 永不到场」。
- 若你为 HF 设置了环境变量(如
HF_ENDPOINT),仍要在 Clash 侧覆盖解析出来的真实主机名,而不是只记变量字符串。
环境变量与路由:两者要指向同一条「事实路径」
许多教程会建议通过镜像加速 模型下载;这解决的是「上游 URL 指向哪里」,而 Clash 解决的是「该主机名走哪条出口」。若镜像域名在 DNS 层被污染、或在规则层被错误直连,终端仍可能表现为间歇失败。做法是:在修改环境变量后,用一次 ollama pull 触发真实流量,再在连接日志里核对镜像与官方段是否都命中预期策略组,而不是只 ping 通某个首页。
若你在容器或 systemd 单元里为服务单独注入了代理变量,也要核对是否与宿主机 Clash 的监听地址一致;容器网络命名空间下,127.0.0.1 并不总是宿主机上的 Clash 端口。此类进程级差异,与 网页与 API 成对验证 的思路同源:不同运行时看到的路径必须收敛到同一套路由决策链。
误判一:DNS 与 fake-ip 让「规则对了也连不上」
开启 fake-ip、拆分 nameserver / fallback、或对特定后缀使用 DoH 时,应用层看到的结果与核心用于建连的解析路径可能不一致。对大体量 模型下载,TLS 与 SNI 的一致性更重要;若 DNS 经本地运营商抢答、而 TCP 实际走代理,会表现为握手阶段长时间挂起或证书链异常。建议逐步核对:相关域是否由 Clash DNS 模块处理、nameserver-policy 是否覆盖新出现的镜像子域、以及是否存在污染回退把解析指到意外网段。更系统的分层,可对照 《已连接却打不开的 DNS 与规则排查》。
误判二:直连规则「抢答」了大文件段
巨型「国内站直连」或合并过激的规则集,有时会把某些 CDN 主机划进 DIRECT。表现常为:小 JSON 秒回,大 blob 在劣质链路上拖到超时。处理方式是看日志里的最终命中,再把 Hugging Face 与 Ollama 相关行整体上移,使其先于宽泛 GEOIP 与国内大类。
误判三:HTTP/3(QUIC)与半开 UDP
部分下载栈或依赖库会尝试 HTTP/3;若当前节点对 UDP/QUIC 支持不完整,协商期会像「卡住不动」。也可能出现 TCP 已走代理、UDP 仍从本机出的半开状态。可对照实验:暂时关闭相关 HTTP/3 选项,或阅读 《QUIC 与 HTTP/3 干扰》 的分层思路,把 UDP 相关项写进你的固定排错表。
连接日志里优先筛什么?
卡住时在日志中固定记录三项:主机名、最终策略组、错误类型。若同一次 pull 中,registry.* 走 OLLAMA 而某条 cdn-lfs.* 走 DIRECT,就应回头查规则顺序与后缀覆盖。先过滤 ollama 与 huggingface 关键字,再对比「成功会话 / 失败会话」的差集,比盲换节点有效得多。
可打印自检清单(按顺序勾)
| 步骤 | 检查点 | 期望 |
|---|---|---|
| 1 | 一次完整 pull 中出现的 Host 是否齐全 | 无单域名长时间 pending 或成批失败 |
| 2 | 注册库与 HF/CDN 命中策略组是否一致 | 可接受分两组,但不应意外直连抢答 |
| 3 | 镜像与官方段是否都纳入规则 | 日志无「半镜像半回源」的混乱出口 |
| 4 | DNS 模式与 nameserver |
解析与出站决策链闭合 |
| 5 | 在 OLLAMA/HUGGINGFACE 组内做节点 A/B | 至少一条链路可稳定完成大文件拉取 |
| 6 | 容器/服务单元与宿主代理地址 | 进程实际命中与浏览器无关时也要一致 |
合规与使用边界
本文仅从网络路径与 Clash 技术角度讨论 模型下载 稳定性。请遵守 Ollama、Hugging Face 及所使用镜像站的服务条款与出口地规定;尊重模型许可证与分发限制。代理与分流用于改善链路质量,不应用于规避合理的访问控制或版权机制。
小结
Ollama 与 Hugging Face 相关的「拉模型总超时」,很多时候不是「再换一个更快的节点」就能解决,而是多段主机名没有在同一套规则与 DNS 链上收敛。先抓包列清单,再为注册库与 HF 系建独立策略组、把显式域名规则写在大段直连与 GEOIP 之前,并系统排查 DNS、抢答与 QUIC,就能把 本地大模型 场景下的间歇失败从玄学拉回可证伪的几步。与站内偏网页/API 的 AI 分流稿相比,本文补的是权重下载链这一环。
若需先统一下载渠道与客户端版本,再按本文做域名级 Clash 分流,可从本站 下载页 获取当前平台包,并参阅 使用文档 理解系统代理与 TUN 的差异。统一来源能减少「示例与内核版本不一致」的额外干扰。
相比把境外流量笼统丢进默认组,为 模型下载 单独维护策略并配合可打印自检,在日志对因与长期可维护性上通常更省心。