大模型应用开发 / 系统课时
使用 pull 管理模型下载
使用 pull 管理模型下载
学习目标
完成本课后,你将能够:
- 使用
ollama pull预先下载指定模型- 理解模型名称、标签和分层下载信息
- 验证下载结果并处理下载中断
- 在代理和磁盘受限环境中定位失败原因
为什么单独使用 pull
ollama run 适合边下载边使用,ollama pull 则只负责获取或更新模型。服务器上线前、离线环境准备、批量部署和维护窗口中,单独下载更容易控制时间和验证结果。
下载指定标签
执行:
ollama pull gemma3:1b预期输出示例:
pulling manifest
pulling <LAYER_DIGEST>: 100% ...
verifying sha256 digest
writing manifest
success摘要、分层数量和进度会变化。最终出现 success 表示清单已写入本地。
理解模型标签
模型名通常由仓库名和标签组成:
<MODEL_NAME>:<TAG>标签可能表达参数规模、量化方式、能力或版本。省略标签时通常使用模型仓库定义的默认标签,但默认标签可能随模型维护者调整。需要可重复部署时,应记录完整模型名、标签以及 ollama show 返回的摘要信息。
验证下载结果
执行:
ollama list预期输出中应包含:
NAME ID SIZE MODIFIED
gemma3:1b <MODEL_ID> <SIZE> <MODIFIED>再查看详情:
ollama show gemma3:1b预期输出中通常包含模型架构、参数规模、上下文长度、量化等级、模板或许可证信息。字段会随模型变化。
中断后重新执行
下载由多个内容分层组成。网络中断后,先恢复网络,再重新执行相同的 ollama pull 命令。已经完整保存并通过摘要校验的内容通常可以复用,CLI 会继续处理缺失部分。
不要在下载过程中手动删除 blobs 目录中的单个文件。手工破坏内容寻址数据可能影响其他共用分层的模型。
更新本地模型
再次执行相同命令:
ollama pull gemma3:1b预期输出:
pulling manifest
...
success如果远端清单没有变化,实际下载量可能很小;如果模型更新,Ollama 会获取新的清单和缺失分层。更新后应运行固定测试提示词,确认回答质量和资源占用没有不可接受变化。
检查磁盘与目录
Linux 或 macOS:
df -h "${OLLAMA_MODELS:-$HOME/.ollama/models}" 2>/dev/null || df -h "$HOME"预期输出:
Filesystem Size Used Avail Use% Mounted on
<DEVICE> <SIZE> <USED> <FREE> <PERCENT> <MOUNT>Windows PowerShell:
Get-Volume | Where-Object DriveLetter | Select-Object DriveLetter, SizeRemaining, Size预期输出:
DriveLetter SizeRemaining Size
----------- ------------- ----
<DRIVE> <FREE_BYTES> <TOTAL_BYTES>下载前应同时预留模型文件、临时写入和后续更新空间。
代理与网络排查
Ollama 拉取模型需要出站 HTTPS。企业网络中应确认:
HTTPS_PROXY指向可用代理。- 代理证书已被系统信任。
- 防火墙允许访问模型服务。
- DNS 能解析目标域名。
- 代理没有限制大文件或长连接。
- 修改服务环境变量后已经重启 Ollama。
不要为解决下载问题随意配置入站 HTTP 代理变量;错误的 HTTP_PROXY 可能干扰本地服务通信。
本课练习
练习 1:预下载两个标签
任务目标:掌握标签化下载。输入或初始条件:选择同一模型仓库的两个可用标签。实现要求:分别执行 pull 并记录大小
验收条件:ollama list 中能区分两个完整名称。
练习 2:模拟下载中断
任务目标:验证重新执行同一命令的恢复行为。输入或初始条件:下载一个尚未存在的模型,并在中途停止命令。实现要求:恢复网络后重新执行。验收条件:最终出现 success,模型可用。
练习 3:制定上线下载清单
任务目标:让部署过程可复现。输入或初始条件:准备一台新服务器。
实现要求:记录完整模型标签、磁盘预算、代理、校验和测试步骤。验收条件:另一台设备可按清单完成相同下载。