# LobeHub (/docs/cookbook/chat-clients/lobehub)







把 Praxis 接入 [LobeHub](https://lobehub.com)——开源的现代设计 AI 聊天界面，支持插件、多模型、语音。Docker 启动，浏览器里填两处即通。

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

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

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

## 前提 [#前提]

* **Docker 已安装并运行**（`docker --version` 检查）。
* **一个 Praxis API Key**（`sk-praxis-` 开头）。没有就到 [控制台 → API Keys](https://console.deepraxis.ai/keys) 创建。完整流程见[快速开始](/docs/cloud/services/model/quickstart)。

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

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

```bash
docker run -d --name lobehub --restart always -p 3210:3210 lobehub/lobe-chat:latest
```

期望：容器 ID 输出无报错，首次拉取约 1GB。

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

访问 `http://localhost:3210`。期望：自动跳转到聊天页。

<img alt="LobeHub 主界面" src="__img0" />

## 配置 [#配置]

**第 3 步：进入模型设置**

点击左侧边栏的设置图标（齿轮），选择「Language Model」。期望：看到 API Key 与 API Proxy Address 两个输入区域。

<img alt="Settings → Language Model" src="__img1" />

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

| 字段                | 填什么                                  |
| ----------------- | ------------------------------------ |
| API Key           | `sk-praxis-` 开头的你的 Key               |
| API Proxy Address | `https://api.deepraxis.ai/openai/v1` |

点「Check」验证。期望：通过后在 Model List 勾选 `deepseek-flash`。

> 环境变量预设（免 UI 配置）：
>
> ```bash
> docker run -d --name lobehub --restart always -p 3210:3210 \
>   -e OPENAI_API_KEY=sk-praxis-你的Key \
>   -e OPENAI_PROXY_URL=https://api.deepraxis.ai/openai/v1 \
>   lobehub/lobe-chat:latest
> ```

## 验证 [#验证]

选模型，发「你好」。期望：收到回复即接入成功。

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

| 症状                   | 原因                | 解法                                       |
| -------------------- | ----------------- | ---------------------------------------- |
| `localhost:3210` 打不开 | 容器还在启动            | `docker logs lobehub`                    |
| Check 不通过            | 地址少了 `/openai/v1` | 必须是 `https://api.deepraxis.ai/openai/v1` |
| 401                  | Key 不完整           | 重新复制                                     |
| 模型列表为 OpenAI 默认      | 未自定义 Model List   | 在 Language Model 页添加 `deepseek-flash`    |

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

* [Cherry Studio](/docs/cookbook/chat-clients/cherry-studio) · [Open WebUI](/docs/cookbook/chat-clients/open-webui)