PureChat

Appearance

Ollama 集成 ​

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

Ollama 默认只在本机 127.0.0.1:11434 提供服务。PureChat 可以通过它的 OpenAI 兼容 API 使用本地模型。本页介绍远程访问和浏览器跨域配置；安装、拉取模型及在 PureChat 中添加模型的步骤见本地使用指南。

先验证本机服务 ​

启动 Ollama 后，在浏览器打开 http://localhost:11434/api/tags。如果服务正常，会返回本机模型列表。浏览器无法连接时，请先检查 Ollama 是否正在运行，再用 ollama list 确认模型已安装。

浏览器跨域配置 ​

使用部署在浏览器中的 PureChat 访问 Ollama 时，应允许该 PureChat 网页的来源（origin）。把实际使用的地址加入 OLLAMA_ORIGINS，例如：

  • 本地开发：http://localhost:5173
  • 本地模式网站：https://local.purechat.cn

只在当前 Ollama 默认允许的来源无法满足使用场景时设置此变量。修改后重启 Ollama。更多设置方式见 Ollama 官方 FAQ：允许额外的网页来源。

从另一台设备连接 ​

只有需要从其他设备访问时，才将 OLLAMA_HOST 设置为 0.0.0.0:11434，并在 OLLAMA_ORIGINS 中加入 PureChat 网页的准确来源。随后重启 Ollama，并在 PureChat 中使用模型电脑的局域网地址，例如 http://192.168.1.20:11434/v1。

在 PureChat 服务商设置中使用 OpenAI 兼容地址，填写 Ollama 中的模型名称；如果界面要求 API Key，Ollama 本地接口不验证此值，不要填入自己的线上服务密钥。更多接口示例见 Ollama OpenAI 兼容 API 文档。

跨设备访问只应在可信的本地网络中使用。不要把未经保护的 Ollama 端口暴露到公共互联网。

常见连接问题 ​

  • /api/tags 无法打开： Ollama 服务没有运行，或使用了错误的主机和端口。
  • PureChat 报 CORS 错误： 将 PureChat 当前网址的来源加入 OLLAMA_ORIGINS，重启 Ollama，然后刷新页面。
  • 模型列表为空： 执行 ollama list 检查本地已安装的模型名称。
  • 无法从另一台设备连接： 检查 Ollama 是否监听 0.0.0.0:11434、PureChat 配置是否使用 Ollama 主机的局域网地址，以及防火墙是否允许该端口。