切换到 S3 存储

OPL 数据空间默认使用本地存储。你也可以把文件层切到 Amazon S3。

前提

• AWS 账号
• Access Key / Secret Key
• 有权限读写目标 S3 bucket

关键环境变量

STORAGE_PROVIDER=s3
S3_ACCESS_KEY_ID=ABC123
S3_SECRET_ACCESS_KEY=SuperSecret
S3_ENDPOINT_URL=https://s3.us-east-1.amazonaws.com
S3_REGION_NAME=us-east-1
S3_BUCKET_NAME=my-awesome-bucket-name

Docker 示例

docker run -d \
  -p 3000:8080 \
  -v open-webui:/app/backend/data \
  -e STORAGE_PROVIDER="s3" \
  -e S3_ACCESS_KEY_ID="ABC123" \
  -e S3_SECRET_ACCESS_KEY="SuperSecret" \
  -e S3_ENDPOINT_URL="https://s3.us-east-1.amazonaws.com" \
  -e S3_REGION_NAME="us-east-1" \
  -e S3_BUCKET_NAME="my-awesome-bucket-name" \
  ghcr.io/open-webui/open-webui:main

验证

上传一个文件，然后在 S3 bucket 中确认对象已出现。对象名通常会附加唯一 ID，便于 OPL 数据空间跟踪文件。