Ollama 怎么用 Open WebUI 加图形界面
Ollama 只有命令行,套上 Open WebUI 才有网页界面。这篇讲容器启动、连接地址怎么填、连不上模型的排查顺序,以及数据卷别丢。
Ollama 装好之后只能在终端里敲命令,聊天、切换模型、翻历史都不方便。Open WebUI 是给它套一层网页界面,装好后在浏览器里用。这篇讲怎么把两者接起来,以及最常见的连不上模型问题。
入口在哪
分两层看:Ollama 是后台服务,本身只有命令行;图形界面是另一个程序 Open WebUI,用浏览器打开它的地址访问。
Ollama 装好后终端里能直接用 ollama 命令。Open WebUI 最常见的是用容器方式跑起来,也可以用 Python 环境安装,具体以官方文档为准,镜像名和端口别照抄旧教程。
具体步骤
- 先在终端确认 Ollama 在跑:执行
ollama list,能看到已下载的模型就说明服务正常。列表是空的就先拉一个模型。 - 让 Ollama 接受来自其他程序的连接。默认它只监听本机地址,容器里的程序访问不到,需要把环境变量
OLLAMA_HOST设成0.0.0.0后重启服务。 - 装好容器运行环境,用一条命令把界面跑起来,端口映射到本机一个空闲端口,同时把数据目录挂成卷,否则重启就丢配置。
- 浏览器打开本机对应端口,第一次进入会让你注册账号,第一个注册的通常就是管理员。
- 进入设置里的模型或连接项,填 Ollama 的地址。容器内的本机回环地址指的是容器自己,要写成宿主机的实际地址。
- 回到对话页,模型下拉里能列出模型就说明接通了,发一句话试试流式输出。
几个坑
- 容器里写本机回环地址。这个地址在容器内指向容器自己,永远连不到宿主机的 Ollama。
- Ollama 只听本机。不改监听地址,界面那边会一直报连接失败。
- 模型没下载。界面上能选模型但一发消息就报错,通常是模型名对不上,先在终端把它拉下来。
- 不挂数据卷。容器一删,账号、对话、设置全没。
- 防火墙拦了局域网访问。手机想用同一个界面,得放行对应端口。
怎么验证
按四步确认,缺一项都不算装好:
- 终端里能列出模型,界面的模型下拉里也能看到同一个名字。
- 发一句短问题,看回答是不是一个字一个字出来,能出来说明链路通了。
- 重启一次容器,账号还能登录、历史对话还在,说明数据卷挂对了。
- 用手机连同一个网络打开宿主机地址,能进页面说明防火墙放行成功。
常见问题
页面打得开,但一个模型都没有
界面和 Ollama 之间的地址填错了,或者 Ollama 没监听外部请求。先把监听地址改成不限本机,再在设置里填宿主机的实际地址,保存后刷新页面看模型有没有出现。
能不能不用容器安装
可以,用 Python 环境安装也行,但要自己处理依赖和开机启动,出问题排查成本更高。只是自己用、又想少折腾的,容器方式更省事。
手机能不能访问这个界面
同一个局域网下可以,用宿主机的局域网地址加端口访问。要跨网络访问就得自己做内网穿透,这一步涉及把服务暴露出去,务必加访问控制,别直接开到公网。
一句话总结:Ollama 改监听地址、界面用容器跑起来并挂好数据卷、连接地址填宿主机而不是本机回环,最后用模型列表和一条消息验证。