Ollama 在 Windows 下的安装与配置

简介

本教程将指导您在 Windows 系统中完成 Ollama 的安装与配置，涵盖以下几个部分：

• 下载安装 Ollama
• 配置系统环境变量
• 启动和运行 Ollama
• 验证安装成功
• 解决常见问题

---

1. 访问官网并下载 Ollama

官网资源

• Ollama 下载
• Ollama 官方主页
• Ollama 官方 GitHub

下载安装步骤

1. 下载 OllamaSetup.exe。
2. 双击运行安装程序，点击 Install。
3. 安装完成后，Ollama 会自动运行。
4. 在任务栏找到 Ollama 标志，可右键选择 Quit Ollama 退出或查看 logs。

验证安装

打开 cmd 或 PowerShell 运行：

ollama --version

如果成功返回版本号，则安装成功。

---

2. 配置系统环境变量

主要环境变量

变量	作用
OLLAMA_MODELS	模型存放目录，建议存放在 E:\ollama\models
OLLAMA_HOST	监听地址，默认 127.0.0.1，改为 0.0.0.0 允许局域网访问
OLLAMA_PORT	监听端口，默认 11434，可改为 8080
OLLAMA_KEEP_ALIVE	模型存活时间，默认 5 分钟，建议 24 小时

设置方法

1. 右键 此电脑 → 属性 → 高级系统设置 → 环境变量
2. 点击 新建，添加变量 OLLAMA_MODELS，值设为 E:\ollama\models（这里自己换成适合自己的盘符位置）
3. 关闭窗口并重启计算机使更改生效

---

3. 启动和运行 Ollama

启动 Ollama

ollama serve

后台运行

在 Windows PowerShell 中运行：

Start-Process -NoNewWindow ollama serve

---

4. 验证 Ollama 运行状态

检查端口是否占用

netstat -aon | findstr 11434

示例输出：

TCP 127.0.0.1:11434 0.0.0.0:0 LISTENING 17556

运行测试命令

ollama -h

如果成功看到下面信息，说明 Ollama 运行正常。

---

5. 解决常见问题（当上面安装不出现问题时，此步骤可不看）

端口占用错误

错误信息：

Error: listen tcp 127.0.0.1:11434: bind: Only one usage of each socket address

解决方案：

1. Win+X 打开任务管理器，启动 选项卡中禁用 Ollama。
2. 结束 Ollama 进程，重新运行 ollama serve。

访问失败

错误信息：

Cannot connect to Ollama server

解决方案：

• 确保 Ollama 运行，检查 ollama serve 进程是否存在。
• 确保 OLLAMA_HOST 设置为 0.0.0.0。
• 检查防火墙是否允许 11434 端口通信。

恭喜！你已成功在 Windows 上安装并配置 Ollama！ 🎉