手把手教你用Docker快速部署开源MES系统（附避坑指南）

从零到一：基于Docker容器化部署开源MES系统的实战全攻略

最近几年，制造业的数字化转型浪潮席卷而来，身边不少在中小型制造企业做IT的朋友都开始面临一个共同的挑战：老板想要上MES系统，但预算有限，动辄几十万甚至上百万的商业软件根本负担不起。我自己也经历过这个阶段，从最初的手忙脚乱到后来摸索出一套相对成熟的部署方案，今天就把这些实战经验整理出来，希望能帮到正在为此发愁的你。

开源MES系统，特别是像qcadoo、Free-MES、LiteMES这些在GitHub上活跃的项目，为预算有限的中小企业提供了绝佳的解决方案。它们不仅功能完整，而且因为开源，你可以根据自己工厂的实际需求进行二次开发，灵活性远超那些“一刀切”的商业软件。更重要的是，借助Docker这样的容器化技术，部署和维护的复杂度大大降低，一个懂点Linux和网络的基础IT人员就能搞定。

这篇文章就是为你准备的——无论你是中小制造企业的IT运维，还是对智能制造感兴趣的开发者，我都会用最直白的方式，带你一步步完成一个开源MES系统的生产级部署。我们会重点解决部署过程中最容易踩坑的数据库配置、应用服务器优化、网络设置等问题，确保你第一次尝试就能成功跑起来。

1. 部署前的环境准备与架构规划

在真正动手敲命令之前，花点时间做好规划能让你少走很多弯路。我见过太多人一上来就急着安装，结果因为环境不兼容或者资源不足，折腾半天又得推倒重来。

1.1 硬件与操作系统选择

对于中小型制造企业，MES系统的硬件需求其实并不夸张。根据我的经验，一个支持50个并发用户、管理5-10条生产线的场景，以下配置就足够了：

注意：如果你计划将MES与SCADA、ERP等系统集成，或者需要处理大量的实时生产数据，建议在推荐配置的基础上再增加50%的资源预留。

操作系统方面，Ubuntu Server LTS版本是我的首选。它社区支持好，软件包更新及时，而且对Docker的支持非常完善。我通常选择最新的LTS版本，比如Ubuntu 22.04或24.04，避免使用过于陈旧的发行版。

# 查看当前系统信息
lsb_release -a
uname -r

如果你的服务器已经安装了其他Linux发行版（比如CentOS），也不用担心，大部分步骤都是通用的，只是包管理器的命令需要相应调整。

1.2 Docker与Docker Compose安装

容器化部署的核心就是Docker，它能把应用及其所有依赖打包成一个标准化的单元，确保在任何环境下的运行一致性。这里我提供两种安装方式：官方脚本和apt仓库。

方法一：使用官方安装脚本（最简单）

# 下载并执行Docker安装脚本
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# 将当前用户加入docker组，避免每次都要sudo
sudo usermod -aG docker $USER
newgrp docker  # 立即生效，或重新登录

# 验证安装
docker --version
docker run hello-world

方法二：通过apt仓库安装（更可控）

# 卸载旧版本（如果有）
sudo apt-get remove docker docker-engine docker.io containerd runc

# 安装依赖包
sudo apt-get update
sudo apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# 添加Docker官方GPG密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 设置仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker Engine
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 启动并设置开机自启
sudo systemctl enable docker
sudo systemctl start docker

安装完Docker后，还需要安装Docker Compose。虽然新版本的Docker已经包含了Compose插件，但我还是习惯用独立版本，因为有些老项目可能对版本有特定要求。

# 下载Docker Compose（这里以2.20.2为例，可替换为最新版本）
sudo curl -L "https://github.com/docker/compose/releases/download/v2.20.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 添加执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version

1.3 网络与存储规划

生产环境下的MES系统通常需要与多个系统交互，合理的网络规划至关重要。我建议采用以下架构：

• 数据库层：PostgreSQL/MySQL容器，单独的网络命名空间
• 应用层：Spring Boot或Java Web应用容器
• 缓存层：Redis容器，用于会话管理和热点数据缓存
• 文件存储：MinIO或NFS共享存储
• 前端：Nginx反向代理，处理静态资源和负载均衡

创建一个专用的Docker网络能让容器间通信更安全、更高效：

# 创建自定义网络
docker network create mes-network

# 查看网络详情
docker network inspect mes-network

存储方面，千万不要把数据库数据放在容器内部！容器重启或迁移时，内部数据会丢失。一定要使用数据卷（Volume）或绑定挂载（Bind Mount）。

# 创建数据卷
docker volume create postgres-data
docker volume create redis-data
docker volume create app-logs

# 查看所有数据卷
docker volume ls

2. 开源MES项目选型与源码获取

GitHub上开源MES项目不少，但质量参差不齐。根据我的实际使用经验，下面这几个项目值得重点关注：

2.1 主流开源MES项目对比

提示：选择项目时不仅要看技术栈是否熟悉，更要关注项目的最近提交时间、Issue处理情况和社区活跃度。一个半年没更新的项目，很可能已经无人维护了。

我个人的推荐是Free-MES，原因有三：第一，它基于现代化的Spring Boot和Vue3技术栈，二次开发相对容易；第二，项目维护者提供了完整的Docker部署方案，对新手友好；第三，社区活跃，遇到问题能较快得到解答。

2.2 获取项目源码

直接从GitHub克隆是最简单的方式：

