Skip to content

在 PureChat 中使用 Ollama ​

更新于 2026-10-17
总字数
阅读量 ♾️

本文介绍如何在 Windows 或 macOS 下载 Ollama、安装本地模型,并在 PureChat 中连接该模型。需要从其他设备连接或处理跨域报错时,请参阅 Ollama 远程连接与跨域排查。

安装并启动 Ollama ​

从 Ollama 下载页下载适合当前操作系统的版本并启动。桌面应用启动后会在本机提供模型服务。

打开终端或 PowerShell,下载一个本地模型:

bash
ollama pull <模型名称>

模型名称请从 Ollama Library 选择。执行 ollama list 可查看已下载的模型。

在 PureChat 中添加本地模型 ​

  1. 打开运行在同一台电脑上的 PureChat。
  2. 在模型服务商设置中选择 OpenAI 兼容服务,并打开模型配置。
  3. API 地址填写 http://localhost:11434/v1。
  4. 填写与 ollama list 中完全一致的模型名称并保存。
  5. 若配置页面要求 API Key,可填入占位值;Ollama 本地接口不验证此值。不要填入自己的 OpenAI 密钥。

选择刚添加的模型发起对话,即可测试连接。也可先在浏览器访问 http://localhost:11434/api/tags,确认 Ollama 正在运行且模型列表可见。

常见问题 ​

  • 本地模型没有出现在列表中: 执行 ollama list 检查模型名称;尚未安装时,先运行 ollama pull <模型名称>。
  • 浏览器提示跨域错误: 先确认 PureChat 与 Ollama 是否运行在同一台电脑,再按远程连接指南把当前网页来源加入 OLLAMA_ORIGINS。
  • PureChat 无法连接 Ollama: 确认 Ollama 正在运行且 API 地址为 http://localhost:11434/v1。通过代理或从其他设备使用时,改用远程连接指南中的配置。

有关兼容接口与请求示例,请参阅 Ollama 官方 OpenAI 兼容 API 文档与官方 FAQ。