chatwork/kumina-postfix-exporter

Postfix Exporter 镜像文档

镜像概述和主要用途

Postfix Exporter 是一个针对 Postfix 邮件服务器的 Prometheus 导出器，用于收集并暴露 Postfix 的运行指标，使 Prometheus 能够抓取这些指标进行监控、分析和告警。该镜像基于 https://github.com/kumina/postfix-exporter 项目构建，提供轻量级、易于部署的监控解决方案。

核心功能和特性

• 指标收集：收集 Postfix 邮件服务器的关键运行指标，包括邮件队列状态、邮件处理数量、发送成功率等
• Prometheus 兼容：暴露符合 Prometheus 格式的指标接口，支持 Prometheus 直接抓取
• 轻量级部署：基于 Docker 容器化部署，配置简单，资源占用低
• 实时监控：通过读取 Postfix 的 showq 文件（队列状态文件）实时获取数据

使用场景和适用范围

• Postfix 服务器监控：适用于所有运行 Postfix 邮件服务器的环境，需监控邮件队列长度、发送状态、错误率等指标
• DevOps 监控体系：集成到 Prometheus + Grafana 监控体系，实现邮件服务状态可视化和告警
• 系统运维：帮助管理员及时发现邮件发送延迟、队列堆积、配置错误等问题

使用方法和配置说明

前置条件

• 已安装 Docker 环境
• Postfix 服务器已运行，且 showq 文件默认路径为 /var/spool/postfix/public/showq

Docker 运行命令

bash
docker run -v /var/spool/postfix/public/showq:/var/spool/postfix/public/showq:r -p 9154:9154 chatwork/kumina-postfix-exporter

参数说明

• -v /var/spool/postfix/public/showq:/var/spool/postfix/public/showq:r：挂载 Postfix 的 showq 文件到容器内，只读权限（r），Exporter 通过该文件获取队列信息
• -p 9154:9154：将容器的 9154 端口（默认监听端口）映射到主机，Prometheus 通过此端口抓取指标

验证指标

容器启动后，访问 http://<主机IP>:9154/metrics 可查看导出的 Prometheus 指标，示例：

postfix_queue_length{queue="active"} 0
postfix_queue_length{queue="deferred"} 5
postfix_queue_length{queue="incoming"} 2

集成 Prometheus

在 Prometheus 配置文件（prometheus.yml）中添加抓取配置：

yaml
scrape_configs:
  - job_name: 'postfix'
    static_configs:
      - targets: ['<postfix-exporter-IP>:9154']

重启 Prometheus 后即可开始收集 Postfix 指标。