智能制造与工业软件 / 系统课时
用 Compose 启动消息代理和时序库
用 Compose 启动消息代理和时序库
本课用 Docker Compose 在开发机上启动 Mosquitto MQTT 代理和 InfluxDB 2 时序库,统一镜像版本、端口、网络和持久化目录。完成后可以重复启动环境,验证消息收发,并检查数据库和容器健康状态。
学习目标
- 编写可复用的
compose.yaml、Mosquitto 配置和 InfluxDB 初始化参数。 - 区分宿主机端口、容器服务名、内部网络与持久化数据卷。
- 通过 Compose 状态、MQTT 收发和 InfluxDB 探活验证部署。
检查 Docker 并准备配置文件
以下命令适用于 Linux、macOS 或 Windows 的 WSL2 Bash,要求 Docker Engine 正在运行且安装 Docker Compose v2。先确认版本,再建立工作目录;Windows 使用 Docker Desktop 时需先启动应用。
docker version --format '{{.Server.Version}}'
docker compose version
mkdir -p iiot-lab/mosquitto/config
cd iiot-lab预期结果:前两条命令分别打印 Docker Engine 和 Compose 的实际版本号,后两条命令无报错,当前目录变为 iiot-lab。版本号因机器而异;如果提示无法连接 Docker daemon,先启动 Docker Engine。
新建 mosquitto/config/mosquitto.conf。Mosquitto 2.x 配置显式监听,否则容器外客户端可能无法连接。
listener 1883
allow_anonymous true
persistence true
persistence_location /mosquitto/data/
log_dest stdout这份配置让 MQTT 代理监听容器内 TCP 1883,将持久化会话与保留消息写到 /mosquitto/data/,日志输出给 docker compose logs。匿名连接只用于本地隔离实验,不能照搬到工厂网络。
定义数据库初始化和 Compose 服务
在 iiot-lab 下新建 .env。以下是教学用的示例凭据,实际运行前应自行替换,不要提交版本库。
INFLUXDB_ADMIN_PASSWORD=DemoLocal_2026_ChangeMe!
INFLUXDB_ADMIN_TOKEN=demo-operator-token-change-me-2026再新建 compose.yaml。明确固定 Mosquitto 2.0.22 和 InfluxDB 2.7.12,避免使用会改变主版本的 latest;初始化环境变量适用于 InfluxDB OSS 2.x,而非 InfluxDB 3。
name: iiot-lab
services:
mqtt:
image: eclipse-mosquitto:2.0.22
ports:
- "127.0.0.1:1883:1883"
volumes:
- ./mosquitto/config/mosquitto.conf:/mosquitto/config/mosquitto.conf:ro
- mqtt_data:/mosquitto/data
networks: [iiot]
healthcheck:
test: ["CMD", "mosquitto_pub", "-h", "127.0.0.1", "-t", "lab/health", "-m", "ok"]
interval: 10s
timeout: 3s
retries: 5
start_period: 5s
influxdb:
image: influxdb:2.7.12
ports:
- "127.0.0.1:8086:8086"
environment:
DOCKER_INFLUXDB_INIT_MODE: setup
DOCKER_INFLUXDB_INIT_USERNAME: labadmin
DOCKER_INFLUXDB_INIT_PASSWORD: ${INFLUXDB_ADMIN_PASSWORD}
DOCKER_INFLUXDB_INIT_ORG: plant-lab
DOCKER_INFLUXDB_INIT_BUCKET: telemetry
DOCKER_INFLUXDB_INIT_ADMIN_TOKEN: ${INFLUXDB_ADMIN_TOKEN}
volumes:
- influxdb_data:/var/lib/influxdb2
- influxdb_config:/etc/influxdb2
networks: [iiot]
healthcheck:
test: ["CMD", "influx", "ping", "--host", "http://127.0.0.1:8086"]
interval: 10s
timeout: 3s
retries: 10
start_period: 20s
volumes:
mqtt_data:
influxdb_data:
influxdb_config:
networks:
iiot:
driver: bridgemqtt_data、influxdb_data 和 influxdb_config 是 Docker 管理的命名卷,分别挂载到容器内的数据或配置目录;容器重建不会自动清除它们。InfluxDB 的用户 labadmin、组织 plant-lab 和存储桶 telemetry 仅在空数据卷首次初始化时创建,修改 .env 不会重置已有账号。
识别端口、服务名和存储边界
宿主机只通过 127.0.0.1:1883 连接 MQTT,通过 http://127.0.0.1:8086 打开 InfluxDB;同一个 Compose 网络内的后续采集程序应使用 mqtt:1883 和 http://influxdb:8086。127.0.0.1 在容器内部指容器自己,不指另一服务。

启动容器并执行双重验证
在包含 compose.yaml 的目录运行以下命令。先验证配置,再后台启动并等待服务健康,最后查看状态和端口映射。
docker compose config --quiet
docker compose up -d --wait
docker compose ps预期结果:配置校验无输出且退出码为 0;镜像拉取和初始化完成后,mqtt 与 influxdb 都显示 Up 和 healthy,端口分别映射到宿主机的 127.0.0.1:1883、127.0.0.1:8086。如果等待健康状态超时,通过服务日志进一步定位。
用镜像内自带的客户端发送一条保留消息,再订阅同一主题。-r 确保先发布后订阅也能收到,-C 1 表示收到一条后退出。
docker compose exec -T mqtt mosquitto_pub -h 127.0.0.1 -t factory/line1/temp -m "23.5" -r
docker compose exec -T mqtt mosquitto_sub -h 127.0.0.1 -t factory/line1/temp -C 1 -W 5预期输出:
23.5检查 InfluxDB 健康接口:
docker compose exec -T influxdb influx ping --host http://127.0.0.1:8086预期输出:
OK再用浏览器打开 http://127.0.0.1:8086,以 labadmin 和 .env 中的密码登录,核对组织 plant-lab 下存在 telemetry 存储桶。这比只看到容器运行更能确认首次初始化已完成。
检查持久化与排除启动失败
先重启服务并等待恢复健康,再重新订阅保留主题:
docker compose restart
docker compose up -d --wait
docker compose exec -T mqtt mosquitto_sub -h 127.0.0.1 -t factory/line1/temp -C 1 -W 5预期输出仍为:
23.5若启动失败,先通过 docker compose logs --tail=50 mqtt influxdb 查看具体报错。端口占用时只改 ports 左侧宿主机端口,例如 127.0.0.1:1884:1883,容器内 MQTT 端口和服务名不必改;配置挂载失败则核对 mosquitto/config/mosquitto.conf 是否为真实文件。InfluxDB 登录凭据不符合新 .env 时,先检查是否复用了以前初始化的命名卷,不要直接删卷。