Open WebUI 怎么用：连接 Ollama 与对话验证

Open WebUI 是一个可以本地部署的聊天界面，装好后能不能直接用，关键看它是否成功连上了后端模型服务。
默认情况下它会尝试连接本机的 Ollama，如果你打开页面发现模型下拉框是空的，先别急着重新安装，按下面的顺序检查连接和模型状态即可。

首次登录后先确认模型是否已加载

Open WebUI 第一次打开会要求注册一个管理员账号，这个账号只保存在本地，注册完成后自动登录。
登录后进入聊天页，左上角或输入框上方会有模型选择入口。

如果模型列表为空，说明前端没有从后端拿到可用模型。
此时先不要改 Open WebUI 的配置，优先检查 Ollama 是否在运行、是否已经拉取过模型：

# 查看 Ollama 服务状态
systemctl status ollama

# 查看已下载的模型
ollama list

如果 ollama list 没有任何输出，说明本机还没有模型，需要先拉取一个，例如：

ollama pull qwen2.5:7b

拉取完成后刷新 Open WebUI 页面，模型通常会自动出现在列表中。

检查 Open WebUI 连接 Ollama 的地址

Open WebUI 通过环境变量 OLLAMA_BASE_URL 指定 Ollama 地址。
用 Docker 部署时，常见写法是：

docker run -d -p 3000:8080 \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

这里要注意两点：

• 如果 Open WebUI 和 Ollama 都跑在宿主机上，容器内访问宿主机要用 host.docker.internal，Linux 环境可能需要额外加 --add-host=host.docker.internal:host-gateway。
• 如果两者在同一个 Docker 网络里，地址应写成 Ollama 的容器名，例如 http://ollama:11434，而不是 localhost。

改完环境变量后需要重启容器才能生效：

docker restart open-webui

发起一次对话验证是否真正可用

模型出现在列表里不代表一定能回答。
选一个模型，输入一句简单问题，例如“用一句话说明什么是 Docker”，然后发送。

正常情况会看到逐字返回的回复。
如果一直转圈或报错，按下面顺序排查：

1. 在服务器上直接测试 Ollama 接口是否通：curl http://localhost:11434/api/tags，能返回 JSON 说明 Ollama 本身正常。
2. 进入 Open WebUI 容器内部再测一次：docker exec -it open-webui curl http://host.docker.internal:11434/api/tags，如果这里不通，说明容器到 Ollama 的网络地址不对。
3. 检查 Ollama 是否只监听了 127.0.0.1。默认配置下局域网或容器可能访问不到，需要设置 OLLAMA_HOST=0.0.0.0 后重启 Ollama。

几个容易踩的坑

模型名称对不上。
Open WebUI 显示的是 Ollama 返回的模型名，如果你手动在设置里填了一个不存在的名称，对话会直接失败。
以 ollama list 的输出为准。

修改配置后没重启。
无论是改环境变量还是改 Ollama 监听地址，都要重启对应服务，否则页面表现不会变化。

拉取模型时磁盘空间不足。
7B 级别的模型通常需要数 GB 空间，拉取前用 df -h 确认数据盘余量，避免下载到一半失败。

验证通过后的日常使用

能正常对话后，Open WebUI 的模型选择、对话历史和基础设置都可以直接在网页里操作，不需要再改配置文件。
如果之后换模型，只要在 Ollama 里 pull 新模型，回到页面刷新即可看到。
遇到模型列表再次为空时，优先回到本文的连接检查步骤，而不是重装整个环境。