Docker Compose 部署
PAI 提供完整的 Docker Compose 配置,可一键部署全部服务。所有服务通过 Docker 内部网络通信,简化配置和运维。服务概览
PAI 的 Docker Compose 包含 7 个服务:服务详情
backend
主后端服务,处理所有 API 请求和 Webhook 消息。memory_worker
独立的记忆提取 Worker 进程,从 Redis 队列消费消息,异步提取和存储用户记忆。frontend
React Web 前端,构建为静态资源并通过 Nginx 提供服务。db
PostgreSQL 数据库,启用 pgvector 扩展用于向量存储。redis
Redis 用于缓存、会话管理和消息队列。gewechat
GeWeChat 微信桥接服务。仅在需要微信接入时启动。napcat
NapCat QQ OneBot 协议桥接。自动配置回调地址指向后端。数据卷
部署操作
构建镜像
启动全部服务
查看日志
停止服务
选择性启动
如果不需要所有平台,可以只启动必要的服务:Telegram 和飞书不需要额外的桥接服务,只需在
.env 中配置对应的环境变量即可。数据库迁移
首次部署或升级版本后,可能需要执行数据库迁移:常见问题
端口冲突怎么办?
端口冲突怎么办?
修改
docker-compose.yml 中对应服务的端口映射,例如将 8000:8000 改为 8080:8000。如何更新到新版本?
如何更新到新版本?
gewechat 或 napcat 启动失败?
gewechat 或 napcat 启动失败?
这两个服务需要额外的登录步骤。请查看对应的平台接入文档完成账号登录。如果不需要对应平台,可以不启动这些服务。