MBE 文档中心

MBE 部署文件索引

最后更新: 2026-02-03
目的: 整理混乱的部署文件，提供清晰的索引

📋 快速导航

🎯 推荐使用的文件（当前版本）

文件类型 文件名 用途 优先级
Docker Compose docker-compose.dev.yml 开发版部署 ⭐⭐⭐
Docker Compose docker-compose.prod.yml 生产版部署 ⭐⭐⭐
Docker Compose docker-compose.complete.yml 完整系统一次性部署 ⭐⭐
启动脚本 scripts/start_dev.ps1 启动开发版 ⭐⭐⭐
启动脚本 scripts/start_prod.ps1 启动生产版 ⭐⭐⭐
启动脚本 scripts/build_admin_ui.ps1 构建 Admin UI 镜像 ⭐⭐
环境变量 .env.development 开发版环境变量 ⭐⭐⭐
环境变量 .env.production 生产版环境变量 ⭐⭐⭐
主文档 docs/deployment/START_DEV_AND_PROD.md 启动指南 ⭐⭐⭐

📁 Docker Compose 文件分类

✅ 当前使用（推荐）

文件 用途 端口 说明
docker-compose.dev.yml 开发版 8001, 5433, 6381 主要开发环境
docker-compose.prod.yml 生产版 8000, 5432, 6380 主要生产环境
docker-compose.complete.yml 完整系统 8000 一次性部署所有服务

⚠️ 特殊用途（按需使用）

文件 用途 说明
docker-compose.cpu.yml CPU 版本 无 GPU 环境
docker-compose.gpu.yml GPU 版本 有 NVIDIA GPU
docker-compose.monitoring.yml 监控服务 Prometheus + Grafana
docker-compose.test.yml 测试环境 单元测试和集成测试
docker-compose.scale.yml 扩展部署 多实例负载均衡

📦 已归档（不建议使用）

以下文件已移动到 docs/archive/docker-compose/ 目录：

  • docker-compose.yml (旧版本地开发)
  • docker-compose.dev.complete.yml (已合并到 dev.yml)
  • docker-compose.local.yml (已合并到 dev.yml)
  • docker-compose.simple.yml (已废弃)
  • docker-compose.frontend-full.yml (已合并到 prod.yml)
  • docker-compose.lb.yml (已合并到 scale.yml)
  • docker-compose.cloud.yml (已合并到 prod.yml)
  • docker-compose.tunnel.yml (已合并到 dev/prod.yml)
  • docker-compose.gitea.yml (已废弃)

🔧 PowerShell 脚本分类

✅ 当前使用（推荐）

脚本 用途 使用场景
scripts/start_dev.ps1 启动开发版 日常开发
scripts/start_prod.ps1 启动生产版 生产部署
scripts/build_admin_ui.ps1 构建 Admin UI Admin UI 更新
scripts/check_services.ps1 检查服务状态 故障排查

⚠️ 特殊用途（按需使用）

脚本 用途 说明
scripts/deploy_complete_development.ps1 完整开发环境部署 包含种子数据
scripts/deploy_complete_production.ps1 完整生产环境部署 包含初始化
scripts/backup.ps1 数据备份 定期备份
scripts/rollback.ps1 回滚部署 紧急回滚

📦 已归档（不建议使用）

以下脚本已移动到 scripts/archive/ 目录：

  • scripts/quick_start.ps1 (已替换为 start_dev/start_prod)
  • scripts/start_all.ps1 (已替换为 start_dev/start_prod)
  • scripts/start_dev_and_prod.ps1 (已替换为分别启动)
  • scripts/deploy_development.ps1 (已替换为 start_dev.ps1)
  • scripts/deploy_production.ps1 (已替换为 start_prod.ps1)
  • scripts/deploy_dual_environment.ps1 (已废弃)
  • scripts/deploy_dev.ps1 (已替换为 start_dev.ps1)
  • scripts/check_status.ps1 (已替换为 check_services.ps1)
  • scripts/check_status_simple.ps1 (已废弃)

📚 文档分类

✅ 当前使用（推荐）

文档 用途 位置
主部署指南 DEPLOYMENT_GUIDE.md 根目录
启动指南 START_DEV_AND_PROD.md docs/deployment/
Docker 配置 DOCKER_CONFIGURATION.md docs/deployment/
快速命令 START_COMMANDS.md 根目录

📦 已归档（历史参考）

以下文档已移动到 docs/archive/deployment/ 目录：

  • README_DEPLOY.md (已合并到主指南)
  • QUICKSTART_DEPLOY.md (已合并到 START_DEV_AND_PROD.md)
  • SMART_DEPLOY_GUIDE.md (已废弃)
  • DEPLOY_WEB_FIXED.md (已废弃)
  • docs/deployment/DEPLOYMENT-GUIDE.md (已合并)
  • docs/deployment/QUICK_START.md (已合并)
  • docs/deployment/QUICK_START_FIXED.md (已合并)

🚀 快速开始

开发版

# 方式1: 使用脚本（推荐）
.\scripts\start_dev.ps1

# 方式2: 使用 Docker Compose
docker-compose -f docker-compose.dev.yml up -d

生产版

# 方式1: 使用脚本（推荐）
.\scripts\start_prod.ps1

# 方式2: 使用 Docker Compose
docker-compose -f docker-compose.prod.yml up -d

完整系统

# 一次性部署所有服务
docker-compose -f docker-compose.complete.yml up -d

📝 文件维护规则

新增文件

  1. Docker Compose: 如果创建新的 compose 文件，请在文件名中明确用途（如 docker-compose.monitoring.yml）
  2. 脚本: 新脚本应放在 scripts/ 目录，命名清晰（如 start_xxx.ps1）
  3. 文档: 部署相关文档统一放在 docs/deployment/ 目录

废弃文件

  1. 不要删除: 移动到 docs/archive/ 或 scripts/archive/ 目录
  2. 添加说明: 在文件顶部添加 [DEPRECATED] 标记和废弃日期
  3. 更新索引: 更新本索引文档

文件命名规范

  • Docker Compose: docker-compose.{环境/用途}.yml
  • 脚本: {动作}_{目标}.ps1 (如 start_dev.ps1, build_admin_ui.ps1)
  • 文档: {主题}_{类型}.md (如 START_DEV_AND_PROD.md)

🔍 查找文件

按用途查找

  • 启动服务: scripts/start_*.ps1
  • 部署服务: scripts/deploy_*.ps1
  • 检查状态: scripts/check_*.ps1
  • 构建镜像: scripts/build_*.ps1

按环境查找

  • 开发版: docker-compose.dev.yml, scripts/start_dev.ps1
  • 生产版: docker-compose.prod.yml, scripts/start_prod.ps1
  • 测试版: docker-compose.test.yml

📞 需要帮助？

如果找不到需要的文件，请：

  1. 查看本索引文档
  2. 检查 docs/archive/ 目录（历史文件）
  3. 查看 docs/deployment/START_DEV_AND_PROD.md（主指南）

最后更新: 2026-02-03