doc-forge-reborn/docs/部署指南.md

部署指南 (Docker Compose)

前置条件

• Linux 服务器（或 Windows WSL2）
• Docker 和 Docker Compose 已安装
• 域名（可选）和 SSL 证书（可选）

步骤

1. 克隆代码

git clone <repository-url>
cd doc-forge-reborn

2. 配置环境变量

复制 .env.example 为 .env，并填写以下关键变量：

# Database
POSTGRES_USER=docforge
POSTGRES_PASSWORD=secure_password
POSTGRES_DB=docforge
# Redis
REDIS_URL=redis://redis:6379/0
# Backend
SECRET_KEY=your-secret-key-for-fernet-encryption
DEFAULT_MODEL_ID=uuid-of-default-model
# AI API Keys (也可在后台模型管理中配置)
OPENAI_API_KEY=sk-...
AZURE_API_KEY=...

3. 构建并启动所有服务

docker-compose up -d --build

4. 执行数据库迁移（首次启动后）

docker-compose exec backend alembic upgrade head

5. 验证服务状态

• 前端http://localhost:3000
• 后端 API 文档http://localhost:8000/docs
• Celery Worker 日志docker-compose logs celery-worker

服务端口映射

• 前端3000 (可通过 nginx 暴露 80)
• 后端 API8000
• PostgreSQL5432 (仅内部)
• Redis6379 (仅内部)

生产环境优化建议

• 使用外部 PostgreSQL（如 AWS RDS）提升可靠性。
• 将 Redis 配置为持久化模式。
• 挂载 SSL 证书，配置 HTTPS。
• 设置 Celery 并发数根据 CPU 核心数调整。
• 定期备份数据库和文件存储目录。

停止服务

docker-compose down

升级流程

1. git pull 拉取最新代码
2. docker-compose build 重新构建镜像
3. docker-compose up -d 重启服务
4. 运行数据库迁移（如有）