大模型应用开发 / 系统课时

使用 pull 管理模型下载

使用 pull 管理模型下载

学习目标

完成本课后,你将能够:

  • 使用 ollama pull 预先下载指定模型
  • 理解模型名称、标签和分层下载信息
  • 验证下载结果并处理下载中断
  • 在代理和磁盘受限环境中定位失败原因

为什么单独使用 pull

ollama run 适合边下载边使用,ollama pull 则只负责获取或更新模型。服务器上线前、离线环境准备、批量部署和维护窗口中,单独下载更容易控制时间和验证结果。

下载指定标签

执行:

bash
ollama pull gemma3:1b

预期输出示例:

text
pulling manifest
pulling <LAYER_DIGEST>: 100% ...
verifying sha256 digest
writing manifest
success

摘要、分层数量和进度会变化。最终出现 success 表示清单已写入本地。

理解模型标签

模型名通常由仓库名和标签组成:

text
<MODEL_NAME>:<TAG>

标签可能表达参数规模、量化方式、能力或版本。省略标签时通常使用模型仓库定义的默认标签,但默认标签可能随模型维护者调整。需要可重复部署时,应记录完整模型名、标签以及 ollama show 返回的摘要信息。

验证下载结果

执行:

bash
ollama list

预期输出中应包含:

text
NAME          ID          SIZE      MODIFIED
gemma3:1b     <MODEL_ID>  <SIZE>    <MODIFIED>

再查看详情:

bash
ollama show gemma3:1b

预期输出中通常包含模型架构、参数规模、上下文长度、量化等级、模板或许可证信息。字段会随模型变化。

中断后重新执行

下载由多个内容分层组成。网络中断后,先恢复网络,再重新执行相同的 ollama pull 命令。已经完整保存并通过摘要校验的内容通常可以复用,CLI 会继续处理缺失部分。

不要在下载过程中手动删除 blobs 目录中的单个文件。手工破坏内容寻址数据可能影响其他共用分层的模型。

更新本地模型

再次执行相同命令:

bash
ollama pull gemma3:1b

预期输出:

text
pulling manifest
...
success

如果远端清单没有变化,实际下载量可能很小;如果模型更新,Ollama 会获取新的清单和缺失分层。更新后应运行固定测试提示词,确认回答质量和资源占用没有不可接受变化。

检查磁盘与目录

Linux 或 macOS:

bash
df -h "${OLLAMA_MODELS:-$HOME/.ollama/models}" 2>/dev/null || df -h "$HOME"

预期输出:

text
Filesystem    Size    Used    Avail    Use%    Mounted on
<DEVICE>      <SIZE>  <USED>  <FREE>   <PERCENT> <MOUNT>

Windows PowerShell:

powershell
Get-Volume | Where-Object DriveLetter | Select-Object DriveLetter, SizeRemaining, Size

预期输出:

text
DriveLetter    SizeRemaining    Size
-----------    -------------    ----
<DRIVE>        <FREE_BYTES>     <TOTAL_BYTES>

下载前应同时预留模型文件、临时写入和后续更新空间。

代理与网络排查

Ollama 拉取模型需要出站 HTTPS。企业网络中应确认:

  • HTTPS_PROXY 指向可用代理。
  • 代理证书已被系统信任。
  • 防火墙允许访问模型服务。
  • DNS 能解析目标域名。
  • 代理没有限制大文件或长连接。
  • 修改服务环境变量后已经重启 Ollama。

不要为解决下载问题随意配置入站 HTTP 代理变量;错误的 HTTP_PROXY 可能干扰本地服务通信。

本课练习

练习 1:预下载两个标签

任务目标:掌握标签化下载。输入或初始条件:选择同一模型仓库的两个可用标签。实现要求:分别执行 pull 并记录大小

验收条件:ollama list 中能区分两个完整名称。

练习 2:模拟下载中断

任务目标:验证重新执行同一命令的恢复行为。输入或初始条件:下载一个尚未存在的模型,并在中途停止命令。实现要求:恢复网络后重新执行。验收条件:最终出现 success,模型可用。

练习 3:制定上线下载清单

任务目标:让部署过程可复现。输入或初始条件:准备一台新服务器。

实现要求:记录完整模型标签、磁盘预算、代理、校验和测试步骤。验收条件:另一台设备可按清单完成相同下载。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 pull 管理模型下载

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通