promhippie/prometheus-hetzner-sd

Prometheus Hetzner SD 镜像文档

镜像概述和主要用途

Prometheus Hetzner SD 是一个服务程序，能够自动发现 Hetzner 账户中的节点资源，并以 Prometheus 服务发现（SD）兼容的格式提供节点信息。该服务旨在简化 Prometheus 对 Hetzner 环境中节点的监控配置，实现节点的自动发现与监控覆盖。

核心功能和特性

• 自动节点发现：实时探测 Hetzner 账户中的节点资源，无需手动配置节点列表
• Prometheus 兼容格式：输出数据符合 Prometheus 服务发现规范，可直接被 Prometheus 集成
• 多部署方式支持：提供容器化部署选项，镜像发布于 GHCR、Docker Hub 和 Quay 等主流容器仓库
• 跨平台兼容：支持多种操作系统和架构，可通过二进制、DEB/RPM 包或容器形式部署

使用场景和适用范围

适用于使用 Hetzner 云服务（如 Hetzner Cloud、 dedi 服务器等）并通过 Prometheus 进行监控的用户场景，特别适合需要动态监控 Hetzner 账户中节点变化的环境，例如：

• 自动发现新添加的 Hetzner 节点并纳入监控
• 移除已删除/下线的 Hetzner 节点，避免监控告警误报
• 简化大规模 Hetzner 节点环境下的 Prometheus 配置管理

使用方法和配置说明

镜像获取

该镜像已发布于多个容器仓库，可通过以下地址拉取：

• Docker Hub: promhippie/prometheus-hetzner-sd
• GHCR: ghcr.io/promhippie/prometheus-hetzner-sd
• Quay: quay.io/promhippie/prometheus-hetzner-sd

Docker 运行示例

基本运行命令（需替换 HETZNER_API_TOKEN 为实际 Hetzner API 令牌）：

bash
docker run -d \
  --name prometheus-hetzner-sd \
  -p 9000:9000 \
  -e HETZNER_API_TOKEN="your-hetzner-api-token" \
  promhippie/prometheus-hetzner-sd

服务启动后，可通过 http://localhost:9000 访问 Prometheus 服务发现格式的节点信息。

环境变量配置

Docker Compose 示例

创建 docker-compose.yml 文件：

yaml
version: "3.8"

services:
  prometheus-hetzner-sd:
    image: promhippie/prometheus-hetzner-sd:latest
    container_name: prometheus-hetzner-sd
    restart: unless-stopped
    ports:
      - "9000:9000"
    environment:
      - HETZNER_API_TOKEN=your-hetzner-api-token
      - LOG_LEVEL=info
      - REFRESH_INTERVAL=60
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

启动服务：

bash
docker-compose up -d

集成 Prometheus

在 Prometheus 配置文件中添加以下服务发现配置，即可自动发现 Hetzner 节点：

yaml
scrape_configs:
  - job_name: 'hetzner-nodes'
    http_sd_configs:
      - url: 'http://prometheus-hetzner-sd:9000/sd'

重启 Prometheus 后，即可开始监控通过 Hetzner SD 发现的节点。