Open WebUI 部署教程：Docker 安装与模型 API 接入

只接模型 API，也可以使用 Open WebUI

Open WebUI 可以作为模型调用界面，不一定要在 VPS 安装 Ollama。本篇使用外部 API，服务器主要运行界面和保存应用数据；本地模型部署另按模型要求准备资源。

运行官方镜像

建立数据卷并把应用映射到本机 3000 端口。main 是官方持续更新标签，长期使用时记录具体版本，更新前保存数据。

sudo docker run -d --name open-webui --restart unless-stopped -p 127.0.0.1:3000:8080 -v open-webui:/app/backend/data ghcr.io/open-webui/open-webui:main
sudo docker logs --tail=100 open-webui

Caddy 或面板将域名反向代理到 127.0.0.1:3000。若暂时只在自己电脑访问，可以采用 SSH 转发，不必开放应用端口。

创建管理员并配置模型连接

首次进入时建立自己的管理员账号。进入管理员设置的连接栏目，添加兼容 OpenAI 的 API 地址和 Key；地址是否包含 /v1，按模型提供方说明填写。

连接成功后选择一个实际可用模型，发一条简单消息。出现 401 时检查凭据，模型不存在时检查模型名称和提供方列表；额度与限流也可能导致调用失败。

按实际需要开放使用

只有自己使用时，关闭不需要的注册入口。多人使用时，由管理员设置账号与模型权限，API Key 在服务端连接配置中管理，不让每位用户共享明文凭据。

上传文件、会话和数据库都在持久化数据中。增加文档处理功能会带来更多磁盘与后台任务，先观察占用，再增加配置。

升级与备份

备份 open-webui 数据卷和额外设置的环境变量。新建容器继续挂载原卷，保留之前版本的记录；只重新拉取镜像，不会自动备份已有会话。