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 与上传文件均在卷内，删除卷等于清空所有用户数据。