EN

Le homelab de Harouna · octobre 2026

Deux planètes,
un tunnel,
vingt-trois agents.

Ce que Harouna a construit à la maison, comment, et comment chaque pièce se branche aux autres. Fais tourner la carte, clique sur un astre.

La vue 3D demande WebGL. Le reste de l'atlas fonctionne sans.

Dossier technique · le homelab de Harouna Soumare

Un centre de calcul à la maison, géré comme en entreprise, avec vingt-trois agents d'IA

Deux machines reliées par un tunnel chiffré portent tout : un petit serveur loué, qui reçoit Internet, et une machine virtuelle dans le PC de la maison, qui fait le travail. Git décrit chaque pièce, une identité sans mot de passe garde chaque porte, et un coffre européen reçoit une copie chiffrée de tout, chaque nuit. Par-dessus, une assistante et vingt-deux agents, rangés en trois équipes, travaillent pour la famille, sans jamais tenir les clés.

01Pourquoi construire ça

L'idée : avoir chez soi un vrai petit centre de calcul, aussi sérieux qu'un service professionnel, pour la famille, le travail et des agents d'IA, sans payer une infrastructure d'entreprise ni confier ses données à des tiers.

Ce que ce n'est pas

Ce n'est pas un cloud : si le PC de la maison s'éteint, les applications s'arrêtent. Une sonde extérieure prévient alors sur le téléphone en quelques minutes, et aucune donnée n'est perdue.

02Deux machines

Un cluster Kubernetes léger (k3s) de deux nœuds, reliés par un tunnel WireGuard.

MachineOùRôle
jijiserveur loué en FranceEntrée publique, plan de contrôle du réseau privé, courrier, alertes, cerveau du cluster
totoroVM dans le PC de la maisonSalle des machines : bases, applications, agents

03Ce qui tourne

Une vingtaine de services. Quelques-uns sont accessibles depuis Internet derrière la porte d'identité ; les autres n'existent que dans le réseau privé. Clique sur une carte.

Partie I

Les chemins du réseau

04Le chemin d'une visite

Quand un membre de la famille ouvre une application, sa requête traverse quatre zones. Le point clé : l'entrée publique ne déchiffre rien. Elle lit seulement le nom demandé et pousse le flux chiffré vers la salle des machines, qui seule tient le certificat.

TLS JAMAIS DÉCHIFFRÉ ICI nom → IP HTTPS · port 443 SNI → tunnel NetBird (wt0) Host → porte session OK sans session jeton + groupes VISITEURNavigateurtéléphone, PC, tablette DNSFournisseur DNSnom → entrée publique PORTE PUBLIQUE · 443Traefik de jijipassthrough selon SNI ENTRÉE DU CLUSTERTraefik de totorocertificat Let's Encrypt OAUTH2-PROXYPorte de connexioncookie, groupes APPLICATIONPages, Budget…servie à la famille FOURNISSEUR D'IDENTITÉPocket IDclé d'accès (passkey) OIDC NATIF, SANS PORTE : photos, forge Git, mesures, administration du cluster 01 / INTERNET02 / JIJI · SERVEUR LOUÉ03 / TOTORO · VM DANS LE PC DE LA MAISON04 / IDENTITÉ · ZONE NON CONTOURNABLE
Une visite publique. En trait plein, le chemin de chaque requête ; en pointillés roses, le détour par Pocket ID quand la porte ne reconnaît pas de session. Le point lumineux suit un paquet. Clique sur un bloc pour son détail.
humains et identité plateforme IA et agents données et sauvegardes réseau et services externes chemin normal apport humain, détour

Astuce : survole un bloc pour éclairer ses liens, clique pour son détail.

Une liste blanche sur l'entrée publique nomme les seules applications joignables depuis Internet. Un nom absent de la liste n'atteint jamais la maison.

05Le réseau privé

NetBird crée un réseau WireGuard maillé. Son plan de contrôle distribue les clés et la liste des pairs autorisés ; le trafic, lui, va directement d'un appareil à l'autre, chiffré. Les consoles d'administration n'ont d'adresse que dans ce réseau.

AUCUN PORT PUBLIC LES SERVICES PRIVÉS N'ONT D'ADRESSE QUE DANS LE TUNNEL CHIFFRÉ enrôlement connexion SSO WireGuard pair à pair · wt0 si le pair à pair échoue relayé, toujours chiffré nom → service CLIENT NETBIRDTes appareilsPC, téléphone GESTIONServeur NetBirdpairs, groupes, règles RELAIS · STUNRelais NetBirdsi le direct échoue UNE FOIS PAR APPAREILConnexion SSOdans le navigateur CERTIFICAT JOKERTraefik de totoronoms privés SERVICE PRIVÉGrafana, Forgejo…mesures, état, consoles 01 / TES APPAREILS02 / JIJI · PLAN DE CONTRÔLE DU RÉSEAU03 / IDENTITÉ04 / TOTORO
L'accès privé. Le plan de contrôle de jiji ne voit pas passer les données : il distribue les clés et la liste des pairs. En pointillés gris, le relais de secours, utilisé seulement quand deux appareils ne peuvent pas se joindre directement.

