跳到主要内容

5 分钟内完整启动集群

本文档带你从零完成羽忆的本地部署。你唯一需要的前提是：Docker 和 Docker Compose。

前置要求​

依赖最低版本说明
Docker24.x容器运行时
Docker Compose2.x服务编排
可用内存2 GB推荐 4 GB

步骤 1：拉取部署仓库​

git clone https://github.com/plumememory/memory-deploy
cd memory-deploy

步骤 2：配置环境变量​

cp .env.example .env

编辑 .env，至少填写以下三个必填项：

# 管理员账号（首次启动时自动注册）
MEMORY_BOOTSTRAP_ADMIN_USERNAME=admin
MEMORY_BOOTSTRAP_ADMIN_PASSWORD=change-me-now   # 强密码，至少 12 位

# 数据库密码
POSTGRES_PASSWORD=your-db-password
可选增强配置

如需启用向量搜索和智能研判，参考 环境变量完整参考。

步骤 3：启动容器栈​

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

服务启动后：

  • API 服务：http://localhost:8080
  • 管理后台：http://localhost:3000
  • Swagger UI：http://localhost:8080/swagger-ui.html

步骤 4：验证 MVP 功能​

bash verify-mvp.sh

脚本会自动测试以下功能：

✓  写入 Stable Memory
✓  写入 History Record
✓  Task Recall（上下文召回）
✓  跨 Agent 读取
✓  删除 & 临时模式

所有项目通过即表示部署成功。

下一步​