Ollama 模型迁移到其他盘:Windows 换目录、验证与回退方法

本篇目录 6 节
  1. 一、先确认原模型放在哪里
  2. 二、退出 Ollama,再复制完整目录
  3. 三、配置 OLLAMA_MODELS
  4. 四、验证确实从新目录加载
  5. 五、何时清理旧目录
  6. 六、常见问题与排错

Ollama 模型迁移适合解决系统盘空间不足的问题。本文处理的是 Windows 原生 Ollama 的模型文件,不是 Docker 数据卷,也不是把全部聊天记录迁走。基本流程是退出服务、复制、设置目录、重启和验证,旧目录先保留。准备一个稳定的本地磁盘,并确认它有足够空间容纳完整模型副本。

本地 AI系列主题示意图
系列主题示意图;操作步骤以正文与官方界面为准。

一、先确认原模型放在哪里

默认安装常见模型位置是用户目录下的 .ollama\models,但如果你以前设过 OLLAMA_MODELS,应以该环境变量和实际文件为准。打开 PowerShell 查看:

[Environment]::GetEnvironmentVariable('OLLAMA_MODELS', 'User')
ollama list

记录模型名称与数量,再打开实际目录检查。模型目录通常包含 manifests 和 blobs,不是把几个名字类似模型的文件随意挑出来复制。

二、退出 Ollama,再复制完整目录

先从系统托盘退出 Ollama,并关闭会自动请求模型的客户端。不要一边下载模型一边复制。下面示例假定原目录确实是默认位置、目标是 E:\AI\OllamaModels,请先核对这两个实际路径。

$sourceModels = Join-Path $env:USERPROFILE '.ollama\models'
$targetModels = 'E:\AI\OllamaModels'
Get-Item -LiteralPath $sourceModels
New-Item -ItemType Directory -Path $targetModels -Force
robocopy $sourceModels $targetModels /E /XJ /COPY:DAT /DCOPY:DAT /R:2 /W:2
$copyExit = $LASTEXITCODE
if ($copyExit -ge 8) { throw "Copy failed with code $copyExit" }

这是复制,不是删除或镜像清理。不要把命令改成 /MIR 去覆盖一个已有其他资料的目录。robocopy 的退出码有自己的含义,不能按普通程序“非零就失败”的习惯一概判断。

三、配置 OLLAMA_MODELS

在 Windows 中搜索“编辑账户的环境变量”,新增或修改用户变量 OLLAMA_MODELS,值填写新模型目录。也可以用 PowerShell 设置用户级变量:

[Environment]::SetEnvironmentVariable('OLLAMA_MODELS', 'E:\AI\OllamaModels', 'User')

从开始菜单重新打开 Ollama,再新开一个终端。已经打开的程序可能仍持有旧环境,不能只在原终端里看变量就断言服务已经换盘。

四、验证确实从新目录加载

[Environment]::GetEnvironmentVariable('OLLAMA_MODELS', 'User')
ollama list
ollama run qwen2.5:3b

最后一条要换成你已经复制的本地模型,不要用未下载模型,否则自动下载会掩盖复制失败。核对列表与迁移前一致,运行一个短问题,再看服务日志是否有路径错误。

为了进一步确认,可以在复制并验证后暂时断开网络再测试已下载模型。不要只因 list 能列出名称就认为所有 blobs 已经完整可读。

五、何时清理旧目录

先保留旧目录,完成重启、常用模型加载和目标磁盘权限检查。如果有空间,观察一段时间再决定清理;删除前确认不再有其他程序使用旧目录。目标盘若是可拔出的移动盘,要考虑盘符变化和断开后的影响。

回退时退出 Ollama,将 OLLAMA_MODELS 恢复为原值或在原本未设置时移除该变量,再从开始菜单重启。模型迁移不应顺带清理用户文档或其他软件数据。

六、常见问题与排错

新目录里有文件,但模型列表为空?

检查是否多嵌套了一层 models,变量是否指向含 manifests 与 blobs 的那一层,并确认服务已重启。

为什么模型又重新下载?

可能变量没应用、复制不完整,或请求的模型标签与已有标签不同。先对照迁移前列表,不要继续反复下载。

Docker 里的 Ollama 可以这样迁吗?

不能直接照搬。Docker 模型通常在数据卷中,需要按卷挂载方式备份恢复,不能只改 Windows 用户环境变量。

配置依据见 Ollama Windows 官方文档。复制命令的退出码与参数见 Microsoft robocopy 文档。其他本地数据可看Open WebUI 备份。

1人评论了“Ollama 模型迁移到其他盘:Windows 换目录、验证与回退方法”

  1. Pingback: Open WebUI 备份与恢复:升级前先把聊天、文件和配置保住

评论区已关闭。

滚动至顶部