Docker 部署
mindvaults 提供轻量模式（云端 API）和全栈模式（Ollama 本地推理）双方案， 覆盖从树莓派到 GPU 服务器的多种硬件环境。
☁️ 轻量模式
- • 4 容器：Nginx + Frontend + Backend + PostgreSQL
- • LLM/Embedding 走云端 API（DeepSeek/OpenAI/Qwen）
- • 内存占用 ~1.5 GB
- • 无需 GPU
- • 适合开发环境、低配 VPS
docker compose up -d🏠 全栈模式
- • 6 容器：轻量模式 + Redis + Ollama
- • 100% 本地推理，绝不出网
- • 内存占用 ~6-8 GB（取决于模型）
- • 推荐 Apple M 系列 / Nvidia GPU
- • 适合企业内网、涉密环境
docker compose --profile full up -d服务拓扑
| 服务 | 端口 | 镜像 | 用途 |
|---|---|---|---|
| Nginx | 80 | nginx:alpine | 反向代理，SSE 免缓冲 |
| Frontend | 3000 | node:20-alpine | Next.js 14 用户界面 |
| Backend | 8000 | python:3.11-slim | FastAPI RAG 核心引擎 |
| PostgreSQL | 5432 | pgvector/pgvector:pg16 | 业务数据 + 向量存储 |
| Redis * | 6379 | redis:7-alpine | 检索缓存，限流计数 |
| Ollama * | 11434 | ollama/ollama | LLM 推理 + Embedding |
* 标记的服务仅在全栈模式下启动。
开发环境手动构建
# 1. 启动基础设施 docker compose up -d postgres redis # 2. 后端 cd backend python -m venv venv && source venv/bin/activate pip install -r requirements.txt alembic upgrade head uvicorn app.main:app --reload --port 8000 # 3. 前端 cd .. npm install npx next dev
完整部署文档及故障排查见 docs/DEPLOYMENT_GUIDE.md