Skip to main content

​
前置条件

在开始之前，请确保你的机器已安装以下软件：

Docker

Docker Engine 20.10 及以上版本

Docker Compose

Docker Compose v2 及以上版本
推荐使用 Docker Desktop，它已内置 Docker Compose。

​
部署步骤

1

克隆仓库

2

配置环境变量

复制示例配置文件并填写必要参数：
打开 .env 文件，至少需要设置以下变量：
请妥善保管你的 API 密钥和 Token，不要将 .env 文件提交到公开仓库。
3

启动服务

使用 Docker Compose 一键启动所有服务：
首次启动会自动拉取镜像并初始化数据库，可能需要几分钟时间。你可以通过以下命令查看启动日志：
启动的服务包括：后端 API 服务、PostgreSQL 数据库、Redis 缓存，以及 Web 前端。
4

访问前端

服务启动完成后，打开浏览器访问：
你将看到 PAI 的 Web 聊天界面。
5

开始对话

在聊天框中输入你的第一条消息，例如：
PAI 会通过流式响应实时回复你。你可以尝试以下功能：

​
接入平台（可选）

完成基础部署后，你可以进一步接入即时通讯平台：

Telegram

配置 Bot Token 即可接入

微信

通过 GeWeChat 接入个人微信

QQ

通过 OneBot 协议接入 QQ

飞书

接入飞书开放平台

小程序

微信小程序原生接入

Web

已随部署自动启动

​
常见问题

请检查 Docker 容器是否正常运行：
确保所有服务状态为 Up。如果有服务启动失败，查看对应日志排查问题。
请确认 OPENAI_API_KEY 已正确配置，且 API 密钥有效。查看后端日志：

​
下一步

配置指南

了解所有环境变量的详细说明

架构概览

深入理解 PAI 的多节点 Router 架构