RUNBOOK / Ollama
ollama pull 下载模型卡住：状态流、模型名与本地服务核查
执行 ollama pull 后模型没有完成下载，或调用本地拉取 API 时无法判断下载是否仍在进行。
故障现象与判断依据
最可能原因
Ollama 官方 API 的 /api/pull 接收模型名并默认流式返回状态；先检查本地服务和模型标识，再依据状态流区分连接问题与已完成下载。
LOGcurl http://localhost:11434/api/pull -d '{ "model": "gemma4" }'
{ "status": "success" }安全诊断
以下命令用于读取状态、验证解析或复现请求；先确认目标主机、权限与影响范围。命令中的占位符必须替换为当前环境的实际值。
READ / VERIFYollama pull <model>
ollama ls
ollama ps
# 本机 API 状态核查
curl http://localhost:11434/api/pull -d '{ "model": "<model>" }'推荐修复步骤
- 1执行 ollama pull <model>，保留终端中的状态信息；不要在未确认模型名时反复删除本地模型。
- 2执行 ollama ls 和 ollama ps，区分已下载模型与当前运行模型。
- 3需要 API 级核查时，仅对本机 Ollama 服务调用 POST /api/pull，并读取返回的状态流；外部模型下载仍应先完成网络诊断。
验证、限制与回滚
修复后的验证
ollama ls 出现目标模型；API 拉取完成时返回 success 状态，后续 ollama run <model> 可进入正常加载阶段。
风险提示与回滚
不要以关闭证书校验、删除全部缓存、无限重试、关闭防火墙或放宽到 chmod 777 来替代根因定位。任何配置变更前先保留原文件和校验结果；若验证失败，恢复该备份并重新采集日志。
可信来源与适用边界
参考来源Pull a model - Ollama ↗
POST /api/pull accepts a model and streams status; success is returned on completion 此页将环境级案例与本 Runbook 的检查步骤分开呈现，不能把示例日志当作当前服务器的真实事件。
网络环境检测
当 DNS、代理链路、海外依赖源或下载超时已通过本页命令确认是网络层问题时，可继续核对独立网络服务；这不替代本地根因修复。
访问边界云官方网站 →具体套餐、价格、可用线路、服务内容及相关规则以官网当前页面为准；不会携带你在工作台输入的命令、日志、Token、IP 或邮箱。