开始之前
准备 Base URL、API Key 和实时模型 ID。教程中出现的具体模型名只作为格式示例,使用前请到模型目录确认。
Base URL
https://api.zhumeng.email/v1API Key
sk-relay-你的密钥模型 ID
your-model-id配置步骤
共 4 步- 1
准备 Docker 环境
Open WebUI 推荐用 Docker 部署。已有 Docker 直接跳到下一步。
- 2
启动容器
把 API Key 和 Base URL 通过环境变量传入。
bashdocker run -d -p 3000:8080 \ -e OPENAI_API_BASE_URL="https://api.zhumeng.email/v1" \ -e OPENAI_API_KEY="sk-relay-你的密钥" \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main - 3
浏览器打开 http://localhost:3000
首次访问会要求注册管理员账号(仅本机),注册即可登录。
若部署在云服务器供团队使用,建议加上反向代理 + HTTPS + 强制登录。
- 4
验证模型可见
登录后顶部模型下拉会自动从 Relay 拉取可用模型列表。能看到 gpt-5 等即成功。
验证接入
成功标准
新建对话,发一句 hello,能流畅返回即成功。
注意事项
- Open WebUI 默认会缓存模型列表 5 分钟,若刚换 Base URL 看不到模型可点设置 → 模型 → 刷新。
- 建议把 ENABLE_SIGNUP 设为 false 防止公网部署被人随意注册;详见 Open WebUI 文档。