ollama pull 卡住/超时（官方 registry 国内直连不稳定）

症状

`ollama pull` 失败的常见形态：

```

# 形态 1：卡住无进度 / 连接超时（registry 直连不稳）

ollama pull qwen2.5

# 转圈几十分钟没动静，或 Error: ... dial tcp ... i/o timeout

# 形态 2：大文件传输中途断掉

# 下载到一半报 unexpected EOF / connection reset

# 形态 3：模型名不存在（不是网络问题）

Error: pull model manifest: ... not found

```

同族但根因不同（别在本页死磕网络）：

- `pull model manifest: ... not found` → 模型名/标签拼写错或不存在，先到 ModelScope / HuggingFace 核对名称；

- `no space left on device`（下载/导入阶段）→ 模型 4~70GB，先 `df -h /` 确认磁盘；WSL 下 df 有空间但写不进是宿主盘满，见 [wsl-no-space-left](wsl-no-space-left.html)。

原因

官方模型 registry（ollama.com / registry.ollama.ai）国内直连不稳定，大模型文件传输中途失败。

解法

1. 从 ModelScope 下载 GGUF：`curl -sL -o /tmp/qwen2.5-0.5b-instruct-q4_k_m.gguf https://modelscope.cn/models/Qwen/Qwen2.5-0.5B-Instruct-GGUF/resolve/master/qwen2.5-0.5b-instruct-q4_k_m.gguf`。

2. `ollama create qwen2.5:0.5b -f - <<EOF

FROM /tmp/qwen2.5-0.5b-instruct-q4_k_m.gguf

EOF` 导入。

3. `ollama list` 确认，`ollama run` 验证。

验证证据

- 实测（2026-08-29，WSL Ubuntu，ollama 0.33.2 隔离环境）：ModelScope 下载 qwen2.5-0.5b-instruct-q4_k_m GGUF（491MB，58.5s）→ `ollama create` success → CPU 冒烟通过（实测复现日志（2026-08-29））。