piklz/presto_x728

Presto X728 UPS和系统监控镜像

镜像概述

pi-ups-monitors项目提供Docker化的Python脚本（presto_x728_sysmon.py），用于监控树莓派上安装的Presto X728 UPS HAT的健康状态。该方案专为无头可靠监控设计，收集系统关键指标（如CPU温度）和UPS专属数据（如电压、电源来源状态），并将所有警报通过ntfy发送至移动设备，实现便捷的远程通知。

核心功能

1. 收集树莓派系统指标：CPU温度、系统 uptime 等；
2. 监控UPS状态：电池电压、电源来源（市电/电池）、充电状态等；
3. 通过ntfy发送移动通知：支持手机或桌面端接收警报；
4. 无头运行：适配无界面的树莓派服务器环境；
5. 容器化部署：简化依赖管理，快速启动服务。

使用场景

• 树莓派服务器的UPS状态监控，确保断电时及时收到通知；
• 远程管理树莓派设备，实时掌握系统和UPS健康状况；
• 无需手动配置依赖，通过Docker快速部署监控服务；
• 对UPS电池寿命和系统稳定性进行长期跟踪。

配置说明与部署示例

前置条件

确保树莓派已安装Docker和Docker Compose。

Docker Compose部署

创建docker-compose.yml文件，内容如下：

yaml
services:
  presto_x728:
    image: piklz/presto_x728
    container_name: presto_x728
    ports:
      - "7728:7728"
    privileged: true
    user: "0:0"  # 以root身份运行以访问设备
    cap_add:
      - SYS_RAWIO
      - NET_BIND_SERVICE
      - ALL
    volumes:
      - /dev:/dev
      - /sys:/sys:ro
      - /sys/class/thermal/thermal_zone0/temp:/sys/class/thermal/thermal_zone0/temp:ro
      - /proc/uptime:/proc/uptime
      - /:/host:ro
      - ./volumes/presto_x728/config:/config
    devices:
      - /dev/gpiochip0:/dev/gpiochip0
      - /dev/gpiochip4:/dev/gpiochip4
      - /dev/i2c-1:/dev/i2c-1
    restart: unless-stopped
    pid: host
    command: ["gunicorn", "--bind", "0.0.0.0:7728", "--workers", "1", "--worker-class", "gevent", "--timeout", "120", "presto_x728_sysmon:app"]

执行启动命令：

bash
docker compose up -d

终端直接运行

通过终端快速启动（退出时自动移除容器）：

bash
docker run --rm -it \
  --name presto_x728 \
  --privileged \
  --user "0:0" \
  -p 7728:7728  \
  -v /:/host:ro  \
  -v /sys:/sys \
  -v /dev/gpiochip0:/dev/gpiochip0  \
  -v ./volumes/presto_x728/config:/config  \
  piklz/presto_x728