Ollama模型存放地址修改指南

Ollama模型下载路径配置核心知识点

• 关键操作：通过环境变量修改Ollama模型存储目录

默认模型存储位置

Ollama默认将所有模型保存至系统盘。Windows路径为 C:\Users\<用户名>\.ollama\models，Linux/macOS路径为 ~/.ollama/models。随着模型体积增长（常见大模型超10GB），系统盘空间会迅速耗尽。解决方案很简单：设置环境变量 OLLAMA_MODELS，将模型仓库迁移至其他分区或硬盘。

1. Windows 系统配置步骤

方法一：系统环境变量配置（生产环境首选）

• 进入「系统属性」→「高级」→「环境变量」
• 在「系统变量」区域点击「新建」
• 填入以下变量：

变量名：OLLAMA_MODELS
变量值：D:\Ollama\models   # 请替换为实际存储路径

配置完成后，必须重启Ollama服务才能应用变更，执行以下命令：

net stop ollama
net start ollama

方法二：PowerShell临时变量（适合测试或脚本）

若仅需临时切换路径或通过脚本动态设置，可使用PowerShell临时变量。注意该设置仅对当前会话生效：

$env:OLLAMA_MODELS = "D:\Ollama\models"

如需永久写入，使用[Environment]::SetEnvironmentVariable命令：

[Environment]::SetEnvironmentVariable("OLLAMA_MODELS", "D:\Ollama\models", "Machine")

2. macOS/Linux 系统配置步骤

类Unix系统临时设置只需一行export命令：

export OLLAMA_MODELS=/path/to/your/models

永久保存需将指令追加至Shell配置文件（如~/.bashrc或~/.zshrc），然后执行source使变更生效：

echo 'export OLLAMA_MODELS=/path/to/your/models' >> ~/.bashrc
source ~/.bashrc

3. 验证变量是否生效

配置后通过echo命令检查环境变量值：

echo $OLLAMA_MODELS   # Linux/macOS
$env:OLLAMA_MODELS    # Windows PowerShell

若输出为你指定的路径，说明配置成功。

4. 迁移已有模型文件

若之前已下载过模型，修改路径后需手动搬运旧文件。操作流程：

• 先停止Ollama服务（Linux执行sudo systemctl stop ollama，Windows执行net stop ollama）
• 将原目录下的模型复制到新路径（Windows用xcopy，Linux/macOS用cp -r）
• 设置新环境变量后重启服务

完整操作示例：

# 1. 停止Ollama
sudo systemctl stop ollama   # Linux
# 或
net stop ollama              # Windows

# 2. 拷贝现有模型至目标目录
# Windows 示例：
xcopy "C:\Users\%USERNAME%\.ollama\models" "D:\Ollama\models" /E /H /C /I
# Linux/macOS 示例：
cp -r ~/.ollama/models/* /path/to/new/location/

# 3. 设置新路径并重启服务
export OLLAMA_MODELS=/path/to/new/location
net start ollama             # Windows
sudo systemctl start ollama  # Linux

⚠️ 常见问题排查

环境变量设置后不生效

症状：已设置OLLAMA_MODELS，但模型仍下载到默认目录。 解决方法：依次检查以下要点：

• 确认Ollama服务已重启——未重启则配置不会加载
• 区分用户变量与系统变量：建议在系统变量中设置以覆盖所有用户
• 验证目标路径是否存在且当前用户拥有写权限
• 终极手段：重启操作系统，可解决多数环境变量未刷新的问题

权限检查命令：

ls -ld $OLLAMA_MODELS   # Linux/macOS
Get-Acl $env:OLLAMA_MODELS   # Windows PowerShell

来源：互联网