Hollama 怎么用:连接 Ollama 与对话验证
Hollama 是一个跑在浏览器里的 Ollama 图形界面,安装后能不能用,关键看它有没有正确连上 Ollama 服务。
本文按“先确认服务、再填地址、最后验证对话”的顺序,把新手最容易卡住的几步讲清楚。
开始前先确认 Ollama 服务本身可用
Hollama 只是前端,真正生成回答的是 Ollama。
如果 Ollama 没有运行,或者端口没监听,Hollama 页面再正常也拿不到模型列表。
先在服务器或本机执行:
ollama list
curl http://127.0.0.1:11434/api/tags
第一条命令能列出模型,说明 Ollama 已经装好并加载了模型;
第二条返回 JSON 列表,说明接口在响应。
如果 curl 连接被拒绝,先启动服务:
systemctl start ollama
systemctl enable ollama
如果你的 Ollama 跑在 Docker 里,确认容器端口映射到了宿主机,例如 -p 11434:11434,再用 docker ps 检查容器状态。
在 Hollama 里填写 Ollama 地址
打开 Hollama 页面后,进入设置区域找到 Ollama 服务地址(不同版本入口名称可能略有差异,通常在设置或模型配置里)。
地址要指向 Ollama 的 API 根路径,不是 Hollama 自己的页面地址。
常见写法:
http://127.0.0.1:11434
http://服务器公网IP:11434
http://ollama容器名:11434
填完后保存,回到对话界面刷新模型列表。
如果列表里出现你已经 ollama pull 过的模型名,说明地址填写正确。
注意不要多写 /api 或 /v1 后缀,除非你使用的 Hollama 版本明确要求。
选择模型并验证一次对话
模型列表出来后,在顶部或侧边栏选择模型,输入一句简单问题,例如“用一句话说明什么是 Docker”,然后发送。
验证时看三个点:
- 回答是否在几秒内开始流式输出;
- 页面是否显示当前模型名;
- 浏览器开发者工具的 Network 面板里,请求是否返回 200。
如果回答一直转圈,先回到上一步确认模型是否真的下载完成。
执行 ollama list 能看到模型名,但大小异常或状态不完整时,重新拉取一次。
模型列表为空或请求失败怎么查
这是 Hollama 使用中最常见的问题,按下面顺序排查:
- Ollama 是否在运行:
systemctl status ollama或docker ps查看进程。 - 地址是否可达:在浏览器所在机器上
curl http://地址:11434/api/tags,能返回 JSON 才说明网络通。 - 是否被跨域拦截:Hollama 在浏览器里直接请求 Ollama,如果两者域名或端口不同,Ollama 需要允许跨域。可在启动 Ollama 时设置环境变量:
OLLAMA_ORIGINS=* ollama serve
使用 systemd 时,把 Environment="OLLAMA_ORIGINS=*" 写进服务配置后重启。
生产环境不建议长期用 *,应改成 Hollama 的实际访问地址。
- 防火墙是否放行:服务器上检查
11434端口是否对 Hollama 所在网络开放,云服务器还要看安全组规则。
避坑提醒
- 不要把 Hollama 的访问地址当成 Ollama 地址填进去,两者端口通常不同。
- 通过 HTTPS 访问 Hollama 时,如果 Ollama 是 HTTP,浏览器可能拦截混合内容,需要统一协议或走反向代理。
- 修改 Ollama 环境变量后要重启服务,只改配置文件不重启不会生效。
- 公网暴露
11434端口有风险,建议只在内网或通过带认证的反向代理访问。
完成以上步骤后,Hollama 应该能正常列出模型并对话。
如果仍然失败,优先用 curl 验证 Ollama 接口本身,再检查浏览器控制台的报错信息,通常能快速定位是网络、跨域还是地址填写问题。