UPS断电自动备份关机脚本保护住宅服务器硬件

为什么住宅服务器需要UPS自动关机脚本

家用服务器或NAS最怕突然断电——不仅可能损坏文件系统，还可能直接导致硬盘出现坏道。
配置UPS（不间断电源）并搭配自动备份关机脚本，可以在停电时先让服务器保存数据、安全卸载文件系统，再干净地关机。
本文以最常见的APC UPS和Linux系统为例，完整演示从硬件连接到脚本生效的全过程。

准备阶段：硬件与软件

硬件要求

• 一台带USB或串口通信功能的UPS（例如APC Back-UPS系列）
• USB数据线（通常随UPS附带）
• 服务器安装在Linux发行版（Ubuntu/Debian/CentOS均可，本文以Ubuntu 22.04为例）

安装通信软件

将UPS通过USB线连接到服务器后，执行以下命令安装apcupsd：

sudo apt update
sudo apt install apcupsd -y

安装完成后，用命令查看UPS是否被识别：

apcaccess status

如果看到STATUS: ONLINE等输出，说明通信正常。
如果没反应，检查USB线或换用lsusb确认设备。

编写自动备份关机脚本

脚本逻辑说明

脚本需要完成三件事：检测UPS状态（比如电池电量低于某个阈值或市电已断）、执行备份（例如用rsync同步重要目录）、最后执行安全关机。

直接可用的脚本模板

在/usr/local/bin/下新建文件ups-shutdown.sh，内容如下：

#!/bin/bash
# UPS断电自动备份关机脚本
LOG=/var/log/ups-shutdown.log
echo "$(date): UPS电池电量或市电异常触发脚本" >> $LOG
# 备份关键数据（请根据实际情况修改源和目标路径）
rsync -av --delete /home/user/important/ /mnt/backup/important/ >> $LOG 2>&1
# 等待同步完毕
sync
# 安全关机
echo "$(date): 开始关机" >> $LOG
/sbin/shutdown -h now

保存后赋予执行权限：

chmod +x /usr/local/bin/ups-shutdown.sh

配置apcupsd自动调用脚本

apcupsd通过/etc/apcupsd/apccontrol文件决定在各种事件下执行哪些命令。
我们需要修改该文件，在断电或电量低时调用我们的脚本。

编辑配置文件（建议先备份）：

sudo cp /etc/apcupsd/apccontrol /etc/apcupsd/apccontrol.bak
sudo nano /etc/apcupsd/apccontrol

找到类似下面这行（通常是case $1 in之后的TIMEOUT事件）：

TIMEOUT)

在该分支下替换成调用我们的脚本：

TIMEOUT)
  # 原始内容注释掉或删除
  /bin/echo "UPS timeout - running shutdown script" | $WALL
  /usr/local/bin/ups-shutdown.sh
  ;;

另外，如果希望在电池电量低于某个百分比时触发，可以在LOWBATT事件做同样操作：

LOWBATT)
  /usr/local/bin/ups-shutdown.sh
  ;;

保存文件后，重启apcupsd服务：

sudo systemctl restart apcupsd

避坑指南与常见问题

脚本未执行的原因

• 权限问题：确保脚本有执行权限，且/etc/apcupsd/apccontrol有读取权限（通常默认755）。
• 路径写错：shutdown命令必须使用绝对路径/sbin/shutdown。
• 环境变量：apcupsd执行脚本时环境变量有限，建议在脚本第一行设定#!/bin/bash，并在内部使用绝对路径。
• 日志检查：/var/log/ups-shutdown.log是否可写？可先手动运行脚本测试输出。

电池电量阈值调整

默认apcupsd在电池剩余5%时触发LOWBATT。
如果想改高（例如20%），修改/etc/apcupsd/apcupsd.conf中的BATTERYLEVEL参数：

BATTERYLEVEL 20

然后重启服务。

防止重复关机

如果短时间内多次触发相同事件，脚本可能重复执行关机。
建议在脚本开头添加锁机制：

LOCKFILE=/var/lock/ups-shutdown.lock
if [ -f $LOCKFILE ]; then
  exit 0
fi
touch $LOCKFILE

效果验证：模拟断电测试

安全测试方法

1. 确认服务器已连接UPS并开启apcupsd服务。
2. 在确保数据备份可恢复的前提下，拔掉UPS的市电输入线（注意不要拔掉UPS到服务器的电源线）。
3. 观察服务器行为：预期在电池电量低于设定阈值或超时后，系统会记录日志并自动关机。
4. 重新接通市电，启动服务器，查看日志：

cat /var/log/ups-shutdown.log
cat /var/log/messages | grep apcupsd

如果看到“开始关机”字样且服务器正常关闭，说明脚本生效。

总结

为住宅服务器配置UPS断电自动备份关机脚本并不复杂——安装通信软件、编写脚本、配置事件触发器、充分测试即可。
核心是确保脚本能正确执行备份和关机，避免因权限、路径、触发条件等问题导致失效。
如果你正在搭建家用服务器，建议先按本文步骤完整操作一遍，再根据实际备份路径和UPS型号微调。
遇到异常时优先查看日志，八成问题出在脚本权限或设备识别上。