Un piège classique, évité

Quand le réseau du cluster passe dans un tunnel VPN, les marques que le VPN pose sur les paquets peuvent être lues par le pare-feu de Kubernetes comme « déjà autorisé ». Une règle sur chaque nœud efface cette marque : les cloisons entre applications tiennent vraiment.

06Une identité sans mot de passe

Pocket ID est le fournisseur d'identité de la maison. Il n'a pas de mot de passe : on se connecte avec une clé d'accès (passkey) liée au téléphone ou au PC. Chaque application est un client OpenID Connect, réservé à des groupes. Celles qui ne savent pas parler OpenID Connect sont protégées par une porte (oauth2-proxy). Même l'administration du cluster passe par cette identité : aucun certificat d'administrateur ne traîne sur un poste.

07GitOps : Git est la seule porte

Personne ne modifie le cluster à la main. Une idée devient une branche, puis une demande d'ajout dans la forge Git. Un contrôle cherche les secrets oubliés et vérifie que tout secret est chiffré. L'humain relit et fusionne. Flux voit la nouvelle version et l'applique.

GIT EST LA SEULE PORTE push d'une branche relecture fusion lu par Flux manifestes applique image publiée au registre Flux écrit le nouveau tag dans main AGENT · OU HAROUNAGimlibranche + demande SEUL À FUSIONNERHarounarelit, approuve DEMANDE D'AJOUTForgejocontrôle des fuites BRANCHE PROTÉGÉEmainla vérité du cluster FORGEJO ACTIONSRunnerconstruit les images SOURCE-CONTROLLERFluxrelit main en continu KUSTOMIZE-CONTROLLERkustomize + SOPSdéchiffre avec age RÉSULTATCluster à jourétat réel = Git 01 / QUI PROPOSE, QUI DÉCIDE02 / FORGEJO · FORGE GIT03 / FLUX ET PIPELINE04 / CLUSTER k3s
Une modification de bout en bout. En vert, la proposition d'un agent ; en rose pointillé, la décision humaine, qu'aucun compte ne peut contourner (la règle vaut aussi pour les administrateurs, sauf fusion forcée assumée) ; en gris pointillé, la boucle automatique des images.
RègleEffet
Aucun secret en clairchaque secret est chiffré (SOPS + age) avant d'entrer dans Git
Retirer ne supprime rienune base ne disparaît jamais parce qu'un fichier a bougé
Rien sans preuvechaque changement se vérifie sur le service réel

Partie II

Les agents

08La constellation des agents

Eleonore est la seule interlocutrice de Harouna. Sous elle, trois équipes cloisonnées (maison, travail, business), chacune avec son tableau de tâches, ses accès aux modèles, sa collection de connaissances et son espace de publication. Chaque équipe a un évaluateur qui contrôle les livrables avant qu'ils n'arrivent à l'humain.

Vingt-trois agents, trois cieux. Les liens partent d'Eleonore vers chaque équipe ; les anneaux marquent les évaluateurs. Clique sur un agent pour sa mission.

Ce que les agents ne peuvent pas faire

Aucun agent n'a de clé d'administration. Ceux qui lisent l'infrastructure ne voient pas les secrets. L'ingénieur plateforme propose ses changements ; seul l'humain les fusionne. L'analyste des marchés ne passe jamais d'ordre. Le chercheur en sources ouvertes du travail ne regarde que des informations professionnelles publiques.

09Le chemin d'une demande

Un message à Eleonore traverse cinq étages avant de revenir sous forme de page publiée et de notification.

un message délègue assignée appel de modèle modèle choisi réponse livrable tampon TRAVAIL, BUSINESS : JAMAIS GEMINI garde du routeur + clés OmniRoute MATRIX · CHIFFRÉHarounaécrit à Eleonore CHEFFE D'ÉQUIPEEleonorecomprend, délègue TÂCHEMulticaMaison, Travail, Business AGENTAgent de l'équipeYoda, Sam, Gimli… GARDERouteurintention, quotas PASSERELLEOmniRoutetes abonnements ÉVALUATEURObi-Wan, L…valide ou renvoie LIVRÉPage publiéeet avis dans Matrix 01 / HAROUNA · MATRIX02 / ELEONORE · HERMES + MÉMOIRE HONCHO03 / ÉQUIPES · MULTICA04 / MODÈLES · ROUTEUR → OMNIROUTE05 / CONTRÔLE ET LIVRAISON
Une demande, cinq étages. En vert, le travail des agents ; en bleu, l'appel de modèle et sa réponse (pointillés gris) ; en rose, ce qui relève d'un humain ou d'un évaluateur. Un livrable refusé repart vers l'agent avec des corrections précises.

