Open WebUI

Open WebUI 是自部署的网页 LLM 客户端,跟 ChatGPT 网页很像。一键 Docker 起来。

1. Docker 一键部署

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

启动后访问 http://你的服务器ip:3000,第一个注册的用户自动成为管理员。

2. 接入 Miloapi

进入「右上角头像 → Admin Panel(管理员面板)」→ Settings → Connections → OpenAI API:

  1. 点 + 添加
  2. API Base URL:https://www.miloapi.com/v1
  3. API Key:sk-你的key
  4. 点「Verify」→ 验证通过
  5. Save

回到主界面,顶部模型选择器就能看到 Miloapi 提供的模型列表。

3. 添加多个 endpoint

可以同时挂多个 Miloapi 服务商,用不同的 Key:

名称Base URLKey用途
Miloapi-GPThttps://www.miloapi.com/v1sk-gpt-key跑 GPT
Miloapi-Claudehttps://www.miloapi.com/v1sk-claude-key跑 Claude

Open WebUI 会把两个的模型合并成一个列表显示。

4. 生图

主界面 → 模型选 gpt-image-2 → 提示词写「生成 ...」即可。

5. 故障排查

现象处理
Docker container 起不来检查 3000 端口是不是被占,改 -p 4000:8080 之类
模型列表空endpoint 验证没过,检查 base URL 带 /v1、Key 有效
流式响应不流畅Open WebUI 默认就是流式,如果卡顿可能是 Docker 网络问题
多用户访问Open WebUI 支持多用户,在 Admin Panel → Users 添加
数据丢失-v open-webui:/app/backend/data 这个 volume 一定要带,丢了会清空所有对话

6. 升级

docker pull ghcr.io/open-webui/open-webui:main
docker stop open-webui
docker rm open-webui
# 再跑一遍上面那条 docker run(volume 会保留)

7. AionUI / 其他类似项目

AionUI、LobeChat、ChatGPT Next Web 这些都是类似的自部署网页客户端,配置方式跟 Open WebUI 大同小异,核心都是:

字段填什么
服务商类型OpenAI / OpenAI Compatible
Base URLhttps://www.miloapi.com/v1(带 /v1)
API Keysk-你的key