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

牛大圣 • • AI

通过本教程，您将掌握基于 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 检查防火墙设置和网络连通性

版权声明：
作者：牛大圣
链接：https://nds.cool/?p=242
来源：牛大圣的博客
文章版权归作者所有，未经允许请勿转载。

THE END
分享
二维码
< <上一篇
下一篇>>