Ollama 安装指南

1. 官方安装方式

Windows 系统

方法一：图形安装程序（推荐）

1. 访问官网下载页面：https://ollama.com/download
2. 下载 Windows 安装包 (OllamaSetup.exe)
3. 双击运行安装程序，按提示完成安装
4. 安装完成后，Ollama 会自动在后台运行

方法二：命令行安装

# 使用 winget 安装
winget install Ollama.Ollama

# 或使用 PowerShell 脚本
powershell -c "irm ollama.com/install.ps1 | iex"

macOS 系统

方法一：图形安装程序

1. 访问 https://ollama.com/download
2. 下载 macOS 安装包 (.dmg 文件)
3. 双击打开，拖拽到 Applications 文件夹
4. 首次运行可能需要允许来自开发者的应用

方法二：Homebrew 安装

brew install ollama
ollama serve  # 启动服务

Linux 系统

快速安装脚本（推荐）

curl -fsSL https://ollama.com/install.sh | sh

手动安装

# 下载并安装
curl -L https://ollama.com/download/ollama-linux-amd64.tgz -o ollama-linux-amd64.tgz
sudo tar -C /usr -xzf ollama-linux-amd64.tgz

# 启动服务
ollama serve

Systemd 服务（后台运行）

# 创建 systemd 服务
curl -L https://ollama.com/install.sh | sh

# 启动并启用服务
sudo systemctl start ollama
sudo systemctl enable ollama

# 查看状态
sudo systemctl status ollama

2. 验证安装

安装完成后，打开终端/命令行执行：

# 检查版本
ollama --version

# 启动服务（如果未自动启动）
ollama serve

# 在另一个终端运行测试
ollama run llama3

如果看到模型下载并开始对话，说明安装成功。

3. 常用配置

设置代理（如需要）

# Windows (PowerShell)
$env:OLLAMA_PROXY="http://your-proxy:port"
ollama pull llama3

# Linux/macOS
export OLLAMA_PROXY="http://your-proxy:port"
ollama pull llama3

修改默认端口

# 启动时指定端口
OLLAMA_HOST=127.0.0.1:11435 ollama serve

设置模型存储位置

# Linux/macOS
export OLLAMA_MODELS=/path/to/models

# Windows (PowerShell)
$env:OLLAMA_MODELS="D:\ollama\models"

4. 下载模型

# 下载模型（自动从官方仓库）
ollama pull llama3
ollama pull qwen2
ollama pull mistral

# 查看已下载模型
ollama list

# 删除模型
ollama rm llama3

5. 常见问题

问题：安装后无法找到 ollama 命令

解决方案：

• Windows：重启终端或重新登录
• macOS/Linux：检查 PATH 环境变量，或手动添加：

  export PATH="$HOME/.ollama/bin:$PATH"
  

问题：模型下载慢或失败

解决方案：

• 使用国内镜像源（如阿里云、腾讯云镜像）
• 设置代理
• 检查网络连接

问题：GPU 无法识别

解决方案：

• NVIDIA GPU：确保已安装 CUDA 驱动
• AMD GPU：确保系统支持 ROCm
• Mac M1/M2：自动使用 Metal 加速

6. 卸载

Windows

• 通过"设置 > 应用"卸载 Ollama
• 或删除安装目录并清理环境变量

macOS

# 停止服务
killall ollama

# 删除应用
rm -rf /Applications/Ollama.app

# 删除模型和数据
rm -rf ~/.ollama

Linux

# 停止服务
sudo systemctl stop ollama
sudo systemctl disable ollama

# 删除安装
sudo rm -rf /usr/local/lib/ollama
sudo rm -rf /usr/local/bin/ollama
sudo rm -rf ~/.ollama

---

安装完成后，即可开始使用 Ollama 运行本地大语言模型。建议先运行一个小模型（如 llama3:8b）测试环境是否正常。