sfudeus/apcupsd_exporter

Docker APCUPSD-Exporter 镜像文档

镜像概述

本镜像封装了来自 https://github.com/mdlayher/apcupsd_exporter.git 的基于Go语言开发的exporter，用于将apcupsd服务的UPS监控数据转换为可被监控系统（如Prometheus）采集的指标格式。

核心功能与特性

• 多架构支持：提供arm和amd64两种架构的镜像，适配不同硬件环境。
• 定期更新：从项目master分支定期拉取最新代码，使用最新版本的Go语言进行重建，确保功能和安全性更新。
• 版本标识清晰：镜像标签采用 ${code_branch}_${go_version} 格式命名，明确标识代码分支和构建时使用的Go版本。

适用场景

适用于部署了APC UPS设备并运行apcupsd服务的环境，需通过监控系统（如Prometheus）收集UPS状态、负载、电池等指标数据的场景。

构建信息

• 构建周期：定期自动重建，确保与上游项目master分支代码同步。
• 构建环境：使用最新稳定版Go语言编译，保证exporter性能和兼容性。
• 标签规则：镜像标签格式为 ${code_branch}_${go_version}，例如 master_1.21.0（表示基于master分支代码，使用Go 1.21.0构建）。

使用方法

基本配置要求

运行容器时，需通过命令行参数 -apcupsd.addr 指定apcupsd服务的连接地址（格式为 host:port），apcupsd默认端口为3551。

容器启动示例

bash
# 连接本地apcupsd服务（默认端口3551）
docker run -d --name apcupsd-exporter [镜像名称]:[标签] -apcupsd.addr="localhost:3551"

# 连接远程apcupsd服务
docker run -d --name apcupsd-exporter [镜像名称]:[标签] -apcupsd.addr="192.168.1.100:3551"

参数说明

注意事项

• 确保容器能够网络访问指定的apcupsd服务地址及端口。
• 关于exporter的更多配置选项（如指标路径、监听端口等），请参考上游项目文档：https://github.com/mdlayher/apcupsd_exporter.git%E3%80%82