Chatbox 连接本机 Ollama:本地模型配置指南
已经在电脑上运行 Ollama,想用聊天界面操作本地模型,可以让 Chatbox 桌面端和 Ollama 运行在同一台电脑上。本篇只介绍连接自己的本机服务,或你获准管理的本机环境。
先按本地部署指南选择适合电脑资源的模型并完成下载,再配置 Chatbox。这里不涉及云端模型或第三方服务;本地运行仍需要相应的内存、磁盘空间和计算资源。
一、准备本机模型
- 按Ollama 本地部署指南完成安装,选择并下载模型。
- 确认 Ollama 已在当前电脑运行;记下已经下载的模型名称。
- 从 Chatbox 官方网站获取桌面端,安装在同一台电脑上。本篇不是网页版、手机或另一台电脑的连接教程。
在本机终端执行以下只读命令,可以查看已下载的模型:
ollama list如果列表为空,先回到本地部署指南完成模型下载。不要只在 Chatbox 填入一个尚未下载的模型名称。
二、确认本机服务地址
Ollama 官方 FAQ说明,默认服务绑定在本机 127.0.0.1 的 11434 端口。按 Chatbox 官方 Ollama 指南,本篇使用的 API Host 是:
http://localhost:11434这里的 localhost 指运行 Chatbox 的这台电脑。保持本机默认绑定即可,不需要开放端口或修改防火墙、跨域和监听设置。
三、在 Chatbox 中配置 Ollama
- 打开 Chatbox 桌面端的设置,进入模型提供方设置;具体界面名称可能随版本变化。
- 添加或选择 Ollama 提供方。
- 在 API Host(API 地址) 填入
http://localhost:11434并保存。不在后面添加聊天接口路径。 - 从模型列表中选择刚才已下载的本地模型;若界面需要手动输入名称,使用
ollama list中的完整名称。 - 选择这个提供方和模型,开始一个新对话,用不含敏感信息的普通问题,例如“请用一句话解释什么是回形针”,检查是否能收到回答。
收到回答后,再确认对话所选的确实是 Ollama 和该本地模型。本文配置依据官方文档整理,不代表已在你的设备上实测;首次加载和响应速度取决于模型及电脑资源。
四、连接失败时怎么排查
- 无法连接:先确认 Ollama 正在同一台电脑运行,再检查 API Host 是否为
http://localhost:11434。本机配置不需要改为外部地址。 - 模型列表为空或找不到模型:用
ollama list核对下载是否完成、模型名称是否一致,再返回 Chatbox 刷新或重新打开设置。 - 可以连接但回答很慢或加载失败:先核对电脑可用内存和模型资源需求;必要时按本地部署指南选择更适合的模型,不把连接成功当作性能保证。
- 设置改错:在 Chatbox 的 Ollama 提供方中恢复上述本机 API Host,重新选择原来已下载的模型即可。本教程不要求更改系统网络设置。
只在自己或明确获准管理的本机环境进行配置。初次验证不输入账号密码、私人文档或其他敏感内容。
五、完成配置后核对
确认三件事:Chatbox 与 Ollama 在同一台电脑、API Host 是本机地址、选中的是已下载的本地模型。先用普通测试问题验证,再按实际硬件能力选择适合自己的模型。