Load balancing HAProxy : deux entrées pour un homelab

Le load balancing HAProxy d’un homelab place deux entrées publiques actives devant vos services auto-hébergés : un répartiteur DNS choisit l’entrée, puis HAProxy choisit, application par application, le chemin vers l’origine. Si une entrée tombe, l’autre sert le trafic, à condition d’avoir provoqué la panne pour le vérifier.
Une entrée unique, un point de défaillance unique
Beaucoup de homelabs exposés suivent le même plan : un petit VPS reçoit le trafic public et le relaie vers la maison par un tunnel chiffré, sans port ouvert sur la connexion du domicile. Le montage est propre, mais ce VPS devient le point de défaillance de chaque service publié. Il concentre en général :
- la terminaison TLS et le renouvellement des certificats ;
- le filtrage des robots et les restrictions d’accès ;
- le routage vers chaque application, chez vous ou ailleurs ;
- parfois les applications elles-mêmes, installées à côté du proxy.
Un redémarrage pour un noyau neuf ou un incident chez l’hébergeur, et tout disparaît d’un coup. Le tunnel n’est pas en cause, c’est la position unique de la machine : un certificat mal renouvelé ou une règle de filtrage trop stricte produisent le même effet qu’une panne matérielle, faute de second chemin vers vos services.
Deux notions se croisent ici. La répartition de charge (load balancing) distribue les visiteurs entre plusieurs entrées actives. La bascule (failover) retire une entrée malade et envoie le trafic vers celle qui répond. Deux entrées actives font les deux, si chaque composant sait dire qu’il va bien.
Load balancing HAProxy : l’entrée d’abord, le chemin ensuite
Le piège consiste à parler de bascule comme d’un mécanisme unique. Suivez plutôt une requête de bout en bout. Le répartiteur DNS, ici Cloudflare Load Balancing, désigne au visiteur l’une des deux entrées. Sur cette entrée, HAProxy termine le TLS, applique les restrictions d’accès et confie la requête au filtrage anti-robots de l’application, qui la transmet à l’origine par le réseau privé, via Nginx Proxy Manager pour les services restés au domicile. Deux décisions se suivent donc, prises par deux composants qui ne se consultent pas : le choix de l’entrée, puis le choix du chemin, application par application.
Côté répartiteur, l’auteur range les deux entrées dans un pool partagé, à poids égaux, en répartition aléatoire (Random steering). D’après la documentation de Cloudflare, ce mode sert aux montages actif-actif, et des poids en règlent la proportion. L’affinité de session garde ensuite un navigateur sur l’entrée choisie : elle repose sur un cookie __cflb, n’existe pas en mode DNS seul et désigne une nouvelle cible quand celle du cookie devient malade.
Si vous comptez rendre votre propre entrée redondante, le retour d’expérience publié sur Spleenftw’s blog mérite une lecture attentive, parce qu’il va bien plus loin qu’un schéma. Dans ce récit en anglais, un ingénieur réseau français raconte le load balancing de son homelab : il sépare nettement les deux décisions, expose la logique de ses contrôles de santé à chaque niveau, puis coupe volontairement un conteneur Anubis, ensuite un HAProxy, et regarde la bascule se produire, graphes de trafic à l’appui. Le texte reste chiffré et honnête sur ce que la redondance couvre réellement.
Cette séparation change la lecture d’un incident. Quand un seul conteneur tombe, rien ne justifie de déplacer toute l’entrée : les autres applications gardent leur chemin local, seule celle qui souffre emprunte la passerelle privée.
Le moniteur commun de l’auteur vérifie l’entrée HTTPS publique sur une route de santé dédiée, toutes les soixante secondes, certificat vérifié : il juge l’entrée, HAProxy juge le reste.
HAProxy : le chemin local, puis la passerelle du voisin
Sur chaque entrée, le backend d’une application déclare le filtrage local, puis la passerelle du voisin (jetons à remplacer) :
backend be_wiki
balance roundrobin
cookie CHEMIN insert indirect nocache
option httpchk GET /sante
server local ANUBIS_LOCAL:PORT_LOCAL check cookie local
server voisin PASSERELLE_PAIR:PORT_PAIR check cookie voisin backup
Selon la documentation de HAProxy, un serveur marqué backup ne reçoit du trafic que lorsque tous les serveurs ordinaires sont indisponibles, mais une requête portant un cookie de persistance vers lui reste servie. D’où une observation de l’auteur : une session passée chez le voisin peut y rester après le retour du chemin local. Le manuel fixe aussi les valeurs par défaut du contrôle de santé : un essai toutes les 2 000 ms (inter), trois échecs pour sortir un serveur (fall), deux succès pour le réintégrer (rise).
La passerelle ne connaît qu’une destination, le filtrage de sa propre machine : elle ne renvoie jamais la requête, donc aucun ping-pong entre les deux entrées.