# 创建项目目录
mkdir -p ~/projects/mes-deployment
cd ~/projects/mes-deployment

# 克隆Free-MES项目
git clone https://github.com/metaxk-company/free-mes.git

# 进入项目目录
cd free-mes

# 查看项目结构
tree -L 2

典型的项目结构应该是这样的：

free-mes/
├── docker-compose.yml          # Docker Compose配置文件
├── README.md                   # 项目说明文档
├── source-code/                # 源代码目录
│   ├── backend/               # 后端Java代码
│   ├── frontend/              # 前端Vue代码
│   └── database/              # 数据库脚本
├── deployment/                 # 部署相关文件
│   ├── nginx/                 # Nginx配置
│   ├── init-scripts/          # 初始化脚本
│   └── config/                # 应用配置文件
└── images/                     # 截图和文档图片

如果网络环境访问GitHub较慢，可以考虑使用国内镜像或者先下载ZIP包：

# 使用Gitee镜像（如果项目有同步）
git clone https://gitee.com/metaxk-company/free-mes.git

# 或者下载ZIP包
wget https://github.com/metaxk-company/free-mes/archive/refs/heads/master.zip
unzip master.zip
mv free-mes-master free-mes

2.3 源码结构与关键文件解析

在部署之前，花点时间了解源码结构能帮你更好地理解整个系统：

# 查看后端项目结构
cd source-code/backend
find . -name "pom.xml" -o -name "application*.yml" | head -10

# 查看前端项目结构
cd ../frontend
ls -la

几个关键配置文件需要特别注意：

1. application.yml：Spring Boot应用的主要配置文件，包含数据库连接、Redis配置、文件上传路径等
2. docker-compose.yml：定义了所有服务的容器配置、网络和数据卷
3. nginx.conf：Nginx反向代理配置，影响前端访问和后端API路由
4. init.sql：数据库初始化脚本，创建表结构和基础数据

我建议在部署前先浏览一遍这些配置文件，根据你的实际环境调整参数。特别是数据库连接字符串、Redis地址、文件存储路径这些与环境相关的配置。

3. 数据库配置与优化实战

数据库是MES系统的心脏，配置不当会导致性能瓶颈甚至数据丢失。我踩过的坑，希望你不要再踩。

3.1 PostgreSQL vs MySQL的选择

大多数开源MES项目都支持PostgreSQL和MySQL，两者各有优劣：

PostgreSQL的优势：

• 对复杂查询和JSON数据支持更好
• 事务处理更严谨
• 扩展性强，支持多种数据类型
• 在qcadoo等项目中是首选

MySQL的优势：

• 部署简单，资源占用相对较少
• 社区庞大，遇到问题容易找到解决方案
• 对Web应用生态支持更好
• Free-MES和LiteMES默认使用MySQL

如果你不确定选哪个，我建议跟着项目推荐走。比如Free-MES官方文档推荐MySQL，那就用MySQL；qcadoo推荐PostgreSQL，那就用PostgreSQL。不要强行更换，避免兼容性问题。

3.2 PostgreSQL容器化部署与调优

对于选择PostgreSQL的项目，这里是一份生产级的Docker Compose配置：

version: '3.8'
services:
  postgres:
    image: postgres:15-alpine
    container_name: mes-postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: mesdb
      POSTGRES_USER: mesuser
      POSTGRES_PASSWORD: StrongPassword123!
      PGDATA: /var/lib/postgresql/data/pgdata
    volumes:
      - postgres_data:/var/lib/postgresql/data
      - ./init-scripts:/docker-entrypoint-initdb.d
    ports:
      - "5432:5432"
    networks:
      - mes-network
    command: >
      postgres
      -c shared_buffers=256MB
      -c effective_cache_size=1GB
      -c maintenance_work_mem=64MB
      -c checkpoint_completion_target=0.9
      -c wal_buffers=16MB
      -c default_statistics_target=100
      -c random_page_cost=1.1
      -c effective_io_concurrency=200
      -c work_mem=4MB
      -c min_wal_size=1GB
      -c max_wal_size=4GB
      -c max_connections=200

volumes:
  postgres_data:
    driver: local

networks:
  mes-network:
    driver: bridge

关键配置说明：

• shared_buffers：数据库缓存，建议设置为系统内存的25%
• effective_cache_size：操作系统和数据库缓存总和，建议为系统内存的50-75%
• max_connections：最大连接数，根据应用服务器数量调整

初始化数据库时，一定要先创建扩展和设置合适的字符集：

-- init.sql示例
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
CREATE EXTENSION IF NOT EXISTS "pg_trgm";

-- 设置字符集
UPDATE pg_database SET encoding = pg_char_to_encoding('UTF8') WHERE datname = 'mesdb';

3.3 MySQL容器化部署与性能优化

对于MySQL，配置稍有不同：

services:
  mysql:
    image: mysql:8.0
    container_name: mes-mysql
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: RootPassword123!
      MYSQL_DATABASE: mesdb
      MYSQL_USER: mesuser
      MYSQL_PASSWORD: UserPassword123!
    volumes:
      - mysql_data:/var/lib/mysql
      - ./mysql/conf.d:/etc/mysql/conf.d
      - ./init-scripts:/docker-entrypoint-initdb.d
    ports:
      - "3306:3306"
    networks:
      - mes-network
    command: >
      --character-set-server=utf8mb4
      --collation-server=utf8mb4_unicode_ci
      --default-authentication-plugin=mysql_native_password
      --