amimof/node-cert-exporter

node-cert-exporter

https://github.com/amimof/node-cert-exporter/actions/workflows/go.yaml/badge.svg](https://github.com/amimof/node-cert-exporter/actions/workflows/go.yaml) ![Go Report Card]([] ![huego]([]

镜像概述

node-cert-exporter是用Go语言编写的Prometheus导出器，用于解析指定目录下的x509 SSL证书，递归扫描证书文件并将其过期时间等信息暴露为Prometheus可采集的指标（路径为/metrics）。该工具支持在Docker、Kubernetes（Deployment/DaemonSet）等环境运行，帮助用户监控证书有效期，避免服务因证书过期中断。

核心功能

1. 递归扫描指定目录的SSL证书（支持glob模式匹配）
2. 暴露证书过期时间、剩余天数等Prometheus指标
3. 支持Docker、Kubernetes、Helm等多种部署方式
4. 可与Grafana集成，通过仪表盘可视化证书状态

使用场景

• Kubernetes集群证书（集群证书、应用服务证书）过期监控
• 服务器端SSL证书（网站HTTPS证书）有效期预警
• 内部服务间通信证书状态跟踪

配置说明

主要通过命令行参数配置：

• --include-glob: 指定扫描的证书文件路径（如/etc/ssl/*/*.pem）
• --logtostderr: 开启日志输出到标准错误流

部署示例

Kubernetes DaemonSet

监控集群所有节点的证书：

bash
kubectl apply -f https://raw.githubusercontent.com/amimof/node-cert-exporter/master/deploy/daemonset.yml

Docker

指定扫描目录运行：

bash
docker run -p 9117:9117 amimof/node-cert-exporter --logtostderr=true --include-glob /etc/ssl/*/*.pem

Helm

快速部署：

bash
helm repo add node-cert-exporter https://amimof.github.io/node-cert-exporter
helm repo update
helm install node-cert-exporter node-cert-exporter/node-cert-exporter

二进制运行

直接下载二进制文件：

bash
curl -LOs https://github.com/amimof/node-cert-exporter/releases/latest/download/node-cert-exporter-linux-amd64 && chmod +x node-cert-exporter-linux-amd64
./node-cert-exporter-linux-amd64 --include-glob /etc/ssl/*/*.pem

Grafana仪表盘

Prometheus采集指标后，可使用官方Node Cert Exporter仪表盘可视化证书状态。

贡献

项目处于Beta阶段，欢迎通过Issue反馈问题或Pull Request参与开发。