Skip to content

Open WebUI 安装与部署

Open WebUI 通常使用 Docker 部署。适合服务器、NAS、本地开发机或团队内网环境。

Docker 快速部署

bash
docker run -d \
  -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://xikapi.com/v1 \
  -e OPENAI_API_KEY=YOUR_XIKAPI_API_KEY \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

部署完成后访问:

text
http://localhost:3000

如果部署在服务器上,把 localhost 换成服务器地址。

通过管理界面配置

即使启动时没有写环境变量,也可以在管理员界面中进入:

text
Admin Panel -> Settings -> Connections

然后添加 OpenAI-compatible 连接。

部署建议

  • 生产环境建议放在反向代理后面。
  • 对外开放时必须配置 HTTPS、账号权限和访问控制。
  • API Key 不要写进公开的 docker-compose.yml 仓库。

更新

更新前建议备份 volume:

text
open-webui:/app/backend/data

这里保存用户、配置和历史数据。