gersilex/apcupsd

APCUPSd-Docker镜像说明

镜像概述

本Docker容器用于连接本地APC UPS设备或远程apcupsd实例，即使在容器中运行，也能通知主机并触发关机（或其他）操作，且无需特殊权限。同时支持执行任意自定义命令及apcupsd的各类触发动作。

核心功能

• 连接本地或远程APC UPS设备
• 在UPS低电量、剩余寿命不足等条件下触发主机操作
• 支持自定义配置文件（apcupsd.conf、doshutdown等）
• 无需特殊权限即可运行
• 可通过日志输出查看UPS状态

使用场景

• 监控本地APC UPS设备状态
• 远程监控其他主机上的UPS设备
• 在UPS异常时自动关闭Docker主机及容器
• 需要自定义UPS触发动作的场景

配置说明

依赖

• Bash环境

默认运行

sh
docker run -t -v /tmp/apcupsd-docker:/tmp/apcupsd-docker gersilex/apcupsd:v1

自定义配置

1. 克隆或下载仓库内容
2. 复制并修改apcupsd.conf、doshutdown或host-trigger-check.sh
3. 映射自定义文件到容器：

sh
docker run -t \
  -v /tmp/apcupsd-docker:/tmp/apcupsd-docker \
  -v /path/to/your/apcupsd.conf:/etc/apcupsd/apcupsd.conf \
  -v /path/to/your/doshutdown:/etc/apcupsd/doshutdown \
  gersilex/apcupsd:v1

主机触发检查

容器中的doshutdown脚本会在UPS满足条件时，在映射目录下写入trigger文件（内容为1）。主机可通过cron或inotify监控该文件，执行关机操作：

• 主机脚本示例（host-trigger-check.sh）：

sh
TRIGGERFILE="/tmp/apcupsd-docker/trigger"
action(){
  echo "检测到触发文件内容为1，执行关机操作..."
  shutdown -P +5
  docker ps -q | xargs --no-run-if-empty docker stop --time 300
  shutdown -P now
}
# 检查逻辑（完整脚本请参考原仓库）

• Cron配置（每分钟检查）：

sh
* * * * * /root/apcupsd/host-trigger-check.sh

Docker标签

• v1/latest：v1的最新稳定版，无兼容性破坏
• v1.0.0：特定版本，不会更新

FAQ

• Q：无日志输出？A：需添加-t参数分配TTY，apcupsd仅向TTY输出日志。
• Q：仅显示“NIS server startup succeeded”？A：60秒内无新日志属正常，可通过docker exec -it <容器名> apcaccess验证连接。
• Q：如何验证工作状态？A：执行docker exec -it <容器名> apcaccess查看UPS状态。

许可证

MIT

支持作者

[***]