sensor image 镜像文档

镜像概述

sensor image 是专为传感器数据处理设计的Docker镜像，旨在简化传感器应用的部署与管理。该镜像集成数据采集工具、处理逻辑及网络传输模块，提供标准化配置接口，支持多类型传感器和数据格式，适用于各类传感器数据处理场景。

核心功能和特性

• 多传感器兼容：支持温度、湿度、压力、光照等多种常见传感器类型
• 数据处理能力：内置数据过滤、格式转换、异常值检测等基础处理功能
• 灵活传输协议：兼容HTTP、MQTT、TCP等多种数据传输方式
• 可配置化设计：通过环境变量或配置文件自定义采集间隔、传输目标等参数
• 轻量高效：基于精简基础镜像构建，资源占用低，适合边缘设备部署

使用场景和适用范围

• 物联网（IoT）节点：智能家居、环境监测等场景的传感器数据上报
• 工业监控系统：生产线设备状态监测、环境参数实时采集
• 科研实验：实验室传感器数据的持续记录与远程传输
• 边缘计算：边缘设备上的传感器数据预处理，降低云端传输压力

使用方法和配置说明

基本部署

确保Docker环境已安装，通过以下命令拉取并运行镜像：

docker run -d --name sensor-instance sensor-image:latest

环境变量配置

通过环境变量自定义镜像行为，常用配置如下：

示例：部署温度传感器，每10秒通过MQTT传输数据

docker run -d --name temp-sensor \
  -e SENSOR_TYPE=temperature \
  -e DATA_INTERVAL=10 \
  -e TRANSPORT_PROTOCOL=mqtt \
  -e SERVER_ADDRESS=mqtt://mqtt.example.com:1883 \
  sensor-image:latest

配置文件挂载

复杂配置可通过JSON配置文件实现，默认路径/app/config/sensor.json：

1. 创建本地配置文件 sensor-config.json：

{
  "sensor": {
    "type": "humidity",
    "read_timeout": 5000,
    "retry_count": 3
  },
  "采集参数": {
    "interval": 15,
    "batch_size": 10
  },
  "transport": {
    "protocol": "mqtt",
    "server": "mqtt://mqtt.example.com:1883",
    "topic": "sensors/humidity",
    "qos": 1
  },
  "logging": {
    "level": "debug",
    "file_path": "/var/log/sensor.log"
  }
}

2. 挂载配置文件运行：

docker run -d --name humidity-sensor \
  -v $(pwd)/sensor-config.json:/app/config/sensor.json \
  sensor-image:latest

Docker Compose配置

使用docker-compose.yml简化服务管理：

version: '3.8'
services:
  sensor-service:
    image: sensor-image:latest
    container_name: factory-sensor
    restart: always
    environment:
      - SENSOR_TYPE=pressure
      - DATA_INTERVAL=5
      - TRANSPORT_PROTOCOL=mqtt
      - SERVER_ADDRESS=mqtt://mqtt.factory.internal:1883
    volumes:
      - ./sensor-data:/app/data  # 挂载数据存储目录
    network_mode: "host"  # 如需访问本地传感器设备

数据持久化

挂载数据目录保存历史采集数据：

docker run -d --name sensor-with-data \
  -v /host/path/to/data:/app/data \
  sensor-image:latest

数据将按时间戳保存为/app/data目录下的CSV文件。