Ollama 版本升级与迁移
如何安全地升级 Ollama、把模型库搬到新磁盘或新机器，以及自定义模型的备份与恢复。
做好这三件事，你的本地模型资产就真正属于自己，不惧任何硬件与版本变化。
安全升级：策略先于操作
升级本身很简单，难的是"不翻车"。推荐的三步升级策略：
第一步，看更新说明：Release Notes 里会标注新特性、修复与已知问题，尤其是模型支持与接口变化。
第二步，备份关键资产：导出在用的自定义模型配方（方法见下文），确认模型目录位置。
第三步，先测后推：生产服务器先在一台测试机升级验证，再全面铺开。
| 平台 | 升级方式 |
|---|---|
| macOS / Windows | 自动下载更新，菜单栏或托盘点"Restart to update" |
| Linux（脚本安装） | 重新执行官方安装脚本 |
| Linux（手动安装） | 先删除旧库目录，再解压新包 |
| Docker | pull 新镜像后重建容器，数据卷保留全部模型 |
遇到兼容问题需要回退，或想尝鲜预发布版，用版本号变量精确控制， 安装指定版本（版本号见 GitHub Releases）：
bash
curl -fsSL https://ollama.com/install.sh | OLLAMA_VERSION=0.5.7 sh预发布版本同样通过版本号安装。
Linux 手动升级前先删除旧库目录（sudo rm -rf /usr/lib/ollama），新旧推理库混用是"升级后行为怪异"的头号原因。
模型库迁移：换盘与换机
模型动辄几十 GB，迁移的本质只有一句话：搬走 models 目录，然后告诉 Ollama 新位置在哪。
场景一：同机换盘
实例
bash
# 1. 停服务后，把模型目录整体移动到新磁盘
sudo mv /usr/share/ollama/.ollama/models /data/ollama-models
# 2. 环境变量指向新位置（三平台设置法见配置章节）
OLLAMA_MODELS=/data/ollama-models ollama serve
# 3. Linux 标准安装需移交属主给 ollama 用户
sudo chown -R ollama:ollama /data/ollama-models场景二：迁移到新机器
实例
bash
# 旧机：打包整个 models 目录（含 blobs 与 manifests）
tar czf models-backup.tar.gz -C ~/.ollama models
# 新机：安装相同版本的 Ollama 后解压到对应位置
mkdir -p ~/.ollama
tar xzf models-backup.tar.gz -C ~/.ollama
# 验证模型清单完整
ollama list两个细节决定迁移成败：新机器的 Ollama 版本尽量与旧机一致；models 目录下的 blobs 与 manifests 结构必须原样保留，不要只拷贝单个模型文件。
自定义模型的备份与恢复
自定义模型（Modelfile 构建的产物）有两种备份方式，建议都做。
方式一：导出配方进 Git
实例
bash
# 导出模型的完整配方
ollama show --modelfile runoob-coder > runoob-coder.modelfile注意一个细节：导出的配方中 FROM 行指向的是本机 blob 文件路径，换机器后无法直接使用。恢复时把 FROM 改回基座模型名（如 FROM qwen3.5:9b）再重建即可。
实例
bash
# 修改 FROM 后重新构建，配方即恢复
ollama create runoob-coder -f runoob-coder.modelfile方式二：推送到模型库做云端备份
实例
bash
# 复制成带命名空间的名字后推送（私有发布见团队部署章节）
ollama cp runoob-coder myteam/runoob-coder:v1
ollama push myteam/runoob-coder:v1推荐的组织方式：所有 Modelfile 收进一个 Git 仓库管理，配合一个从零重建环境的脚本——硬件会换、系统会重装，配方在手，十分钟恢复全部定制模型。
AI 思考中...