本地装 Ollama 拉模型是最常见的一关:ollama pull 转半天,然后 connection error 或直接卡死。

报错现象

pulling manifest
pulling xxx...   0%   (卡住不动)

或:

Error: pull model manifest: file does not exist
Error: connection error: dial tcp: i/o timeout

原因分析

  • Ollama 默认从 registry.ollama.ai 拉模型,国内网络直连不稳定
  • 大模型几个 GB,下载中途网络抖动就断开,而 Ollama 的断点续传有时会卡住

解决步骤

1. 配置国内镜像源

Windows 设置环境变量:

setx OLLAMA_MODELS "D:\ollama\models"
setx OLLAMA_HOST "127.0.0.1:11434"

提示:镜像源地址会变动,请以当前可用镜像为准(常见如 docker.1ms.run 等加速站的 ollama 镜像)。配置后重启 Ollama 再拉。

2. 重试的正确姿势

  1. 先 ollama rm <模型名> 清掉残缺的模型记录
  2. 再重新 ollama pull <模型名>
  3. 大模型分多次拉:每次中断后重新执行 pull,Ollama 会从已下载部分继续

3. 实在拉不动时

  1. 换一个小模型验证网络与配置,如 ollama pull qwen2.5:1.5b
  2. 小模型能拉,说明是带宽问题,错峰再拉大模型
  3. 也可以手动下载 GGUF 文件放到 OLLAMA_MODELS 目录导入

效果验证

  • ollama list 能看到模型,size 完整
  • 本地对话正常:ollama run <模型名>
  • API 调用 http://127.0.0.1:11434/api/chat 有响应

核心经验:pull 超时九成是网络,不是命令错。配好镜像源 + 清掉残缺记录重拉,基本都能解决。

按教程操作还是没解决？直接把报错原文发我，帮你定位。

找我问