Rejoindre les origines par un réseau maillé, sans port ouvert chez vous
Vérifiez d’abord chaque écoute : l’auteur cite une application qui n’écoutait que sur l’interface de bouclage, invisible depuis une entrée distante.
Pour le transport, un réseau privé maillé évite d’exposer le domicile. D’après la documentation de Tailscale, un routeur de sous-réseau annonce ses routes, celles-ci doivent être approuvées, et un poste Linux ne les utilise qu’avec l’option --accept-routes. Headscale se présente dans son dépôt comme une implémentation libre et auto-hébergée du serveur de contrôle de Tailscale, sans lien avec l’éditeur. Les bases du tunnel chiffré sont posées dans le fonctionnement d’un VPN expliqué pas à pas.
tailscale set --advertise-routes=SOUS_RESEAU_PRIVE
tailscale up --login-server=CONTROLE_URL --advertise-tags=tag:entree --accept-routes
La première ligne vise le routeur du domicile, la seconde chaque entrée. Chez l’auteur, le pare-feu du domicile n’ouvre aux entrées que le HTTPS vers Nginx Proxy Manager, jamais le réseau local entier.
Chaque entrée renouvelle seule son certificat par défi DNS-01, un crochet restaurant l’ancien en cas d’échec. Semaphore déploie les deux machines depuis Git, l’une après l’autre, par SSH : un accès à traiter avec un serveur SSH durci.

Le défi anti-robots face aux clients qui ne sont pas des navigateurs
Anubis s’intercale entre HAProxy et chaque application pour soumettre les navigateurs à une preuve de travail. Sa documentation décrit des règles par requête : ALLOW laisse passer, DENY refuse, CHALLENGE impose le défi, WEIGH ajuste un poids de suspicion.
Le problème ? Un lecteur vidéo, une application mobile ou un client d’API ne résout aucun défi. L’auteur règle donc les politiques par usage : défi sur l’interface web, passage libre ailleurs, l’authentification restant celle de l’application. Chaque instance tourne dans son propre conteneur Docker, ce qui facilite l’arrêt ciblé d’un seul filtrage.
Pour la vidéo, il retient un répartiteur en mode DNS seul, hors du proxy de Cloudflare. La documentation de Cloudflare prévient qu’un client qui garde une réponse en cache retourne alors à son ancienne destination. Un flux ouvert ne migre donc jamais d’une entrée à l’autre, et le vhost média doit accepter les clients directs.
Provoquer la panne plutôt que la supposer
Avant tout changement DNS, joignez une entrée précise avec le vrai nom et le vrai certificat, puis provoquez la panne :
curl -sI --resolve app.example.net:443:ADRESSE_EDGE_A https://app.example.net/
docker stop anubis-wiki
docker start anubis-wiki
Un code 200 peut n’être que la page du défi : l’auteur valide donc des connexions réelles et la lecture vidéo. Premier essai, l’arrêt du conteneur Anubis d’une application sur une entrée : les requêtes prennent la passerelle du voisin. Second essai, l’arrêt de HAProxy : Cloudflare constate la panne et l’autre entrée sert l’application.
Ne déduisez pas un temps de bascule des intervalles : plusieurs contrôles aux rythmes différents s’empilent. Les graphes de l’auteur montrent aussi un trafic inégal malgré des poids égaux, sessions de tailles variables et cache obligent.
Le tableau suivant reprend les cas décrits par l’auteur et par la documentation citée :
| Panne provoquée | Chemin emprunté par la requête | Ce que voit le visiteur |
|---|---|---|
| Une entrée arrêtée (HAProxy coupé sur edge-a) | Cloudflare retire edge-a, les requêtes passent par edge-b | L’application répond depuis l’autre entrée |
| Le conteneur anti-bots d’une application arrêté sur edge-a | edge-a, passerelle privée de edge-b, filtrage de edge-b, origine | L’application reste servie, les autres gardent leur chemin local |
| L’origine d’une application arrêtée | Aucun chemin sain, les deux entrées partagent cette origine | Cette application est indisponible, les autres continuent |
| La connexion du domicile coupée | Les chemins privés vers le domicile tombent ensemble | Les services hébergés à la maison deviennent injoignables |
| Un flux vidéo déjà ouvert | La connexion reste liée à l’entrée tombée | Coupure, puis reprise après reconnexion du client |

