搭建自己的 Open WebUI：接入模型、管理账号与保存会话

如果你手头已经有各家大模型的 API Key，想搭一个属于自己或小团队的网页聊天入口，Open WebUI 是最省心的单容器方案之一：自带多用户账号、对话历史、知识库文档和模型切换，装好就能用。

这篇文章用 Zenavo 的 Open WebUI 模板，把界面部署到你自己的服务器上，再接入外部模型接口。如果你想对比包含 PostgreSQL、Redis 和独立 S3 存储的多人工作台，也可以看看 LobeHub 部署指南。

模板本身不包含本地大模型或 GPU 推理；服务器、Zenavo 平台和上游模型 API 分别计费。

部署 Open WebUI

先在 Zenavo 中连接一台 Linux 服务器，再打开 Open WebUI 模板，选择服务器并部署。

当前模板的配置如下：

配置	值或用途
镜像	ghcr.io/open-webui/open-webui:main
HTTP 端口	8080
持久化目录	/app/backend/data，SQLite 数据库、上传文档和设置都在这里
WEBUI_SECRET_KEY	项目创建时自动生成，用于登录会话加密
ENABLE_OLLAMA_API	false，默认关闭本地 Ollama 探测，直接用外部 API
遥测变量	默认关闭 SCARF_NO_ANALYTICS、DO_NOT_TRACK 和 ANONYMIZED_TELEMETRY
内存	建议预留 2 GB

main 标签会随上游更新。准备长期稳定使用时，在服务 设置 的 来源 中把镜像改成你验证过的固定版本（例如 ghcr.io/open-webui/open-webui:v0.6.5）。

绑定域名，立刻注册管理员账号

在 open-webui 服务的 网络 页为 8080 端口绑定域名，例如 chat.example.com，在 DNS 添加指向服务器的 A 记录，等待 HTTPS 生效。步骤见域名文档。

域名一生效就打开网站注册第一个账号。 Open WebUI 会把第一个注册的人设为管理员；在你完成注册之前，任何知道这个网址的人都能抢先注册成管理员。

注册登录后，打开 管理员面板 → 设置 → 通用（Admin Panel → Settings → General），检查新用户注册策略：

• 只给自己用：关闭新用户注册（禁用 Sign Up）；
• 给团队用：把默认用户角色设为“待审批（pending）”，只有你批准过的账号才能使用模型。

接入模型接口

打开 管理员面板 → 设置 → 外部连接（Connections），在 OpenAI API 一栏填入模型服务商的 Base URL 和 API Key，保存后即可在聊天页左上角看到模型列表。

常见接法：

• 直连官方或兼容接口：填入服务商提供的 OpenAI 兼容地址（通常以 /v1 结尾，注意不要重复拼两遍 /v1）和对应的 API Key。
• 通过自建网关接入：如果你部署了 New API、Magpie 或 LiteLLM，可以把 Base URL 指向你的网关地址，用一个网关统一管理 OpenAI、Anthropic、Gemini、DeepSeek 等多家渠道和额度。若网关与 Open WebUI 在同一个 Zenavo 项目里，还可以直接走内网地址（例如 http://new-api.zenavo.internal:3000/v1）。
• 加上免费联网搜索与手机端入口：想让模型检索实时网页，可以在同一个项目里添加自建的 SearXNG 元搜索引擎；想在 Telegram、Discord 或 Slack 里随时调用自己的 AI 助手，还可以搭配 OpenClaw。

如果有多个成员共用，可以在管理员的模型设置里控制哪些模型对普通用户可见，避免大家误调昂贵的模型。

备份与升级

Open WebUI 的账号、聊天记录、知识库文件和后台连接设置都保存在 /app/backend/data 数据卷里。同时，服务 变量 里的 WEBUI_SECRET_KEY 用于保护会话，部署后不要随意更改，并建议复制一份存好。

在 open-webui 服务的 备份与恢复 中备份数据卷：

1. 选一个没人使用的维护窗口，停止项目（数据卷备份要求项目处于停止状态）。
2. 创建备份，完成后重新启动项目。
3. 下载一份备份自行保存。备份里包含聊天记录和填入的 API Key，请妥善保管。

操作细节见备份与恢复。升级前先备份数据卷，读完 Open WebUI 的发行说明再修改镜像标签。大版本升级可能会迁移内部数据库结构，一旦升级出错，用升级前的备份恢复最稳妥。

常见问题

保存连接后模型列表是空的？ 检查 Base URL 是否以服务商要求的路径结尾（多数 OpenAI 兼容接口需要带 /v1），以及 API Key 是否有效。有些兼容接口不支持列出模型接口（/v1/models），可以在连接设置里手动填写要用的模型 ID。

调用模型时报 401 或 404？ 401 通常是 API Key 填错、过期或没有该模型权限；404 多半是 Base URL 多写了 /chat/completions 或漏写了 /v1。

改了环境变量，重启后页面设置没变？ Open WebUI 把许多管理端设置写入数据库后，数据库里的设置会优先于环境变量。需要调整时，直接在网页的 管理员面板 → 设置 里修改并保存。

能接本地 Ollama 吗？ 可以，但模板默认设了 ENABLE_OLLAMA_API=false，避免没装 Ollama 时后台一直报错。如果你在同一项目或同一内网跑了 Ollama，把 ENABLE_OLLAMA_API 改为 true 并填写 OLLAMA_BASE_URL 即可。

从 Open WebUI 模板开始：先绑定域名、抢先注册管理员并收紧注册权限，再接入模型接口、安排好数据卷备份。