Documentation du service cf_proxy_ping_aggregator

🧠 Description

cf_proxy_ping_aggregator est un service HTTP léger conçu pour fonctionner sous Linux sans dépendances externes. Il agit comme un proxy intelligent qui reçoit des requêtes HTTP, les rejoue vers une liste de services locaux, agrège les réponses, et renvoie une réponse consolidée selon des règles spécifiques.

La réponse consolidée est le résultat de l'aggrégation des services sous jacents.

Son but initial est de permettre de monitorer l'ensemble des services se trouvant derrière le point de terminaison d'un load balancer Cloudflare. Le tout avec un seul service de moniteur Cloudflared.

---

⚙️ Fonctionnement

1. Écoute HTTP sur un port défini via --port
2. Rejeu de la requête vers une liste de ports locaux définis via --lport
3. Agrégation des réponses :
   • Si toutes les réponses ont un statut HTTP 200 et un corps égal à pong, la première réponse est utilisée. Les détails de l’agrégation sont affichés dans la sortie standard
   • Sinon, la première réponse parmi celles en erreur est utilisée (statut ≠ 200 ou corps ≠ pong). Les logs sont redirigés vers la sortie d’erreur (stderr) pour faciliter le diagnostic.
4. Réponse au client initial avec le statut et le corp déterminé.

---

🚀 Utilisation

Lancer le service :

python3 cf_proxy_ping_aggregator.py --port 5000 --lport 3001 --lport 3002 --lport 3000

Réponse positive

127.0.0.1 - - [29/Oct/2025 14:56:59] "GET /ping HTTP/1.1" 200
  - Port 3000 → Status: 200, Body: pong.., Temps: 0.008s
  - Port 3001 → Status: 200, Body: pong.., Temps: 0.012s

Réponse négative

127.0.0.1 - - [29/Oct/2025 14:56:59] "GET /ping HTTP/1.1" 500
  - Port 3000 → Status: 200, Body: pong.., Temps: 0.008s
  - Port 3001 → Status: 413, Body: error.., Temps: 0.012s

Modifier les listen ports

Pour modifier les ports des services à écouter. Modifier le fichier de configuration du service systemd après installation et avant le démarrage.

vim /lib/system/system32/cf_proxy_ping_aggregator.service

# Si le service a déjà été démarré, relancé le daemon systemctl
sudo systemctl daemon-reload
sudo systemctl restart cf_proxy_ping_aggregator.service

Usage Linux

Fonctionne avec systemd

Construction du package debian

Générer un package debian

dpkg --build cf_proxy_ping_aggregator

Installation

sudo dkpg -i cf_proxy_ping_aggregator.deb
sudo systemctl start cf_proxy_ping_aggregator.service
sudo systemctl status cf_proxy_ping_aggregator.service
journalctl -u cf_proxy_ping_aggregator.service -n 10

Désinstallation

sudo dpkg -r cf_proxy_ping_aggregator