Open WebUI 本地部署与远程 Ollama 集成实战

将 Open WebUI 作为前端交互界面，配合远程部署的 Ollama 服务，是一种常见且高效的架构。这种模式既能利用本地资源管理对话历史，又能通过远程服务器分担模型推理压力。

镜像加速拉取

国内网络环境下直接拉取 GitHub Container Registry 可能较慢，推荐使用华为云镜像加速器：

docker pull swr.cn-north-4.myhuaweicloud.com/ddn-k8s/ghcr.io/open-webui/open-webui:v0.6.9

官方文档提供了详细的配置说明，建议查阅 Open WebUI 文档获取最新信息。

部署界面示例

准备远程 Ollama 服务

Ollama 建议部署在另一台机器上，默认监听 11434 端口。确保该机器已启动服务并开放了防火墙权限，允许外部访问。

Ollama 运行状态

在部署 Open WebUI 之前，先测试网络连通性。使用 curl 请求 Ollama API 接口：

curl http://<Ollama_IP>:11434/api/tags

如果返回包含模型列表的 JSON 数据，说明连接正常：

{
  "models": [
    {
      "name": "deepseek-r1:1.5b",
      "model": "deepseek-r1:1.5b",
      "size": 1117322768,
      "details": {
        "family": "qwen2",
        "parameter_size": "1.8B"
      }
    },
    {
      "name": "llama3.2:1b",
      "model": "llama3.2:1b",
      "size": 1321098329,
      "details": {
        "family": "llama",
        "parameter_size": "1.2B"
      }
    }
  ]
}

启动 Open WebUI 容器

确认 Ollama 可访问后，即可启动 Open WebUI。关键参数是 -e OLLAMA_BASE_URL，需指向远程 Ollama 的实际 IP 地址。

sudo docker run -d \
  -p 3000:8080 \
  -e OLLAMA_BASE_URL=http://<Ollama_IP>:11434 \
  -v open-webui:/app/backend/data \
  --name web \
  --restart always \
  swr.cn-north-4.myhuaweicloud.com/ddn-k8s/ghcr.io/open-webui/open-webui:v0.6.9

启动成功后，浏览器访问 http://<WebUI_IP>:3000 即可进入管理界面。

WebUI 主界面

此时系统已自动同步远程 Ollama 上的可用模型。你可以在界面中自由切换不同模型进行对话测试。

模型选择与对话