Apcupsd是一款可以在Linux、UNIX、macOS和Windows上运行的APC UPS管理软件。支持APC和APC的OEM品牌产品对UPS进行通信，支持主机在断电后自动关机，同时也支持网络UPS的功能。
以前还有在线文档，现在已经没了：www.apcupsd.org自动跳转下载地址。
不过安装好了以后，在安装路径\apcupsd\doc\manual.html中有这个文档的本地版。
目前的版本是3.14.14，而且很久没有更新了
下载连接https://sourceforge.net/projects/apcupsd/
下载好后是一个安装程序。
这里的UPS用Apc BK650 作为演示。
安装软件本体
部分windows版本需要以管理员权限运行。
首先，把UPS的数据线插入计算机，系统中会多出一个电池图标
设备管理器中会多出HID UPS电池和American Power Conversion USB UPS两个设备
之后开始安装程序，一路下一步，没什么好说的。
这里默认全选
安装位置可随意指定，之后正式进入安装。安装时会弹出几次警告。
此警告是表示没有安装USB驱动，后续需要自己另外安装。
安装完成，此时点击Next会弹出配置文件（apcupsd.conf），
apcupsd.conf暂时用不上，直接关闭即可
之后还是一路下一步，保持默认选项即可，中间会弹出几个警告，基本都是提示服务安装成功之类的
安装完成。默认会弹出发布文档ReleaseNotes.txt，关掉即可。
之后windows server右下角图标栏会多出一个图标，由于没有安装USB驱动，所以会显示“？”。
之后安装USB驱动。
安装USB驱动
注意！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！！
这里安装的驱动不是HID UPS电池
而是American Power Conversion USB UPS
打开设备管理器，右键更新驱动程序。
浏览我的电脑以查找驱动。
选择驱动文件位置：
是在安装位置的。apcupsd\driver文件中，图中直接安装在C盘。之后下一步
安装
安装成功。
安装成功后，设备管理器-电池中的HID UPS会变成American Power Conversion USB UPS（Apcupsd）；而人体学输入设备中的American Power Conversion USB UPS会消失。
此时右下角图标栏Apcupsd的图标会变成一个插头的状态。
双击打开会显示当前的配置，电池健康状态等信息。
配置文件说明
配置文件路径：安装路径\apcupsd\etc\apcupsd\apcupsd.conf
日志文件路径：安装路径\apcupsd\etc\apcupsd\apcupsd.events
注意！每次修改配置文件后需要重启apcupsd服务才能生效！
用记事本打开文件
对于Bk650这种简单的后背式USB UPS只需要关注以下几点即可：
文件中#号后面的是注释。
首先apcupsd在检测到断电后会有一个延迟时间ONBATTERYDELAY（秒）。在此期间判断是否是真的断电。之后再执行关机命令，其中MINUTES、TIMEOUT、BATTERYLEVEL三个条件，哪个先满足，执行哪个。
ANNOYDELAY参数是在ONBATTERYDELAY之后延迟多少秒通知用户市电已经断电。
- MINUTES：在UPS还能运行多久(分钟)时关机。例如MINUTES 3，还能运行3分钟
- TIMEOUT：UPS断电后多久自动关机(秒)。例如TIMEOUT 10，断电后10秒关机
- BATTERYLEVEL：在电池电量还剩多少时（百分比）关机，例如BATTERYLEVEL 5就是5%
假如设置为ONBATTERYDELAY 6、TIMEOUT 30。那么服务器会在断电后30+6秒执行关机程序。
修改完成后保存，关闭。之后重启Apcupsd服务即可。
注意！对windows图标栏中的插头右键Exit不是退出服务。这只是退出了Apcupsd的一个图形监控软件apctray.exe
真正的服务进程是apcupsd.exe
重启也很简单，开始菜单，Apcupsd。Stop Apcupsd（停止服务）；Start Apcupsd（启动服务）。
常见错误
1：安装USB驱动时没有证书、证书不被信任、第三方INF不包含数字签名…………
检查USB驱动文件中是否缺少证书。若缺少以下文件，需要卸载Apcupsd，重新安装
路径：安装位置\apcupsd\driver
2：安装USB驱动后出现 American Power Conversion USB UPS(Apcupsd)“该设备无法启动(代码10)”
原因：安装USB驱动时错误的选择了电池目录中的“HID UPS电池”，而不是人体学输入设备中的“American Power Conversion USB UPS”
解决方案，卸载American Power Conversion USB UPS(Apcupsd)，以正确的方法重新安装。
最后进行断电测试
注意！如果你的NAS、服务器使用CRPS冗余电源，不要把两个电源插头都插到BK650上；一个插头插BK650上面，另一个插头插市电上。否则很可能会让UPS失去作用。
配置网络UPS
Apcupsd支持多种通信模式，但BK650只有最基本的USB模式。所以SNMP、PCNET等模式均无法使用；只能使用UPSTYPE net模式。一个作为主机（Master）通过USB连接UPS，其余的作为从机（Slave）通过网络连接主机。
注意！BK650配置这个功能需要在断电时保证主机和从机之间网络畅通。具体来说路由器，交换机之类的网络设备也要用UPS供电。或者两台机器直接用网线连起来。
假设主机的内网地址为10.0.0.25
关键配置文件示例：
| 主机 | 从机 |
| UPSCABLE usb | UPSTYPE net |
| UPSTYPE usb | UPSCABLE ether |
| DEVICE | DEVICE 10.0.0.25:3551 |
| NETSERVER on | |
| NISIP 0.0.0.0 | |
| NISPORT 3551 | |
| ONBATTERYDELAY 6 | ONBATTERYDELAY 1 |
| POLLTIME 10 |
从机的关机时间和POLLTIME（apcupsd 轮询 UPS 状态的间隔）有关，不一定很准确。POLLTIME默认为60（秒）建议改小点，且必须要小于从机的TIMEOUT规则。否则关机时间会很不稳定。但会占用更多的CPU。
如果配置不当，会造成主机比从机先关机的状况，此时从机上的apcupsd服务无法检测UPS状态，便无法执行关机命令。会一直处于开机状态。所以，从机必须比主机更早执行关机。
之后记得开放防主机防火墙，windows系统开放入站TCP 3551端口。
从机的apctray.exe也可以通过网络检测主机的apcupsd状态。
从机中apctray.exe右键，configure
这里改成主机的IP和端口号。
之后从机的apctray.exe便可以监控主机的apcupsd了。
完成后进行断电测试即可。
apcupsd修改电池时间
BK650更换电池后，务必修改电池时间，否则程序还是会按照旧电池的续航标准来运行。
首先停止apcupsd服务。
cmd进入apcupsd安装目录\bin，执行apctest命令,输入数字4 回车。
之后按照MM/DD/YYYY（月/日/年）的格式输入更换电池的时间
例如06/22/2022之后回车确认，然后q退出。
修改完成后启动apcupsd服务。