Wanderlust-Mega-Project项目Docker Compose部署架构解析

项目概述

Wanderlust-Mega-Project是一个采用现代化微服务架构的Web应用项目，通过Docker Compose实现了前后端分离部署。该项目包含了四个核心服务组件：MongoDB数据库、Redis缓存、后端API服务和前端应用，形成了一个完整的全栈应用解决方案。

Docker Compose文件结构解析

版本声明

version: "3.8"

该文件使用了Docker Compose 3.8版本，这是目前较为稳定且功能完善的版本，支持大多数现代Docker特性。

服务定义

MongoDB数据库服务

mongodb:
  container_name: mongo-service
  image: mongo:latest
  volumes:
    - ./backend/data:/data
  ports:
    - "27017:27017"

• 使用官方最新的MongoDB镜像
• 通过卷挂载将容器内的/data目录映射到宿主机的./backend/data目录，实现数据持久化
• 暴露标准MongoDB端口27017，便于开发调试时直接连接

后端API服务

backend:
  container_name: backend
  build: ./backend
  env_file:
    - ./backend/.env.docker
  ports:
    - "31100:8080"
  depends_on:
    - mongodb

• 采用构建方式而非直接使用镜像，便于开发时频繁修改
• 使用独立的.env.docker环境变量文件，与开发环境隔离
• 将容器内的8080端口映射到宿主机的31100端口
• 通过depends_on确保MongoDB服务先启动

前端应用服务

frontend:
  container_name: frontend
  build: ./frontend
  env_file:
    - ./frontend/.env.docker
  ports:
    - "5173:5173"

• 同样采用构建方式，支持前端代码的热更新
• 使用独立的环境变量配置文件
• 暴露5173端口，这是Vite等现代前端工具的默认开发端口

Redis缓存服务

redis:
  container_name: redis-service
  restart: unless-stopped
  image: redis:7.0.5-alpine 
  expose:
      - 6379
  depends_on:
    - mongodb

• 使用轻量级的Alpine版Redis 7.0.5镜像
• 配置了自动重启策略，增强服务稳定性
• 仅暴露6379端口给内部网络，不直接映射到宿主机
• 同样依赖MongoDB服务先启动

数据卷配置

volumes:
  data:

定义了名为data的Docker卷，用于持久化存储数据，确保容器重启后数据不丢失。

部署架构设计特点

1. 服务隔离：每个组件作为独立服务运行，符合微服务架构原则

2. 环境隔离：通过独立的.env.docker文件管理各服务的Docker环境变量

3. 端口规划：

   • 后端API使用31100端口
   • 前端开发服务器使用5173端口
   • 数据库使用标准端口但仅限内部访问

4. 依赖管理：通过depends_on明确定义服务启动顺序

5. 持久化方案：MongoDB数据目录挂载+Redis数据卷双重保障

实际部署建议

1. 开发环境：直接使用此配置，支持前后端热重载

2. 生产环境：建议增加以下配置：

   • 资源限制(CPU、内存)
   • 健康检查
   • 日志驱动配置
   • 网络隔离
   • 服务副本数

3. 安全加固：

   • 为MongoDB设置认证
   • 限制Redis外部访问
   • 使用TLS加密通信

常见问题排查

1. 端口冲突：检查31100和5173端口是否被占用

2. 构建失败：确保./backend和./frontend目录存在且包含正确的Dockerfile

3. 环境变量问题：验证.env.docker文件是否存在且格式正确

4. 服务启动顺序：虽然depends_on控制启动顺序，但不保证服务就绪，建议增加健康检查

通过这套Docker Compose配置，Wanderlust-Mega-Project实现了开发环境的一键部署，大大降低了环境搭建的复杂度，为开发者提供了开箱即用的开发体验。