装完 Ollama,模型也能在终端里聊,一打开 Open WebUI 却是空的、转圈、或者报连接失败。这类情况十有八九不是模型坏了,而是服务地址、端口、容器网络这三处没对上。下面按「先确认哪一层断了」的顺序走一遍,每一步都给能直接执行的检查动作。
装完 Ollama,终端里聊得好好的,一开 Open WebUI 就是空白、转圈,或者直接甩一句连接失败。先别怀疑模型。真实情况里,毛病大多出在「连不上」,而不是「跑不动」。这两件事的排查方向完全相反,搞混了就白折腾半天。
下面按「先确认断在哪一层」的顺序走一遍。每一步都给你能直接动手的检查动作,能执行、能看结果,不是让你凭感觉猜。整条链路其实不长,麻烦在于几个地址长得像,一填错格就全盘皆输。
先分清是三层里的哪一层断了
把这条链路拆成三段看:Ollama 服务本身在不在干活、Open WebUI 到 Ollama 之间的网络通不通、Open WebUI 里填的模型配置对不对。三段是串起来的,前一段断了,后面怎么调都没用。所以第一件事不是改配置,是定位。
最省事的入口是终端。直接在命令行里问 Ollama 一句,能正常出字,说明第一层没事,问题在后面两层。如果终端里也出不来,那先修服务,别去动 Open WebUI 的任何设置。
| 现象 | 更可能断在哪一层 | 先做什么 |
|---|---|---|
| 终端能聊,界面空白或转圈 | 网络通路或模型配置 | 查 Open WebUI 里填的地址 |
| 终端也问不出字 | Ollama 服务本身 | 查服务是否真的在监听 |
| 界面报连接失败,终端正常 | 地址填错或端口不通 | 做一次连通性测试 |
| 能看到模型但列表是空的 | 模型没拉全或名字不对 | 回命令行核对本地模型 |
确认 Ollama 真的在提供服务
进程在跑,不等于接口能用。很多人看一眼任务管理器有那个进程就放心了,结果接口根本没起来。判断标准很简单:直接打本机接口,看返回里有没有模型列表。有列表,才算这一层过关。
- 直接请求本机接口用 curl 打本机端口,看返回内容里有没有模型清单;返回空或者连不上,说明服务没真正对外提供。
- 确认监听地址服务默认只监听本机回环地址。同一台机器的浏览器能开,容器里却连不上,八成就是这里。
- 改完再验一次改监听地址需要动环境变量并重启服务,改完不要只看配置文件,回打一次接口确认真的生效。
这一步有个常见误判:以为改了配置就完事。实际上环境变量写在哪个文件、有没有被当前启动方式读到,都会影响结果。改完不复验,等于没改。
容器、远程机和浏览器三种走法别混
这是最容易翻车的一节。Open WebUI 跑在容器里时,容器内的本机地址指向容器自己,不是宿主机。你在浏览器里填本机地址能通,照抄进容器配置就必然失败。填之前先想清楚:这个地址是从谁的视角看的。
- 容器里要填宿主机的可达地址,不是回环地址;填错格是最常见的失败原因
- 填宿主机地址前先确认防火墙放行,用最朴素的连通性测试先验一遍端口
- 跨机器访问要同时改 Ollama 的监听地址和 Open WebUI 里的地址,只改一头一定不通
- 浏览器能打开管理界面,不代表浏览器能直连 Ollama,这两条路要分开验
如果测试一直不通,先别加配置,退回最基础的一步:从目标机器上直接请求那个端口,看能不能拿到响应。拿不到,就是网络层的事,跟模型、跟界面都没关系。
模型列表是空的怎么查
界面里模型列表空白,很多人第一反应是刷新页面。顺序反了。先在命令行确认模型确实在本地列表里,再回界面刷新。命令行里都没有,界面刷一百次也出不来。
模型名也有讲究。要按实际拉下来的完整标签填,少一段后缀就是找不到。拉取中断留下的半成品文件会占位但不完整,这种删掉重拉,比对着界面反复刷新省时间得多。
这几件事先别急着做
排查时最耗时间的往往不是问题本身,而是错误动作。下面这几件,除非你已经定位到具体原因,否则先放着。
- 没看清报错就把两边都重装,装完配置文件还是原来那份,问题原样复现
- 把监听地址直接放开到全部网卡又不做访问控制,排查是方便了,暴露面也变大了
- 拿第三方中转地址代替本地地址测试,测通了也说明不了你这套链路是好的
- 一边改配置一边刷新界面,改了什么自己都记不清,最后不知道该信哪个结果
判断标准就一条:每改一处,只改一处,改完立刻验证。同时动三个地方,成了不知道靠哪个,败了也不知道栽在哪。这套排查思路不适用于已经明确是模型推理报错的情况,那种要去看模型本身的日志,不是连线问题。
下一步如果你正在挑选可用的接入方式,或者想先摸清各家接口的价格与模型情况,站内的导航和价格追踪页能帮你把选项摆在一起对照,再回头验自己的链路会更省事。→常见问题
Open WebUI 里显示连不上 Ollama,但终端里 ollama 能正常对话,该怎么办?
终端能对话说明服务和模型都没问题,卡在第二层。去看 Open WebUI 里填的地址是不是本机回环地址,如果它跑在容器里,这个地址指向容器自身。换成宿主机的可达地址,确认端口通再刷新。
模型明明下载了,Open WebUI 的模型下拉框还是空的?
先在命令行核对模型列表里有没有完整标签,再点界面刷新。两处名字不一致、或者拉取中途断过留下不完整文件,都会表现为「看不到」。删掉那一条重新拉一次通常最快。
能不能把 Ollama 的监听地址直接放开,省得反复排查?
排查阶段临时放开可以理解,但要清楚代价:放开之后同网段任何人都能调你的模型。测通了就收回来,或者至少加一层访问控制。长期裸奔在公网上不是省事,是留隐患。