reugis/dass-asl-ebeanstalk

MERN Stack Docker镜像文档

镜像概述

MERN Stack Docker镜像是一个预配置的全栈JavaScript开发环境，集成了MongoDB（数据库）、Express.js（后端框架）、React（前端库）和Node.js（运行时环境）四大核心组件。该镜像旨在简化现代Web应用的开发流程，提供从数据库到前端界面的完整技术栈支持，无需手动配置各组件依赖关系。

核心功能与特性

• MongoDB：文档型数据库，支持JSON格式数据存储，提供灵活的数据模型和高效查询能力
• Express.js：轻量级Node.js后端框架，简化API开发，支持中间件扩展和路由管理
• React：用于构建用户界面的前端库，支持组件化开发和虚拟DOM，提升渲染性能
• Node.js：JavaScript运行时环境，支持服务端代码执行，实现前后端统一语言开发
• 开发工具集成：包含npm/yarn包管理工具、Webpack打包工具及热重载功能，支持开发模式实时预览
• 环境隔离：通过Docker容器化确保开发环境一致性，避免"在我电脑上能运行"问题

使用场景

• 全栈Web应用快速开发与部署
• 现代JavaScript应用原型验证
• 全栈JavaScript技术学习与实践环境
• 团队协作开发时的统一开发环境配置
• 小型Web项目的快速启动与交付

使用方法

基础运行命令

通过以下命令快速启动MERN Stack环境：

bash
docker run -d \
  --name mern-app \
  -p 3000:3000 \  # React前端服务端口
  -p 5000:5000 \  # Express后端API端口
  -p 27017:27017 \ # MongoDB数据库端口
  -v ./app:/app \  # 挂载本地项目目录
  mern-stack:latest

Docker Compose配置示例

创建docker-compose.yml文件实现多容器协调：

yaml
version: '3'
services:
  mongodb:
    image: mongo:latest
    ports:
      - "27017:27017"
    volumes:
      - mongo-data:/data/db
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=password

  backend:
    image: mern-stack:latest
    command: npm run start:backend
    ports:
      - "5000:5000"
    volumes:
      - ./backend:/app/backend
    environment:
      - NODE_ENV=development
      - MONGO_URI=mongodb://admin:password@mongodb:27017/mernapp?authSource=admin
    depends_on:
      - mongodb

  frontend:
    image: mern-stack:latest
    command: npm run start:frontend
    ports:
      - "3000:3000"
    volumes:
      - ./frontend:/app/frontend
    environment:
      - REACT_APP_API_URL=http://localhost:5000/api
    depends_on:
      - backend

volumes:
  mongo-data:

环境变量配置

目录结构与挂载

推荐本地项目目录结构：

./
├── frontend/  # React前端代码
├── backend/   # Express后端代码
└── docker-compose.yml

通过-v参数挂载本地代码目录至容器内/app路径，实现代码实时同步与热重载。

注意事项

• 生产环境部署时，建议分离前后端容器并配置反向代理（如Nginx）
• MongoDB数据需通过卷挂载（如示例中mongo-data）确保数据持久化
• 开发模式下可启用热重载：前端npm run start，后端npm run dev（依赖nodemon）
• 首次启动需等待依赖安装完成，可通过docker logs mern-app查看进度

常用命令

• 进入容器终端：docker exec -it mern-app /bin/bash
• 查看服务日志：docker logs -f mern-app
• 重启服务：docker restart mern-app
• 停止并删除容器：docker rm -f mern-app