【限时体验】 JeecgBoot项目Docker Compose部署架构深度解析

前言：企业级低代码平台的容器化部署挑战

还在为JeecgBoot项目的复杂部署环境而头疼吗？传统部署方式需要手动配置MySQL、Redis、Nginx等多个组件，环境依赖复杂，部署效率低下。本文将深度解析JeecgBoot项目的Docker Compose部署架构，帮助你快速搞定企业级低代码平台的容器化部署！

通过本文，你将获得：

• ✅ JeecgBoot Docker Compose架构的完整解析
• ✅ 单机版与云原生版的部署差异对比
• ✅ 核心服务的容器化配置详解
• ✅ 实战部署步骤与最佳实践
• ✅ 常见问题排查与性能优化建议

一、JeecgBoot Docker Compose架构总览

JeecgBoot提供了两种Docker Compose部署方案，满足不同场景需求：

1.1 单机版部署架构（docker-compose.yml）

flowchart TD
    A[前端Vue应用<br>Nginx:80] --> B[后端SpringBoot应用<br>Java:8080]
    B --> C[MySQL数据库<br>MySQL:13306]
    B --> D[Redis缓存<br>Redis:6379]
    B --> E[PGVector向量数据库<br>PostgreSQL:5432]
    
    subgraph Docker Network [jeecg-boot网络]
        C
        D
        E
        B
        A
    end

1.2 云原生版部署架构（docker-compose-cloud.yml）

flowchart LR
    A[前端Vue应用<br>Nginx:80] --> F[API网关<br>SpringCloud Gateway:9999]
    F --> G[业务系统服务<br>Jeecg-Boot-System]
    F --> H[示例服务<br>Jeecg-Boot-Demo]
    G --> I[服务注册发现<br>Nacos:8848]
    H --> I
    I --> J[MySQL数据库<br>MySQL:13306]
    G --> K[Redis缓存<br>Redis:6379]
    G --> L[PGVector向量数据库<br>PostgreSQL:5432]
    
    subgraph Cloud Network [jeecg-boot云网络]
        A
        F
        G
        H
        I
        J
        K
        L
    end

二、核心服务容器配置详解

2.1 MySQL数据库服务配置

jeecg-boot-mysql:
  build:
    context: ./jeecg-boot/db
  environment:
    MYSQL_ROOT_PASSWORD: root
    MYSQL_ROOT_HOST: '%'
    TZ: Asia/Shanghai
  restart: always
  container_name: jeecg-boot-mysql
  ports:
    - 13306:3306
  command:
    --character-set-server=utf8mb4
    --collation-server=utf8mb4_general_ci
    --explicit_defaults_for_timestamp=true
    --lower_case_table_names=1
    --max_allowed_packet=128M
    --default-authentication-plugin=caching_sha2_password

关键配置解析：

• character-set-server=utf8mb4: 支持完整的UTF-8字符集，包括emoji表情
• lower_case_table_names=1: 表名大小写不敏感，兼容Windows和Linux环境
• max_allowed_packet=128M: 支持大文件上传和处理

2.2 后端SpringBoot应用配置

jeecg-boot-system:
  build:
    context: ./jeecg-boot/jeecg-module-system/jeecg-system-start
  restart: on-failure
  depends_on:
    - jeecg-boot-mysql
    - jeecg-boot-redis
  container_name: jeecg-boot-system
  ports:
    - 8080:8080

对应的Dockerfile配置：

FROM registry.cn-hangzhou.aliyuncs.com/dockerhub_mirror/java:17-anolis
MAINTAINER [e-mail]
RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
WORKDIR /jeecg-boot
EXPOSE 8080
ADD ./target/jeecg-system-start-3.8.2.jar ./
CMD sleep 60;java -Dfile.encoding=UTF-8 -Djava.security.egd=file:/dev/./urandom -jar jeecg-system-start-3.8.2.jar

2.3 前端Vue应用Nginx配置

FROM registry.cn-hangzhou.aliyuncs.com/dockerhub_mirror/nginx
MAINTAINER [e-mail]
VOLUME /tmp
ENV LANG en_US.UTF-8
RUN echo "server {  
    listen       80;
    location   /jeecgboot/ {
        proxy_pass              http://jeecg-boot-system:8080/jeecg-boot/;
        proxy_redirect          off;
        proxy_set_header        Host jeecg-boot-system;
        proxy_set_header        X-Real-IP \$remote_addr;
        proxy_set_header        X-Forwarded-For \$proxy_add_x_forwarded_for;
    }
    location / {
        root   /var/www/html/;
        index  index.html index.htm;
        if (!-e \$request_filename) {
            rewrite ^(.*)\$ /index.html?s=\$1 last;
            break;
        }
    }
}" > /etc/nginx/conf.d/default.conf
ADD dist/ /var/www/html/
EXPOSE 80
EXPOSE 443