Ce que deux entrées couvrent, et ce qu’elles laissent de côté
Deux entrées protègent l’exposition, pas les applications. Une instance d’application en panne l’est pour les deux entrées ; une coupure de la connexion du domicile ou de Nginx Proxy Manager fait tomber plusieurs chemins privés d’un coup. L’auteur ajoute que ses deux VPS sont chez le même hébergeur, OVH, et que les entrées proxifiées dépendent de Cloudflare. Les maintenances de l’entrée ne coupent plus rien pour autant ; répliquer les applications relève d’un autre projet de haute disponibilité.
Spleenftw’s blog, le carnet de bord d’un ingénieur réseau
Spleenftw’s blog est le blog personnel, rédigé en anglais, d’un ingénieur réseau français qui signe spleenftw et documente son homelab au fil des projets. L’article sur la répartition de charge, publié le 1er novembre 2026, ouvre une série en deux parties ; la seconde, publiée le 11 novembre 2026, traite de l’exploitation : exceptions du pare-feu applicatif, maintenance et certificats. La série WIMH fait l’inventaire du laboratoire ; d’autres billets traitent d’un cluster Proxmox avec stockage Linstor, de la défense contre les robots d’aspiration ou d’une chasse aux rootkits avec rkhunter. Pour qui prépare deux entrées publiques, ce carnet offre le récit d’un montage réel, pannes provoquées comprises.
Votre feuille de route avant la seconde entrée
Prochaine étape, dans cet ordre :
- rendre chaque origine joignable depuis le réseau privé ;
- joindre les entrées au réseau maillé, routes approuvées ;
- écrire, par application, un chemin local et une passerelle privée en
backup; - tester chaque entrée en résolution forcée, connexions réelles comprises ;
- arrêter un filtrage, puis un HAProxy, et noter ce que voit un visiteur.
Le basculement automatique ne vaut que ce que valent ces essais.
Load balancing d’un homelab : vos questions
Quelle différence entre load balancing et failover ?
Le load balancing répartit les visiteurs entre plusieurs entrées ou serveurs actifs en même temps, selon un algorithme et des poids. Le failover, ou bascule, consiste à retirer un élément défaillant et à envoyer son trafic vers un élément sain. Dans un montage à deux entrées actives, les deux se combinent : le répartiteur partage le trafic tant que tout va bien, puis les contrôles de santé écartent l’entrée malade dès qu’ils la détectent.
Pourquoi placer deux entrées devant un homelab ?
Une entrée unique concentre la terminaison TLS, le filtrage des robots et le routage vers chaque service : sa panne ou sa maintenance coupe tout ce qui est publié. Deux entrées actives, dans deux emplacements différents, laissent l’une servir pendant que l’autre redémarre, reçoit une mise à jour ou subit un incident. Le gain porte sur l’exposition : les applications et la connexion du domicile, elles, restent des éléments communs aux deux chemins.
Comment tester la bascule d’une entrée HAProxy ?
Commencez par joindre chaque entrée en forçant la résolution localement, avec le vrai nom et le vrai certificat, puis validez des usages réels et pas seulement un code de réponse. Arrêtez ensuite le filtrage d’une application sur une entrée, puis HAProxy lui-même, et observez le chemin pris par les requêtes avant de tout redémarrer. Spleenftw’s blog décrit cette séquence pas à pas, avec les graphes de trafic relevés pendant les essais.
Comment fonctionne le load balancing dans HAProxy ?
HAProxy reçoit les connexions dans une section frontend, puis les transmet à un backend qui liste plusieurs serveurs. Un algorithme choisit le serveur, par exemple roundrobin, qui les sert à tour de rôle selon leur poids. Les contrôles de santé actifs retirent un serveur qui échoue et le réintègrent après plusieurs succès. Un serveur déclaré backup ne reçoit du trafic que si tous les serveurs ordinaires sont indisponibles, ce qui en fait une passerelle de secours.