3、使用 Docker Compose 快速部署 Open WebUI 可视化平台

2025年2月3日 137点热度 0人点赞 0条评论

通过本教程，您将掌握基于 Docker Compose 的一键式 Open WebUI 部署方案，实现与 Ollama 等大模型服务的无缝对接。本配置已适配开发测试环境，包含数据持久化、自动重启等关键功能。

? 前置要求

Docker Engine ≥20.10.14
Docker Compose ≥2.5.1
开放端口：3000/TCP

? docker-compose.yml 完整配置

version: '3.8'

services:
  webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - ./data:/app/backend/data  # 持久化数据存储
    environment:
      - OLLAMA_API_BASE_URL=http://your-ollama-host:11434
      - AUTH_DISABLED=true  # 禁用登录验证（开发环境使用）
    restart: unless-stopped

⚙️ 配置参数解析

参数	说明	推荐值
ports	端口映射规则	主机端口:容器端口
volumes	数据持久化路径	建议使用绝对路径如 /opt/webui/data
OLLAMA_API_BASE_URL	模型服务地址	本地：http://localhost:11434 远程：http://x.x.x.x:11434
AUTH_DISABLED	身份验证开关	生产环境必须设为 false

? 五步部署流程

步骤 1：创建部署目录

mkdir openwebui-deploy && cd openwebui-deploy

步骤 2：编写配置文件

nano docker-compose.yml  # 粘贴上述配置内容

步骤 3：启动服务

docker compose up -d

步骤 4：验证服务状态

docker compose ps  # 应显示 webui 服务状态为 running

步骤 5：访问 Web 界面

浏览器打开：http://your-server-ip:3000

⚠️ 安全注意事项

生产环境必须配置 HTTPS
建议设置 WEBUI_SECRET_KEY 环境变量
禁用默认管理员账号密码

? 生产环境增强方案

方案一：启用 HTTPS

environment:
  - HTTPS_ENABLED=true
  - SSL_CERT_PATH=/path/to/cert.pem
  - SSL_KEY_PATH=/path/to/key.pem

方案二：资源配额

deploy:
  resources:
    limits:
      cpus: '2'
      memory: 4G

?️ 常见问题排查表

现象	解决方案
端口 3000 被占用	修改 ports 为 "新端口:8080"
数据卷权限错误	执行 `chmod 755 ./data`
无法连接 Ollama	检查防火墙设置和网络连通性