关于 Open WebUI
Open WebUI 是一款面向大语言模型的开源 Web 界面。它的外观和用法与常见的聊天应用相似,但不绑定任何一家厂商:您可以接入 OpenAI、Anthropic 或任何兼容 OpenAI 的服务的 API 密钥,也可以连接本地的 Ollama 实例。
除聊天外,它还支持多用户账号及角色、共享提示词、文件上传与文档搜索,以及通过已接入服务实现的网页搜索和图像生成。它是 GitHub 上最活跃的自托管 AI 项目之一,在手机上也能作为可安装的 Web 应用流畅使用。
团队选择自托管,是为了通过一个公司密钥让所有人使用强大的模型,无需为每人单独订阅,同时避免聊天记录保存在第三方聊天应用中。
常见用途
全团队共用的 AI 聊天
为同事创建账号,让他们使用同样的已接入模型,由管理员决定谁能看到哪个模型。
并排比较模型
在同一对话中将同一提示词发送给两个模型,选择更合适的回答。
针对您自己的文件提问
将文档上传到聊天或知识库,然后就其内容提问。
下单之后
Open WebUI 会在服务器首次启动时自动安装,访问地址为 http://您的服务器地址:3000/,防火墙已为其开放 3000 端口。请使用 Rivervo 控制面板中显示的邮箱和密码登录,该账号即为管理员。然后在管理设置中添加模型 API 密钥,并为其他用户创建账号。
接入模型服务商
此服务器上的 Open WebUI 不运行本地模型(ENABLE_OLLAMA_API: "false"):回答来自您在 Admin Panel → Settings → Connections 中添加 API 密钥的模型服务商,例如 OpenAI 或任何兼容 OpenAI 的服务。用量费用由您直接支付给这些服务商;密钥保存在您的服务器上。
为 Open WebUI 配置自有域名和 HTTPS
默认情况下,Open WebUI 通过服务器 IP 地址以普通 HTTP 提供访问。如需使用 chat.example.com 这样的名称并配置证书,请在您的 DNS 中为该名称创建一条指向服务器 IPv4 地址的 A 记录,然后在前面部署 Caddy:Caddy 会自动获取并续期免费的 Let's Encrypt 证书。以下命令适用于我们应用服务器所使用的 Ubuntu 24.04。
在控制面板中,为服务器防火墙开放 TCP 80 和 443 端口:Caddy 需要通过它们获取 Let's Encrypt 证书并提供网站服务。
apt install -y caddy
cat > /etc/caddy/Caddyfile <<'EOF'
chat.example.com {
reverse_proxy 127.0.0.1:3000
}
EOF
systemctl reload caddy域名可用后,就不再需要直接访问 3000 端口:在 /opt/open-webui/compose.yml 中将 "3000:…" 改为 "127.0.0.1:3000:…",运行 docker compose up -d,并从防火墙中移除 3000 端口。此后 Open WebUI 只能通过 HTTPS 访问。
更新 Open WebUI
/opt/open-webui/compose.yml 中的镜像固定为具体版本,因此直接运行 docker compose pull 只会再次拉取相同版本。如需更新,请将 image: 行中的版本改为目标版本(请先阅读发行说明),然后拉取并重新创建容器。数据保存在 Docker 卷中,不会丢失。
cd /opt/open-webui
nano compose.yml # the new version in the image: line
docker compose pull
docker compose up -d备份 Open WebUI
在控制面板中,您可以开启整台服务器的每日备份(套餐价格的 +20%,保留最近 7 份),并可从其中任意一份恢复服务器。不过,仍建议将应用自身的数据另存为文件:这样可以迁移到其他服务器,或在不回滚其他内容的情况下单独恢复。
Open WebUI 保存的所有内容——用户、聊天记录、上传的文档、设置以及您添加的 API 密钥——都位于 open-webui_open_webui 卷中:
cd /opt/open-webui && docker compose stop
docker run --rm -v open-webui_open_webui:/data -v /root:/backup alpine \
tar czf /backup/open-webui-$(date +%F).tgz -C /data .
docker compose start如何运作
- 在服务器订购页面选择 Open WebUI,并选一个内存足够的套餐。
- 服务器首次启动时会自动安装应用,通常几分钟内完成。
- 在控制面板中打开服务器:访问地址和登录信息都在那里。