现象
执行 ollama pull qwen2.5:7b,终端输出 pulling manifest 之后光标一直停住,十分钟没有任何进度,按 Ctrl+C 再来一次还是卡在同一行。换一个小模型能拉下来,日志里没有报错,只是网络请求一直不返回结果。
原因
pull 分两步:先取 manifest 清单,再按 digest 分层下载。卡在第一步说明与 registry.ollama.ai 的 HTTPS 请求没有完成,常见原因是跨境链路握手超时、本机配了失效的代理、或者模型 tag 写错后客户端在反复重试。模型目录所在分区空间不足时也会停在这一步,因为客户端要先确认可用空间再下载。
解决步骤
第一步,看空间和真实日志。停掉服务,用调试模式前台启动,再执行一次 pull,同时观察模型目录所在分区的剩余空间。
df -h ~/.ollama/models
OLLAMA_DEBUG=1 ollama serve
ollama pull qwen2.5:7b
第二步,确认 registry 是否可达。用 curl 看 TLS 握手和状态码,能通再回到客户端重试;连不上就配置代理,或者把下载地址换到可达的镜像源,改完先清掉半途失败的临时文件。
第三步,绕开在线拉取。手头已经有 GGUF 文件时,写一个 Modelfile,用 FROM 指向本地文件路径,执行 ollama create 导入,整个过程不依赖 registry,也不受网络波动影响。
验证
重新 pull 时清单阶段几秒内完成,随后出现分层下载的百分比并持续增长;用导入方式的,则看 ollama list 里出现模型名,再执行 ollama run 问一句话,能正常回答即说明可用。
小结
卡在 pulling manifest 基本是网络或空间问题,不是模型本身损坏。先确认 registry 可达,再处理代理与镜像,最后用本地导入兜底,比反复重试有效。
