knowledge-base/AI/mem0/03-deployment.md

Mem0 部署方案

部署选项

选项 A：server/（完整功能）

组件	说明
Mem0 Server	FastAPI 服务
PostgreSQL + pgvector	关系数据 + 向量存储
Neo4j	图数据库（可选）

选项 B：openmemory/（轻量，已 sunset）

仅需 Qdrant，但官方已停止维护，不建议使用。

---

K8s 部署（server/ 方案）

你已有的基础设施

tei namespace 下已有：
├── Qdrant        ← 向量数据库
├── PostgreSQL   ← 关系数据库
├── Dify         ← 编排平台（LLM 能力？）
├── TEI          ← Text Embeddings Inference
└── BGM          ← BGE-M3 嵌入模型服务

部署架构

┌─────────────────────────────────────────────────────────────┐
│                     Mem0 Pod                                 │
│  ├── mem0-server (main container)                          │
│  │   - Port: 8000                                           │
│  │   - 连接 TEI、Qdrant、PostgreSQL、LLM                    │
│  └── git-sync (sidecar, 可选)                               │
│       - 从 Gitea 拉取配置/知识库                            │
└─────────────────────────────────────────────────────────────┘
         │
         ├─ TEI: http://tei-server:8080
         ├─ Qdrant: http://qdrant:6333
         ├─ PostgreSQL: postgres:5432
         └─ LLM: 待确认（Dify / OpenAI 代理 / Ollama）

核心环境变量

# PostgreSQL（已有）
POSTGRES_HOST=postgres
POSTGRES_PORT=5432
POSTGRES_DB=mem0
POSTGRES_USER=postgres
POSTGRES_PASSWORD=xxx
APP_DB_NAME=mem0_app

# Qdrant（已有）
QDRANT_HOST=qdrant
QDRANT_PORT=6333

# TEI Embedder（已有）
EMBEDDER_PROVIDER=tei
TEI_ENDPOINT=http://tei-server:8080

# LLM（待确认）
LLM_PROVIDER=openai   # 或 dify / ollama / anthropic
OPENAI_API_KEY=xxx    # 或通过 Dify

# Auth
JWT_SECRET=xxx
ADMIN_API_KEY=xxx
AUTH_DISABLED=false

# Telemetry（国内建议关闭）
MEM0_TELEMETRY=false

你需要准备的内容

1. 确认 LLM 来源（Dify / OpenAI 代理 / Ollama）
2. 确认 PostgreSQL 数据库已创建（mem0 数据库）
3. 确认 Qdrant collection 已创建（或让 mem0 自动创建）
4. 配置环境变量
5. 编译/获取 mem0 镜像

---

国内网络问题

问题

• 无法访问 Docker Hub
• 无法访问 GitHub raw content

解决方式

1. 镜像提前导入：在有网环境 docker pull 后 docker save，导入到 K8s 节点
2. 内网镜像仓库：配置私有的 Harbor 或 registry
3. 代码构建：下载代码后 docker build 本地镜像

建议的镜像来源

镜像	国内可用的 registry
pgvector	registry.cn-hangzhou.aliyuncs.com 搜索
neo4j	docker.m.daocloud.io/neo4j (DaoCloud)
mem0	需自行 build 或找社区镜像

---

待完成

• 确认 mem0 代码可下载
• 确认 LLM 来源
• 生成 K8s YAML 文件
• 测试部署