Ollama 自定义安装路径指南

本指南详细介绍如何在不同操作系统上自定义 Ollama 的安装路径和模型存储位置。

一、默认安装路径

Windows 系统

程序安装目录：

C:\Users\用户名\AppData\Local\Programs\Ollama

包含主程序及运行组件。

模型存储目录：

C:\Users\用户名\.ollama\models

存放下载的模型文件。

配置文件目录：

C:\Users\用户名\AppData\Local\Ollama

包含日志和环境设置等。

macOS 系统

程序安装目录：

/Applications/Ollama.app

主应用程序包。

可执行文件：

/usr/local/bin/ollama

命令行工具。

模型存储目录：

~/.ollama/models

存放下载的模型文件。

配置文件目录：

~/.ollama

包含配置和日志文件。

Linux 系统

程序安装目录：

/usr/local/bin/ollama

主可执行文件。

服务文件：

/etc/systemd/system/ollama.service

系统服务配置。

模型存储目录：

/usr/share/ollama/.ollama/models

或

~/.ollama/models

存放下载的模型文件。

配置文件目录：

/usr/share/ollama

包含配置和数据文件。

二、自定义安装路径

Windows 系统

方法一：通过安装程序参数

在命令行中使用 /DIR 参数指定安装目录：

OllamaSetup.exe /DIR="D:\ai\ollama"

方法二：通过环境变量

设置 OLLAMA_MODELS 环境变量来自定义模型存储路径：

临时设置（当前会话有效）：

set OLLAMA_MODELS=D:\ai\ollama\models

永久设置（通过系统环境变量）：

1. 右键"此电脑" → "属性"
2. 点击"高级系统设置"
3. 点击"环境变量"
4. 在"用户变量"或"系统变量"中添加：
   • 变量名：OLLAMA_MODELS
   • 变量值：D:\ai\ollama\models

通过 PowerShell 设置：

[Environment]::SetEnvironmentVariable("OLLAMA_MODELS", "D:\ai\ollama\models", "User")

macOS 系统

自定义模型存储路径

临时设置：

export OLLAMA_MODELS=/Users/用户名/Documents/ollama-models

永久设置（添加到 shell 配置文件）：

对于 zsh（macOS 默认）：

echo 'export OLLAMA_MODELS=/Users/用户名/Documents/ollama-models' >> ~/.zshrc
source ~/.zshrc

对于 bash：

echo 'export OLLAMA_MODELS=/Users/用户名/Documents/ollama-models' >> ~/.bash_profile
source ~/.bash_profile

移动现有模型

如果已有模型需要迁移：

# 创建新目录
mkdir -p /Users/用户名/Documents/ollama-models

# 移动现有模型
mv ~/.ollama/models/* /Users/用户名/Documents/ollama-models/

# 设置环境变量
export OLLAMA_MODELS=/Users/用户名/Documents/ollama-models

Linux 系统

自定义模型存储路径

临时设置：

export OLLAMA_MODELS=/home/用户名/ollama-models

永久设置（添加到 shell 配置文件）：

对于 bash：

echo 'export OLLAMA_MODELS=/home/用户名/ollama-models' >> ~/.bashrc
source ~/.bashrc

对于 zsh：

echo 'export OLLAMA_MODELS=/home/用户名/ollama-models' >> ~/.zshrc
source ~/.zshrc

系统级设置

如果使用 systemd 服务，可以在服务文件中设置：

1. 编辑服务文件：

sudo systemctl edit ollama

2. 添加环境变量：

[Service]
Environment="OLLAMA_MODELS=/opt/ollama/models"

3. 重新加载并重启服务：

sudo systemctl daemon-reload
sudo systemctl restart ollama

移动现有模型

# 停止 ollama 服务
sudo systemctl stop ollama

# 创建新目录
sudo mkdir -p /opt/ollama/models

# 移动现有模型
sudo mv /usr/share/ollama/.ollama/models/* /opt/ollama/models/

# 设置权限
sudo chown -R ollama:ollama /opt/ollama/models

# 设置环境变量并重启服务
sudo systemctl restart ollama

三、验证配置

检查模型存储路径

运行以下命令查看当前模型存储路径：

ollama list

检查环境变量

Windows：

echo %OLLAMA_MODELS%

macOS/Linux：

echo $OLLAMA_MODELS

测试新路径

1. 下载一个小模型进行测试：

ollama pull gemma2:2b

2. 检查模型是否存储在指定路径： Windows：

dir "%OLLAMA_MODELS%"

macOS/Linux：

ls -la "$OLLAMA_MODELS"

四、注意事项

磁盘空间要求

• 确保目标路径有足够的磁盘空间
• 大型模型（如 70B 参数）可能需要 40GB+ 空间
• 建议预留至少 100GB 空间用于多个模型

权限设置

Linux 系统：

• 确保 ollama 用户对目标目录有读写权限
• 使用 chown 和 chmod 设置正确的权限

Windows 系统：

• 避免使用需要管理员权限的系统目录
• 确保用户对目标目录有完全控制权限

网络存储

• 不建议将模型存储在网络驱动器上
• 网络延迟会严重影响模型加载和推理性能
• 如必须使用，确保网络连接稳定且高速

备份建议

• 定期备份重要的自定义模型和配置
• 考虑使用版本控制系统管理 Modelfile
• 记录自定义配置以便系统重装后恢复

五、故障排除

模型无法找到

如果设置自定义路径后模型无法找到：

1. 检查环境变量是否正确设置
2. 重启 ollama 服务或重新打开终端
3. 确认模型文件确实存在于指定路径

权限错误

Linux/macOS：

sudo chown -R $USER:$USER /path/to/ollama/models
chmod -R 755 /path/to/ollama/models

Windows：

• 右键目标文件夹 → "属性" → "安全"
• 确保当前用户有"完全控制"权限

路径包含空格

如果路径包含空格，确保使用引号：

Windows：

set OLLAMA_MODELS="D:\Program Files\Ollama\Models"

macOS/Linux：

export OLLAMA_MODELS="/home/user/ollama models"

---

通过以上配置，您可以根据需要自定义 Ollama 的安装和存储路径，更好地管理磁盘空间和组织文件结构。