tygozwolle/rpi-system-sensors-docker

Docker化的树莓派系统传感器

概述

本镜像为基于Alpine的Docker镜像，实现了树莓派系统传感器项目的容器化部署（项目地址：https://github.com/Tygozwolle/rpi-system-sensors-docker%EF%BC%89%E3%80%82%E5%85%B6%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E6%98%AF%E7%9B%91%E6%8E%A7%E6%A0%91%E8%8E%93%E6%B4%BE%E8%AE%BE%E5%A4%87%E7%9A%84%E5%90%84%E7%B1%BB%E7%B3%BB%E7%BB%9F%E7%8A%B6%E6%80%81%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87MQTT%E5%8D%8F%E8%AE%AE%E5%B0%86%E6%95%B0%E6%8D%AE%E4%BC%A0%E8%BE%93%E8%87%B3%E6%8C%87%E5%AE%9A%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E7%B3%BB%E7%BB%9F%E7%8A%B6%E6%80%81%E7%9B%91%E6%8E%A7%E4%B8%8E%E6%99%BA%E8%83%BD%E5%AE%B6%E5%B1%85%E5%B9%B3%E5%8F%B0%E9%9B%86%E6%88%90%E5%9C%BA%E6%99%AF%E3%80%82

核心功能和特性

• 多类型传感器支持：可监控温度、时钟速度、磁盘使用、内存使用、CPU使用率、负载平均值、网络流量、电池状态（v2.1.0+）等20+系统指标
• 灵活配置：通过环境变量控制各传感器的启用/禁用状态
• MQTT协议支持：支持连接至MQTT服务器，传输监控数据
• 自定义参数：可配置更新间隔、时区、设备名称、客户端ID等
• 轻量级：基于Alpine Linux，镜像体积小，资源占用低

使用场景和适用范围

• 树莓派设备的系统状态实时监控
• 集成到Home Assistant等智能家居平台，实现系统状态可视化与自动化
• 远程监控树莓派的运行状态，如温度、资源占用、网络连接等
• 适用于需要对树莓派进行集中化管理的场景

使用方法和配置说明

环境变量

以下环境变量用于配置镜像行为，所有变量均为可选，未设置时使用默认值：

MQTT_HOST (默认 '127.0.0.1') - MQTT服务器地址
MQTT_PORT (默认 '1883') - MQTT服务器端口
MQTT_USER - MQTT服务器认证用户名（可选）
MQTT_PASSWORD - MQTT服务器认证密码（可选）
DEVICE_NAME (默认 'test') - 设备名称，用于MQTT主题标识
CLIENT_ID (默认 'test') - MQTT客户端ID
TIMEZONE (默认 'Europe/Brussels') - 时区设置，如 'Asia/Shanghai'
UPDATE_INTERVAL (默认 '60') - 数据更新间隔（秒）
SENSORS_TEMPERATURE (默认 'true') - 是否启用温度传感器
SENSORS_CLOCK_SPEED (默认 'true') - 是否启用时钟速度传感器
SENSORS_DISK_USE (默认 'true') - 是否启用磁盘使用传感器
SENSORS_MEMORY_USE (默认 'true') - 是否启用内存使用传感器
SENSORS_CPU_USAGE (默认 'true') - 是否启用CPU使用率传感器
SENSORS_LOAD1 (默认 'true') - 是否启用1分钟负载平均值传感器
SENSORS_LOAD5 (默认 'true') - 是否启用5分钟负载平均值传感器
SENSORS_LOAD15 (默认 'true') - 是否启用15分钟负载平均值传感器
SENSORS_NET_TX (默认 'true') - 是否启用网络发送传感器
SENSORS_NET_RX (默认 'true') - 是否启用网络接收传感器
SENSORS_SWAP_USAGE (默认 'true') - 是否启用交换分区使用传感器
SENSORS_POWER_STATUS (默认 'true') - 是否启用电源状态传感器
SENSORS_LAST_BOOT (默认 'true') - 是否启用最后启动时间传感器
SENSORS_HOSTNAME (默认 'true') - 是否启用主机名传感器
SENSORS_HOST_IP (默认 'true') - 是否启用主机IP传感器
SENSORS_HOST_OS (默认 'true') - 是否启用主机操作系统传感器
SENSORS_HOST_ARCH (默认 'true') - 是否启用主机架构传感器
SENSORS_LAST_MESSAGE (默认 'true') - 是否启用最后消息时间传感器
SENSORS_UPDATES (默认 'true') - 是否启用更新状态传感器
SENSORS_WIFI_STRENGTH (默认 'true') - 是否启用WiFi信号强度传感器
SENSORS_WIFI_SSID (默认 'true') - 是否启用WiFi SSID传感器
SENSORS_BATTERY (默认 'false') (v2.1.0+ 新增) - 是否启用电池状态传感器
SENSORS_NET_TX_DATA (默认 'true') (v2.3.0+ 新增) - 是否启用网络发送数据量传感器
SENSORS_NET_RX_DATA (默认 'true') (v2.3.0+ 新增) - 是否启用网络接收数据量传感器
SENSOR_DRIVE - 指定监控的磁盘驱动器（可选）

Docker部署示例

基本运行命令

bash
docker run -d \
  --name rpi-system-sensors \
  -e MQTT_HOST="mqtt.example.com" \
  -e MQTT_PORT="1883" \
  -e MQTT_USER="mqtt-user" \
  -e MQTT_PASSWORD="mqtt-password" \
  -e DEVICE_NAME="my-rpi" \
  -e TIMEZONE="Asia/Shanghai" \
  -e UPDATE_INTERVAL="30" \
  -e SENSORS_BATTERY="true" \
  docker.xuanyuan.run/tygozwolle/rpi-system-sensors

Docker Compose配置示例

yaml
version: '3'
services:
  rpi-system-sensors:
    image: tygozwolle/rpi-system-sensors
    container_name: rpi-system-sensors
    environment:
      - MQTT_HOST=mqtt.example.com
      - MQTT_PORT=1883
      - MQTT_USER=mqtt-user
      - MQTT_PASSWORD=mqtt-password
      - DEVICE_NAME=living-room-rpi
      - TIMEZONE=Asia/Shanghai
      - UPDATE_INTERVAL=60
      - SENSORS_TEMPERATURE=true
      - SENSORS_CPU_USAGE=true
      - SENSORS_MEMORY_USE=true
      - SENSORS_BATTERY=false
    restart: unless-stopped