三、部署实战：从零到一快速搭建

3.1 环境准备要求

组件	版本要求	说明
Docker	20.10+	容器运行时环境
Docker Compose	2.0+	容器编排工具
内存	8GB+	推荐配置
磁盘空间	20GB+	包含镜像和数据

3.2 单机版部署步骤

# 1. 克隆项目代码
git clone https://gitcode.com/jeecgboot/JeecgBoot

# 2. 进入项目目录
cd JeecgBoot

# 3. 构建并启动所有服务
docker-compose up -d

# 4. 查看服务状态
docker-compose ps

# 5. 访问应用
# 前端: http://localhost
# 后端: http://localhost:8080
# MySQL: localhost:13306 (root/root)

3.3 云原生版部署步骤

# 使用云原生版本部署
docker-compose -f docker-compose-cloud.yml up -d

# 查看云服务状态
docker-compose -f docker-compose-cloud.yml ps

# 访问服务
# Nacos控制台: http://localhost:8848/nacos (nacos/nacos)
# API网关: http://localhost:9999

四、架构设计亮点与最佳实践

4.1 网络隔离设计

JeecgBoot使用自定义的Docker网络jeecg-boot，确保服务间通信的安全性和隔离性：

networks:
  jeecg-boot:
    name: jeecg_boot

4.2 服务依赖管理

通过depends_on确保服务启动顺序，避免因依赖服务未就绪导致的启动失败：

depends_on:
  - jeecg-boot-mysql
  - jeecg-boot-redis

4.3 健康检查与重启策略

restart: always        # 数据库服务始终重启
restart: on-failure    # 应用服务失败时重启

4.4 时区统一配置

所有容器统一使用Asia/Shanghai时区，避免时间不一致问题：

environment:
  TZ: Asia/Shanghai

五、性能优化与监控建议

5.1 资源限制配置

建议在生产环境中添加资源限制：

deploy:
  resources:
    limits:
      memory: 2G
      cpus: '2'
    reservations:
      memory: 1G
      cpus: '1'

5.2 数据持久化配置

添加数据卷持久化重要数据：

volumes:
  - mysql_data:/var/lib/mysql
  - redis_data:/data

volumes:
  mysql_data:
  redis_data:

5.3 监控方案推荐

监控工具	用途	配置方式
cAdvisor	容器资源监控	添加cAdvisor容器
Prometheus	指标收集	配置exporter
Grafana	数据可视化	配置数据源

六、常见问题排查指南

6.1 启动超时问题

症状: 应用启动失败，日志显示数据库连接超时

解决方案:

# 在应用服务中添加启动延迟
command: >
  sh -c "
  echo '等待数据库就绪...';
  sleep 30;
  java -jar jeecg-system-start-3.8.2.jar
  "

6.2 内存不足问题

症状: 容器频繁重启，OOM错误

解决方案:

environment:
  JAVA_OPTS: -Xmx1g -Xms512m

6.3 网络连接问题

症状: 服务间无法通信

解决方案: 检查Docker网络配置，确保所有服务在同一个网络中

七、总结与展望

JeecgBoot的Docker Compose部署架构体现了现代云原生应用的最佳实践：

1. 模块化设计: 每个服务独立容器化，便于扩展和维护
2. 环境一致性: 开发、测试、生产环境完全一致
3. 快速部署: 一键部署，大幅提升效率
4. 资源隔离: 网络和资源的有效隔离确保安全性
5. 弹性伸缩: 基于容器技术的天然弹性能力

随着云原生技术的不断发展，JeecgBoot也在持续优化其容器化部署方案，未来将支持更多的云原生特性，如服务网格、无服务器架构等。

立即体验: 使用本文提供的部署方案，快速搭建你的JeecgBoot低代码平台，享受容器化带来的便捷和高效！

---

温馨提示: 本文基于JeecgBoot 3.8.2版本，不同版本配置可能略有差异，请以实际版本为准。部署前建议阅读官方文档获取最新信息。