vrelk/apcupsd-docker

APCUPSd-Docker镜像说明

镜像概述

该Docker容器用于连接本地APC UPS或远程apcupsd实例，即使在容器中运行也能通知主机并触发关机等动作，无需特殊权限。同时支持执行任意命令和apcupsd的各类触发动作。

核心功能

• 连接本地或远程APC UPS设备
• 监控UPS状态（电池电量、剩余时间、运行模式等）
• 触发关机或其他自定义动作
• 无需特殊权限即可与主机交互，实现状态通知和操作执行

使用场景

• 家庭服务器环境：UPS电量不足时自动关闭服务器，避免数据丢失
• 小型数据中心/办公服务器：UPS异常时安全关闭系统，保障设备安全
• 远程监控场景：通过远程apcupsd实例监控UPS状态并执行相应操作

配置说明

基本运行

默认设置运行命令：

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

自定义配置

1. 克隆或下载该仓库内容
2. 复制apcupsd.conf并修改配置
3. （可选）修改doshutdown和/或host-trigger-check.sh
4. 运行容器并映射自定义文件：

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

配置示例

最小化apcupsd.conf配置

连接远程nas主机上的apcupsd实例，电池电量低于5%或剩余时间少于10分钟时执行关机：

apache
# /etc/apcupsd/apcupsd.conf
UPSTYPE net
DEVICE nas:3551
BATTERYLEVEL 5
MINUTES 10

主机触发脚本（host-trigger-check.sh片段）

监控触发文件并执行关机操作：

sh
# /root/apcupsd/host-trigger-check.sh（节选）
TRIGGERFILE="/tmp/apcupsd-docker/trigger"

action(){
  echo "检测到$TRIGGERFILE中为'1'."
  # 5分钟后关机
  shutdown -P +5
  # 停止所有Docker容器
  docker ps -q | xargs --no-run-if-empty docker stop --time 300
  # 立即关机（若容器停止完成）
  shutdown -P now
}

Crontab配置

每分钟检查触发文件：

sh
# /var/spool/cron/gersilex（通过crontab -e编辑）
* * * * * /root/apcupsd/host-trigger-check.sh

FAQ

Q: 看不到日志输出？
A: 运行容器时需分配tty（使用docker run -t），apcupsd仅向tty输出日志。

Q: 仅看到NIS server startup succeeded？
A: 若60秒内无新日志，通常表示正常。apcupsd不会记录成功连接，可使用apcaccess验证。

Q: 如何验证是否工作？
A: 运行docker exec -it <容器名称> apcaccess查看输出。

许可证

MIT