Skip to main content
Version: Current

Open WebUI Settings

部署目录：/root/openwebui
Compose 文件：docker-compose.yml

当前 compose 要点​

services:
  openwebui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: openwebui
    restart: unless-stopped
    ports:
      - "127.0.0.1:3002:8080"
    volumes:
      - openwebui-data:/app/backend/data
  • 数据持久化在命名卷 openwebui_openwebui-data
  • 端口仅绑定 localhost，公网由 Nginx 转发

推荐环境变量策略​

做法说明
✅ Connections → LiteLLM统一 API 入口
❌ compose 内明文 OpenAI Key易泄露、与 LiteLLM 重复

若需保留 compose 环境变量，请改用 env 文件 且勿提交 Git：

env_file:
  - .env.webui

常用可选变量（上游）​

在 environment 中按需添加（示例）：

变量作用
WEBUI_SECRET_KEY会话加密；生产应设固定随机值
ENABLE_SIGNUP是否允许自助注册
DEFAULT_MODELS默认可见模型列表

完整列表见 Open WebUI Environment。

升级镜像​

cd /root/openwebui
docker compose pull
docker compose up -d

升级前执行备份：/root/infra-backup/backup/openwebui.sh

数据卷位置​

docker volume inspect openwebui_openwebui-data

SQLite 与上传文件均在卷内，删除卷等于清空所有用户数据。