camptocamp/pushprox

PushProx

PushProx是一个客户端与代理组合工具，支持Prometheus穿越NAT等网络拓扑执行监控数据抓取，同时保持拉取模型的核心特性。尽管实践中已具备稳定性，但仍在持续迭代优化。

核心功能

• 突破NAT/防火墙限制，实现Prometheus对无法直接访问目标的监控
• 遵循Prometheus原生拉取模型，无需修改现有监控逻辑
• 提供客户端注册与服务发现能力，支持动态获取目标列表
• 可通过反向代理扩展认证与授权机制

使用场景

适用于监控处于NAT网络、防火墙后或跨区域分布式集群的目标机器，例如企业分支机构服务器、云环境中隔离网络的实例等场景。

配置说明

构建客户端与代理

bash
go get github.com/robustperception/pushprox/{client,proxy}
cd ${GOPATH-$HOME/go}/src/github.com/robustperception/pushprox/client && go build
cd ${GOPATH-$HOME/go}/src/github.com/robustperception/pushprox/proxy && go build

部署代理

将代理部署在Prometheus与客户端均可访问的节点：

bash
./proxy

运行客户端

在目标机器上启动客户端并指向代理地址：

bash
./client --proxy-url=http://proxy:8080/

Prometheus配置示例

yaml
scrape_configs:
- job_name: node
  proxy_url: http://proxy:8080/
  static_configs:
    - targets: ['client:9100']  # 替换为客户端实际FQDN
  # 若需HTTPS抓取目标，添加以下参数
  params:
    _scheme: [https]

服务发现

代理的/clients端点返回注册客户端列表（符合file_sd_configs格式），可通过定时任务下载并用于Prometheus动态发现：

bash
wget http://proxy:8080/clients -O /path/to/clients.json

工作原理

1. 客户端向代理轮询抓取请求并携带自身FQDN
2. Prometheus通过代理发起对目标FQDN的抓取
3. 代理将请求路由至对应客户端
4. 客户端执行抓取并将结果回传代理
5. 代理将结果返回Prometheus完成监控流程

安全提示

当前版本无内置认证授权，建议在代理前部署反向代理（如Nginx）添加身份验证；运行客户端可能暴露主机网络服务，需严格控制访问权限。