Open WebUI

把 Praxis 接入 Open WebUI——最流行的开源自托管 AI 聊天界面。一条 Docker 命令启动，浏览器里配置连接，就能用 Praxis 的所有模型。

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

你将完成

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

前提

开始前逐项确认：

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

安装与启动

第 1 步：启动 Open WebUI 容器

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」按钮。

第 3 步：创建管理员账号

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

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

配置

第 4 步：进入连接设置

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

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

第 5 步：填入 Praxis 连接

在 OpenAI API 区域：

点「Save」。

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

也可以在启动容器时用环境变量预设连接（免 UI 配置）：

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），在输入框发送「你好」。

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

最后看一眼 控制台 → 用量与费用：刚才的调用已经记在账上——每一次调用都有账、可追溯。

常见问题

进阶

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

相关食谱

• Cherry Studio（桌面客户端，不需要 Docker）
• Dify（低代码平台，同样 Docker 部署）
• 不想装任何东西？看 Praxis App：打开网址即用