# Open WebUI (/docs/cookbook/chat-clients/open-webui)









把 Praxis 接入 [Open WebUI](https://github.com/open-webui/open-webui)——最流行的开源自托管 AI 聊天界面。一条 Docker 命令启动，浏览器里配置连接，就能用 Praxis 的所有模型。

每一步都标了**期望结果**：照做即可，也可以把本页直接交给能操作电脑的 AI 助手，让它替你完成安装、配置与验证。

## 你将完成 [#你将完成]

* 用 Docker 跑起一个自托管的 Open WebUI 实例，接入 Praxis 的模型对话
* 完成标志：在聊天框发送「你好」并收到回复
* 预计耗时：**5 分钟**（不含 Docker 镜像下载）
* 支持协议：OpenAI 兼容（`/openai/v1`）

## 前提 [#前提]

开始前逐项确认：

* **Docker 已安装并运行**（`docker --version` 检查）。没有就到 [Docker 官网](https://docs.docker.com/get-docker/) 装。
* **一个 Praxis API Key**（`sk-praxis-` 开头）。没有就到 [控制台 → API Keys](https://console.deepraxis.ai/keys) 创建：点「创建 Key」，名称必填，有效期可选 30/60/90 天或永久、默认 90 天；创建成功弹窗会展示完整 Key 并带「复制 Key」。新账号自带 **$1 免费额度**。完整流程见[快速开始](/docs/cloud/services/model/quickstart)。

## 安装与启动 [#安装与启动]

**第 1 步：启动 Open WebUI 容器**

```bash
docker run -d --name open-webui --restart always -p 3080:8080 ghcr.io/open-webui/open-webui:main
```

期望：容器 ID 输出后无报错。首次运行会拉取镜像（约 2GB），需要几分钟。

**第 2 步：打开浏览器**

在浏览器访问 `http://localhost:3080`。

期望：看到 Open WebUI 欢迎页，带「Get started」按钮。

<img alt="Open WebUI 首次访问的注册页" src="__img0" />

**第 3 步：创建管理员账号**

点「Get started」，填写 Name、Email、Password（这是本地管理员账号，与 Praxis 无关），点「Create Admin Account」。

期望：进入 Open WebUI 主界面——左侧是对话列表，中间是聊天框。

<img alt="Open WebUI 主界面" src="__img1" />

## 配置 [#配置]

**第 4 步：进入连接设置**

点击右下角的**用户名**，选择「Admin Panel」→「Settings」→「Connections」。

期望：看到 OpenAI API 连接配置区域。

<img alt="Admin Panel → Settings → Connections" src="__img2" />

**第 5 步：填入 Praxis 连接**

在 **OpenAI API** 区域：

| 字段  | 填什么                                   |
| --- | ------------------------------------- |
| URL | `https://api.deepraxis.com/openai/v1` |
| Key | `sk-praxis-` 开头的你的 Key                |

点「Save」。

期望：保存后返回聊天页，模型选择器中出现 Praxis 的模型列表。

> 也可以在启动容器时用环境变量预设连接（免 UI 配置）：
>
> ```bash
> docker run -d --name open-webui --restart always -p 3080:8080 \
>   -e OPENAI_API_BASE_URL=https://api.deepraxis.com/openai/v1 \
>   -e OPENAI_API_KEY=sk-praxis-你的Key \
>   ghcr.io/open-webui/open-webui:main
> ```

## 验证 [#验证]

回到聊天页，在顶部模型选择器中选一个模型（如 `deepseek-flash`），在输入框发送「你好」。

期望：几秒内收到回复——**收到回复即接入成功**。

最后看一眼 [控制台 → 用量与费用](https://console.deepraxis.ai/usage)：刚才的调用已经记在账上——每一次调用都有账、可追溯。

## 常见问题 [#常见问题]

| 症状                   | 原因                           | 解法                                                             |
| -------------------- | ---------------------------- | -------------------------------------------------------------- |
| `localhost:3080` 打不开 | 容器还在启动中（首次约 1-2 分钟）          | 等待后刷新；`docker logs open-webui` 查看进度                            |
| 模型列表为空               | 连接配置的 URL 少了 `/openai/v1` 后缀 | 必须是 `https://api.deepraxis.com/openai/v1`                      |
| 401 / 无效令牌           | API Key 复制不完整                | 重新完整复制（注意 `sk-praxis-` 前缀）                                     |
| 模型不存在                | 模型 ID 与目录不一致                 | 到[控制台 → 模型 → 模型目录](https://console.deepraxis.ai/models)复制确切 ID |
| 容器反复重启               | 端口冲突或内存不足                    | 检查 3080 端口是否被占用；确保 Docker 至少分配 2GB 内存                          |

## 进阶 [#进阶]

* **查这次对话花了多少钱**：[控制台 → 用量与费用](https://console.deepraxis.ai/usage)，按次计费、无闲置费
* **换模型**：在 Open WebUI 的模型选择器中随时切换；`deepseek-flash` 是滚动入口始终指向最新一代 Flash
* **多用户**：Open WebUI 支持多用户注册，在 Admin Panel → Users 管理权限
* **自定义界面**：Admin Panel → Settings → Interface 可改主题、语言（支持中文）
* **数据持久化**：加 `-v open-webui:/app/backend/data` 挂载数据卷，容器重建后聊天记录不丢

## 相关食谱 [#相关食谱]

* [Cherry Studio](/docs/cookbook/chat-clients/cherry-studio)（桌面客户端，不需要 Docker）
* [Dify](/docs/cookbook/platforms/dify)（低代码平台，同样 Docker 部署）
* 不想装任何东西？看 [Praxis App](/docs/app/install)：打开网址即用