Skip to main content

​
前置条件

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

Docker

Docker Engine 20.10 及以上版本

Docker Compose

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

​
部署步骤

1

克隆仓库

git clone https://github.com/Lsogod/personal-ai-pai.git
cd personal-ai-pai
2

配置环境变量

复制示例配置文件并填写必要参数：
cp .env.example .env
打开 .env 文件，至少需要设置以下变量：
# 必填：OpenAI API 密钥
OPENAI_API_KEY=sk-your-api-key-here

# 必填：JWT 密钥（用于用户认证，可随机生成）
JWT_SECRET=your-random-secret-string

# 必填：管理员 Token（用于后台管理接口）
ADMIN_TOKEN=your-admin-token
请妥善保管你的 API 密钥和 Token，不要将 .env 文件提交到公开仓库。
3

启动服务

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

访问前端

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

开始对话

在聊天框中输入你的第一条消息，例如：
你好，请介绍一下你自己
PAI 会通过流式响应实时回复你。你可以尝试以下功能：
今天天气怎么样？
帮我写一封邮件草稿

​
接入平台（可选）

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

Telegram

配置 Bot Token 即可接入

微信

通过 GeWeChat 接入个人微信

QQ

通过 OneBot 协议接入 QQ

飞书

接入飞书开放平台

小程序

微信小程序原生接入

Web

已随部署自动启动

​
常见问题

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

git pull origin main
docker-compose up -d --build

​
下一步

配置指南

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

架构概览

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