10Modèles et confidentialité

Les agents n'appellent jamais un modèle directement. Ils parlent à un routeur écrit pour l'occasion, puis à une passerelle qui porte les abonnements de Harouna : Claude d'abord, ChatGPT ensuite, Gemini en dernier recours. Le routeur devine l'intention (code, résumé, analyse, conversation), regarde les quotas restants et choisit le modèle.

La garde ne se désactive pas

Avant tout envoi, le routeur vérifie qu'un contenu confidentiel ne part que vers un modèle couvert par un abonnement sous contrat. Les espaces travail et business sont toujours traités comme confidentiels.

11Mémoire et connaissances

Deux mémoires. Une mémoire longue retient ce qu'Eleonore apprend au fil des conversations. Une base de connaissances range par le sens les documents déposés dans la Bibliothèque : en moins de deux minutes, un nouveau document est découpé, vectorisé à la maison et devient cherchable par l'équipe concernée. Les leçons des évaluateurs y vivent aussi, et chaque agent les relit avant de travailler.

Partie III

Durer

12Sauvegarder et prouver

Tout part chiffré vers un seul coffre européen : les bases en continu, les fichiers chaque nuit, l'état du cluster plusieurs fois par jour. Et surtout, des exercices restaurent régulièrement ces copies pour vérifier qu'elles marchent.

CHIFFRÉ AVANT DE SORTIR WAL fichiers journaux en continu, copie complète chaque nuit fichiers chiffrés état du cluster, réseau, courrier restaure, compare, vérifie BASES ET FICHIERS : exercice chaque mois RÉSEAU ET COURRIER : exercice chaque semaine contrôle d'intégrité chaque semaine 2 INSTANCES CHACUNE5 basesforge, tâches, savoir… PLUGIN CNPGBarman CloudWAL + complète VOLUMES PERSISTANTSVolumesMatrix, Pages, Immich… k8up · RESTICSauvegarde nuitchaque nuit SUR JIJIetcd · NetBird · mailcluster, réseau, courrier k3s · RESTICInstantanésplusieurs fois par jour COFFRE UNIQUE · UECoffre chiffréstockage en Europe AUTOMATIQUESExercicesrestaurer pour de vrai 01 / BASES POSTGRESQL · CLOUDNATIVEPG02 / VOLUMES · k8up03 / JIJI · HORS DU CLUSTER04 / EXERCICES DE RESTAURATION
Un seul coffre, trois chemins. En orange, les copies qui partent chaque nuit ; en gris pointillé, les exercices qui les reprennent pour vérifier qu'elles se restaurent vraiment.

Pourquoi les exercices

Un test de restauration a montré qu'un outil de sauvegarde lancé sous le mauvais utilisateur sautait en silence les fichiers illisibles, puis annonçait un succès. Une sauvegarde qu'on n'a jamais restaurée n'est qu'une hypothèse.

13Les principes de sécurité

Un agent de sécurité audite le parc chaque jour ; un second trie ses constats et prépare les corrections, que l'humain accepte ou non.

14Ce que les pannes ont appris

PanneLeçon
La VM perd le réseauUn réseau virtuel par défaut peut changer d'adresses sans prévenir : la VM a désormais son propre réseau, à adresse fixe.
Gros fichiers refusésUn relais qui lit tout en mémoire tombe sur un gros fichier : il transmet maintenant par petits morceaux.
Faux quota à zéroUne mesure qu'on ne sait pas lire n'est pas un zéro : elle est écartée.
Sauvegarde « réussie » incomplèteOn ne croit une sauvegarde qu'après l'avoir restaurée.

15La boîte à outils

DomaineOutils
Clusterk3s, Traefik, cert-manager, CloudNativePG
GitOpsForgejo, Forgejo Actions, Flux, SOPS + age, gitleaks
Réseau et identitéNetBird (WireGuard), Pocket ID (passkeys), oauth2-proxy
ApplicationsMatrix, Multica, Immich, une application de budget maison, un portail de publication
IAHermes, Claude Code, un routeur de modèles maison, OmniRoute, Honcho, pgvector, Text Embeddings Inference
DurerBarman Cloud, k8up + restic, Prometheus, Grafana, Gatus, ntfy