跳到主要内容

Docker Compose 部署

第一阶段最推荐的部署方式就是 Docker Compose。原因很简单：它足够直接，能把“服务端、数据库、可选代理”一次拉起来，也最适合自托管场景做最小闭环验证。

推荐的仓库与目录​

建议通过独立部署仓统一维护：

memory-deploy/
├── docker-compose.dev.yml
├── docker-compose.prod.yml
├── .env.example
└── README.md

这样可以把部署资产和业务仓边界分开，避免服务端仓库同时承担前端与数据库的联合部署责任。

最小服务集合​

第一阶段至少包含：

  • memory-server
  • PostgreSQL 16
  • pgvector 与中文检索能力

如果你需要浏览器工作台，再按同源或反向代理方式把 memory-web 一起编排进来。

开发环境启动​

git clone https://github.com/plumememory/memory-deploy
cd memory-deploy
cp .env.example .env
docker compose -f docker-compose.dev.yml up -d

开发环境的重点是：

  • 优先跑通闭环
  • 允许本地 HTTP
  • 方便前后端分别联调

生产环境启动​

docker compose -f docker-compose.prod.yml up -d

生产环境建议配套反向代理，并显式启用 HTTPS、CORS、管理员初始化和主密钥配置。

为什么推荐 Compose 作为第一阶段主方案​

不是因为它一定是最终部署方案，而是因为它最符合当前阶段诉求：

  • 降低自托管门槛
  • 让文档和实际部署保持一致
  • 方便快速验证跨 Agent 共享记忆闭环

等部署模型稳定后，再扩展到容器编排平台或更复杂的基础设施也更自然。