在工业自动化项目中工业一体机往往需要部署多个应用服务——数据采集、设备通信、Web监控界面、边缘计算等。传统裸机部署方式存在依赖冲突、版本管理混乱、升级回滚困难等问题。Docker容器化方案通过隔离运行环境让每个应用在独立的容器中运行互不干扰同时支持镜像版本管理和一键部署回滚是工业一体机软件部署的推荐方案。## 环境准备本文以基于Debian 12的工业一体机为例演示Docker容器化部署的完整流程。### 安装Dockerbash# 更新软件包索引sudo apt update# 安装必要依赖sudo apt install -y ca-certificates curl gnupg lsb-release# 添加Docker官方GPG密钥sudo mkdir -p /etc/apt/keyringscurl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg# 添加Docker仓库echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list# 安装Docker引擎sudo apt updatesudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin# 将当前用户加入docker组免sudosudo usermod -aG docker $USER### 配置Docker数据目录工业一体机的系统盘空间通常有限建议将Docker数据目录迁移到独立的存储分区bash# 停止Docker服务sudo systemctl stop docker# 迁移数据目录sudo rsync -aP /var/lib/docker/ /data/docker/# 修改Docker配置sudo tee /etc/docker/daemon.json EOF{data-root: /data/docker,log-driver: json-file,log-opts: {max-size: 10m,max-file: 3}}EOF# 重启Dockersudo systemctl start docker日志轮转配置很重要。工业设备长期运行不重启如果不限制日志大小容器日志文件会撑满磁盘导致设备异常。## 构建工业应用镜像以一个Python数据采集服务为例编写DockerfiledockerfileFROM python:3.11-slimWORKDIR /app# 安装系统依赖串口库等RUN apt-get update apt-get install -y --no-install-recommends \libserialport-dev \ rm -rf /var/lib/apt/lists/*# 安装Python依赖COPY requirements.txt .RUN pip install --no-cache-dir -r requirements.txt# 复制应用代码COPY . .# 配置时区ENV TZAsia/ShanghaiRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime echo $TZ /etc/timezone# 启动命令CMD [python, -u, main.py]构建镜像并打标签bashdocker build -t data-collector:1.0.0 .docker tag data-collector:1.0.0 registry.local:5000/data-collector:1.0.0## 设备访问权限处理Docker容器默认无法访问宿主机的串口和GPIO设备。需要在启动容器时通过--device参数映射设备节点bashdocker run -d \--name collector \--restart unless-stopped \--device /dev/ttyS0 \--device /dev/ttyS1 \--device /dev/gpiochip0 \-e MQTT_BROKERtcp://192.168.1.100:1883 \-e SERIAL_PORT/dev/ttyS0 \-e BAUD_RATE9600 \-v /data/config:/app/config \data-collector:1.0.0如果容器需要访问GPIO还需要确保容器内的用户有权限操作/dev/gpiochip*设备节点。可以通过--privileged参数不推荐权限过大或者在容器内添加对gpio组的访问权限。## Docker Compose多服务编排实际项目中通常需要同时部署多个服务。使用Docker Compose管理yamlversion: 3.8services:data-collector:image: registry.local:5000/data-collector:1.0.0container_name: collectorrestart: unless-stoppeddevices:- /dev/ttyS0- /dev/ttyS1environment:- MQTT_BROKERtcp://mqtt-broker:1883- SERIAL_PORT/dev/ttyS0- BAUD_RATE9600volumes:- ./config/collector:/app/configdepends_on:- mqtt-brokermqtt-broker:image: eclipse-mosquitto:2.0container_name: mqttrestart: unless-stoppedports:- 1883:1883volumes:- ./config/mosquitto:/mosquitto/configweb-monitor:image: registry.local:5000/web-monitor:1.0.0container_name: monitorrestart: unless-stoppedports:- 8080:80environment:- MQTT_BROKERtcp://mqtt-broker:1883depends_on:- mqtt-broker启动服务bashdocker compose up -d## 远程OTA升级方案工业一体机部署在现场后手动逐台升级非常低效。可以通过本地镜像仓库实现远程OTA升级bash#!/bin/bash# OTA升级脚本 upgrade.shREGISTRYregistry.local:5000APP_NAMEdata-collectorNEW_VERSION$1if [ -z $NEW_VERSION ]; thenecho Usage: ./upgrade.sh versionecho Example: ./upgrade.sh 1.1.0exit 1fiecho 开始OTA升级 $APP_NAME 到版本 $NEW_VERSION # 拉取新版本镜像docker pull ${REGISTRY}/${APP_NAME}:${NEW_VERSION}if [ $? -ne 0 ]; thenecho 镜像拉取失败升级中止exit 1fi# 备份当前版本CURRENT_VERSION$(docker inspect --format{{.Config.Image}} collector 2/dev/null | awk -F: {print $2})echo 当前版本: $CURRENT_VERSION# 停止旧容器docker stop collectordocker rename collector collector_backup# 启动新版本容器docker run -d \--name collector \--restart unless-stopped \--device /dev/ttyS0 \--device /dev/ttyS1 \-e MQTT_BROKERtcp://mqtt-broker:1883 \-e SERIAL_PORT/dev/ttyS0 \-e BAUD_RATE9600 \-v /data/config:/app/config \${REGISTRY}/${APP_NAME}:${NEW_VERSION}# 验证新容器运行状态sleep 5if docker ps | grep -q collector; thenecho 新版本启动成功docker rm collector_backupecho $NEW_VERSION /data/versionelseecho 新版本启动失败回滚到 $CURRENT_VERSIONdocker rename collector collector_faileddocker rename collector_backup collectordocker start collectorexit 1fiecho 升级完成 脚本内置了回滚逻辑如果新版本启动失败自动恢复到旧版本。这在工业现场非常重要因为设备不能长时间停机。## 常见问题FAQ**QDocker容器内如何访问宿主机的串口设备**在docker run时通过--device参数映射设备节点例如--device /dev/ttyS0。也可以在Docker Compose中使用devices字段配置。注意容器内的应用代码使用映射后的设备路径访问串口路径与宿主机一致。**Q工业一体机存储空间有限如何清理Docker占用的空间**使用docker system prune命令清理未使用的镜像、容器和网络。同时通过daemon.json配置日志轮转参数限制单个容器日志文件大小和数量。建议定期执行docker image prune -a清理悬空镜像但注意不要删除正在使用的镜像。**Q容器化部署会影响串口通信的实时性吗**会有轻微影响但通常可接受。Docker使用Linux命名空间隔离资源串口设备通过直通方式映射到容器不经过虚拟化层。实测在9600-115200波特率下容器化部署与裸机部署的通信延迟差异在1ms以内。对实时性要求极高的场景建议使用裸机部署或RT Linux内核。 
长河君 · 2026/8/22 2:06:29 · 阅读 1.2k 工业一体机Docker容器化部署实战：从镜像构建到远程OTA升级全流程
在工业自动化项目中工业一体机往往需要部署多个应用服务——数据采集、设备通信、Web监控界面、边缘计算等。传统裸机部署方式存在依赖冲突、版本管理混乱、升级回滚困难等问题。Docker容器化方案通过隔离运行环境让每个应用在独立的容器中运行互不干扰同时支持镜像版本管理和一键部署回滚是工业一体机软件部署的推荐方案。## 环境准备本文以基于Debian 12的工业一体机为例演示Docker容器化部署的完整流程。### 安装Dockerbash# 更新软件包索引sudo apt update# 安装必要依赖sudo apt install -y ca-certificates curl gnupg lsb-release# 添加Docker官方GPG密钥sudo mkdir -p /etc/apt/keyringscurl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg# 添加Docker仓库echo deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list# 安装Docker引擎sudo apt updatesudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin# 将当前用户加入docker组免sudosudo usermod -aG docker $USER### 配置Docker数据目录工业一体机的系统盘空间通常有限建议将Docker数据目录迁移到独立的存储分区bash# 停止Docker服务sudo systemctl stop docker# 迁移数据目录sudo rsync -aP /var/lib/docker/ /data/docker/# 修改Docker配置sudo tee /etc/docker/daemon.json EOF{data-root: /data/docker,log-driver: json-file,log-opts: {max-size: 10m,max-file: 3}}EOF# 重启Dockersudo systemctl start docker日志轮转配置很重要。工业设备长期运行不重启如果不限制日志大小容器日志文件会撑满磁盘导致设备异常。## 构建工业应用镜像以一个Python数据采集服务为例编写DockerfiledockerfileFROM python:3.11-slimWORKDIR /app# 安装系统依赖串口库等RUN apt-get update apt-get install -y --no-install-recommends \libserialport-dev \ rm -rf /var/lib/apt/lists/*# 安装Python依赖COPY requirements.txt .RUN pip install --no-cache-dir -r requirements.txt# 复制应用代码COPY . .# 配置时区ENV TZAsia/ShanghaiRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime echo $TZ /etc/timezone# 启动命令CMD [python, -u, main.py]构建镜像并打标签bashdocker build -t data-collector:1.0.0 .docker tag data-collector:1.0.0 registry.local:5000/data-collector:1.0.0## 设备访问权限处理Docker容器默认无法访问宿主机的串口和GPIO设备。需要在启动容器时通过--device参数映射设备节点bashdocker run -d \--name collector \--restart unless-stopped \--device /dev/ttyS0 \--device /dev/ttyS1 \--device /dev/gpiochip0 \-e MQTT_BROKERtcp://192.168.1.100:1883 \-e SERIAL_PORT/dev/ttyS0 \-e BAUD_RATE9600 \-v /data/config:/app/config \data-collector:1.0.0如果容器需要访问GPIO还需要确保容器内的用户有权限操作/dev/gpiochip*设备节点。可以通过--privileged参数不推荐权限过大或者在容器内添加对gpio组的访问权限。## Docker Compose多服务编排实际项目中通常需要同时部署多个服务。使用Docker Compose管理yamlversion: 3.8services:data-collector:image: registry.local:5000/data-collector:1.0.0container_name: collectorrestart: unless-stoppeddevices:- /dev/ttyS0- /dev/ttyS1environment:- MQTT_BROKERtcp://mqtt-broker:1883- SERIAL_PORT/dev/ttyS0- BAUD_RATE9600volumes:- ./config/collector:/app/configdepends_on:- mqtt-brokermqtt-broker:image: eclipse-mosquitto:2.0container_name: mqttrestart: unless-stoppedports:- 1883:1883volumes:- ./config/mosquitto:/mosquitto/configweb-monitor:image: registry.local:5000/web-monitor:1.0.0container_name: monitorrestart: unless-stoppedports:- 8080:80environment:- MQTT_BROKERtcp://mqtt-broker:1883depends_on:- mqtt-broker启动服务bashdocker compose up -d## 远程OTA升级方案工业一体机部署在现场后手动逐台升级非常低效。可以通过本地镜像仓库实现远程OTA升级bash#!/bin/bash# OTA升级脚本 upgrade.shREGISTRYregistry.local:5000APP_NAMEdata-collectorNEW_VERSION$1if [ -z $NEW_VERSION ]; thenecho Usage: ./upgrade.sh versionecho Example: ./upgrade.sh 1.1.0exit 1fiecho 开始OTA升级 $APP_NAME 到版本 $NEW_VERSION # 拉取新版本镜像docker pull ${REGISTRY}/${APP_NAME}:${NEW_VERSION}if [ $? -ne 0 ]; thenecho 镜像拉取失败升级中止exit 1fi# 备份当前版本CURRENT_VERSION$(docker inspect --format{{.Config.Image}} collector 2/dev/null | awk -F: {print $2})echo 当前版本: $CURRENT_VERSION# 停止旧容器docker stop collectordocker rename collector collector_backup# 启动新版本容器docker run -d \--name collector \--restart unless-stopped \--device /dev/ttyS0 \--device /dev/ttyS1 \-e MQTT_BROKERtcp://mqtt-broker:1883 \-e SERIAL_PORT/dev/ttyS0 \-e BAUD_RATE9600 \-v /data/config:/app/config \${REGISTRY}/${APP_NAME}:${NEW_VERSION}# 验证新容器运行状态sleep 5if docker ps | grep -q collector; thenecho 新版本启动成功docker rm collector_backupecho $NEW_VERSION /data/versionelseecho 新版本启动失败回滚到 $CURRENT_VERSIONdocker rename collector collector_faileddocker rename collector_backup collectordocker start collectorexit 1fiecho 升级完成 脚本内置了回滚逻辑如果新版本启动失败自动恢复到旧版本。这在工业现场非常重要因为设备不能长时间停机。## 常见问题FAQ**QDocker容器内如何访问宿主机的串口设备**在docker run时通过--device参数映射设备节点例如--device /dev/ttyS0。也可以在Docker Compose中使用devices字段配置。注意容器内的应用代码使用映射后的设备路径访问串口路径与宿主机一致。**Q工业一体机存储空间有限如何清理Docker占用的空间**使用docker system prune命令清理未使用的镜像、容器和网络。同时通过daemon.json配置日志轮转参数限制单个容器日志文件大小和数量。建议定期执行docker image prune -a清理悬空镜像但注意不要删除正在使用的镜像。**Q容器化部署会影响串口通信的实时性吗**会有轻微影响但通常可接受。Docker使用Linux命名空间隔离资源串口设备通过直通方式映射到容器不经过虚拟化层。实测在9600-115200波特率下容器化部署与裸机部署的通信延迟差异在1ms以内。对实时性要求极高的场景建议使用裸机部署或RT Linux内核。