Skip to content

Chatbox 连接本机 Ollama:本地模型配置指南

约 1184 字大约 4 分钟

OllamaDeepSeekChatboxAI

...

2025-02-12

已经在电脑上运行 Ollama,想用聊天界面操作本地模型,可以让 Chatbox 桌面端和 Ollama 运行在同一台电脑上。本篇只介绍连接自己的本机服务,或你获准管理的本机环境。

先按本地部署指南选择适合电脑资源的模型并完成下载,再配置 Chatbox。这里不涉及云端模型或第三方服务;本地运行仍需要相应的内存、磁盘空间和计算资源。

一、准备本机模型

  1. 按Ollama 本地部署指南完成安装,选择并下载模型。
  2. 确认 Ollama 已在当前电脑运行;记下已经下载的模型名称。
  3. 从 Chatbox 官方网站获取桌面端,安装在同一台电脑上。本篇不是网页版、手机或另一台电脑的连接教程。

在本机终端执行以下只读命令,可以查看已下载的模型:

ollama list

如果列表为空,先回到本地部署指南完成模型下载。不要只在 Chatbox 填入一个尚未下载的模型名称。

二、确认本机服务地址

Ollama 官方 FAQ说明,默认服务绑定在本机 127.0.0.1 的 11434 端口。按 Chatbox 官方 Ollama 指南,本篇使用的 API Host 是:

http://localhost:11434

这里的 localhost 指运行 Chatbox 的这台电脑。保持本机默认绑定即可,不需要开放端口或修改防火墙、跨域和监听设置。

三、在 Chatbox 中配置 Ollama

  1. 打开 Chatbox 桌面端的设置,进入模型提供方设置;具体界面名称可能随版本变化。
  2. 添加或选择 Ollama 提供方。
  3. 在 API Host(API 地址) 填入 http://localhost:11434 并保存。不在后面添加聊天接口路径。
  4. 从模型列表中选择刚才已下载的本地模型;若界面需要手动输入名称,使用 ollama list 中的完整名称。
  5. 选择这个提供方和模型,开始一个新对话,用不含敏感信息的普通问题,例如“请用一句话解释什么是回形针”,检查是否能收到回答。

收到回答后,再确认对话所选的确实是 Ollama 和该本地模型。本文配置依据官方文档整理,不代表已在你的设备上实测;首次加载和响应速度取决于模型及电脑资源。

四、连接失败时怎么排查

  • 无法连接:先确认 Ollama 正在同一台电脑运行,再检查 API Host 是否为 http://localhost:11434。本机配置不需要改为外部地址。
  • 模型列表为空或找不到模型:用 ollama list 核对下载是否完成、模型名称是否一致,再返回 Chatbox 刷新或重新打开设置。
  • 可以连接但回答很慢或加载失败:先核对电脑可用内存和模型资源需求;必要时按本地部署指南选择更适合的模型,不把连接成功当作性能保证。
  • 设置改错:在 Chatbox 的 Ollama 提供方中恢复上述本机 API Host,重新选择原来已下载的模型即可。本教程不要求更改系统网络设置。

只在自己或明确获准管理的本机环境进行配置。初次验证不输入账号密码、私人文档或其他敏感内容。

五、完成配置后核对

确认三件事:Chatbox 与 Ollama 在同一台电脑、API Host 是本机地址、选中的是已下载的本地模型。先用普通测试问题验证,再按实际硬件能力选择适合自己的模型。

六、相关资料

通过Ollama本地部署DeepSeek代码大模型:从硬件配置到VSCode实战指南

便宜好用的翻墙机场推荐评测(长期更新 欢迎推荐)

使用cloudflare进行URL重定向