Mon serveur personnel : un Raspberry Pi 5 installé dans mon appartement étudiant. Il fait tourner ma domotique, mes photos, un DNS filtrant pour tout l'appartement, de la supervision et des sauvegardes, avec un accès à distance sans aucun port ouvert sur Internet.
Je suis étudiant en informatique et je m'intéresse aux serveurs et à la domotique depuis longtemps. Le réseau, l'administration système et la sécurité ne font pas partie de mes cours, je les apprends avec ce projet. Le homelab actuel est le résultat de plusieurs années de travail et d'apprentissage, avec beaucoup de bugs en route. J'ai utilisé l'IA pour avancer plus vite et apprendre en autodidacte (voir docs/methode.md).
L'appartement est dans une résidence étudiante. Internet arrive par le Wi-Fi de la résidence, partagé avec les autres résidents et protégé par un portail captif qui coupe la connexion quand la session expire. Je n'ai la main ni sur la box ni sur le pare-feu, donc impossible d'ouvrir un port. Tout tourne sur un seul Raspberry Pi, et je voulais un système capable de tenir longtemps sans que j'aie à le surveiller tous les jours. Plus de détails dans docs/contexte.md.
Les fichiers de ce dépôt sont ceux de mon installation, adaptés à mon réseau et à mon matériel.
- Accès à distance par Tailscale, sans port ouvert, et HTTPS partout avec un certificat Let's Encrypt générique.
- AdGuard Home comme DNS de tout l'appartement : publicités et pistage bloqués, DNS chiffré, DNSSEC.
- Home Assistant OS dans une machine virtuelle, avec des objets Matter, Thread, Zigbee et HomeKit.
- Services peu utilisés démarrés seulement quand on les ouvre.
- 31 sondes Uptime Kuma, une page de supervision faite maison et l'inventaire des appareils du réseau.
- Alertes sur le téléphone avec ntfy, en deux niveaux (critique ou silencieux).
- Sauvegarde locale et copie chiffrée hors site chaque nuit, image du disque chaque semaine, essai de restauration automatique chaque mois.
- Reconnexion automatique au portail captif de la résidence.
- Wikipédia, une IA locale et la carte de France utilisables sans Internet.
- Système durci, score Lynis passé de 70 à 81.
![]() |
![]() |
| Page d'accueil (Homepage), avec les capteurs de chaque service. | Tableau « Homelab » dans Home Assistant. |
![]() |
![]() |
| Page de statut d'Uptime Kuma. | Carte de France hors ligne (OpenStreetMap, Protomaps). |
Le domaine, les noms, les adresses publiques et les identifiants matériels ont été remplacés sur les captures.
| Élément | Modèle | Rôle |
|---|---|---|
| Serveur | Raspberry Pi 5, 8 Go, refroidissement actif | Conteneurs, machine virtuelle, sauvegardes |
| Stockage | SSD NVMe Samsung PM981 512 Go (MZVLB512HBJQ), en PCIe Gen 2 |
Système et données, sans carte SD |
| Routeur | GL.iNet Opal GL-SFT1200 |
Répète le Wi-Fi de la résidence et crée le réseau de l'appartement |
| Domotique | Aqara Camera Hub G3, capteur FP2, Nest Hub, prise Meross, objets IKEA et Tuya | Sécurité, présence, lumière, mesures |
Le Pi consomme environ 6 W. Plus de détails dans docs/materiel.md.
flowchart LR
dehors["iPhone et Mac<br/>hors de l'appartement"]
ts(("Tailscale"))
subgraph residence["Wi-Fi de la résidence (portail captif)"]
subgraph appart["Réseau de l'appartement 192.168.8.0/24"]
routeur["Routeur GL.iNet<br/>répéteur et NAT"]
perso["Appareils de l'appartement"]
objets["Objets connectés<br/>Matter, Thread, Zigbee, HomeKit"]
subgraph pi["Raspberry Pi 5"]
fw["Pare-feu nftables"]
nginx["nginx, HTTPS<br/>*.exemple.duckdns.org"]
docker["21 conteneurs Docker<br/>dont 8 à la demande"]
vm["VM Home Assistant OS<br/>AdGuard Home"]
end
end
end
cloud[("OneDrive<br/>sauvegardes")]
dehors -- "chiffré" --> ts --> fw
perso --> routeur --> fw --> nginx --> docker
nginx --> vm
routeur -. "DNS" .-> vm
vm --- objets
pi -- "restic, rclone" --> cloud
Aucune connexion n'arrive depuis Internet. Dans l'appartement, les appareils passent par le routeur ; à l'extérieur, par Tailscale. nginx est le seul point d'entrée vers les services, qui n'écoutent que sur le Pi. Plus de détails dans docs/architecture.md.
J'utilise quelques services externes, tous gratuits ou inclus dans mon compte étudiant : Tailscale pour l'accès à distance, DuckDNS pour le nom de domaine et la validation du certificat, Let's Encrypt, OneDrive pour les sauvegardes, ntfy.sh pour relayer les notifications vers l'iPhone, Quad9 et Cloudflare comme DNS en amont.
| Domaine | Services | Fonctionnement |
|---|---|---|
| Maison | Home Assistant, Immich (photos), Jellyfin (médiathèque) | Home Assistant en VM, Immich permanent, Jellyfin à la demande |
| Applications | Nextcloud, Stirling-PDF, IT-Tools | Nextcloud et Stirling-PDF à la demande |
| Hors ligne | Kiwix (Wikipédia), llama.cpp (IA locale), cartes | Kiwix et l'IA à la demande, les cartes sont un site statique |
| Supervision | Salle de contrôle, Uptime Kuma, NetAlertX, Glances, Homepage | Permanent |
| Administration | ntfy, Dozzle, Portainer, documentation | Permanent |
| Réseau | nginx, AdGuard Home, Tailscale, DuckDNS | Permanent |
Côté système : Raspberry Pi OS 64 bits (Debian 12), Docker Compose, KVM et libvirt, nftables, fail2ban, AppArmor, restic, rclone et Lynis. La liste complète avec les versions est dans docs/services.md.
| Dossier | Contenu | Emplacement sur le Pi |
|---|---|---|
| stacks/ | Une stack Docker Compose par service, nginx, page d'accueil, salle de contrôle | /opt/homelab/ |
| scripts/ | La commande homelab et les scripts de sauvegarde, supervision et maintenance |
/usr/local/sbin/ |
| systemd/ | Tâches planifiées et services à la demande | /etc/systemd/system/ |
| systeme/ | Pare-feu, réglages du noyau et de SSH, profil Lynis | /etc/ |
| home-assistant/ | Tableau de bord « Homelab » en YAML | /config/ dans la VM |
| docs/ | Documentation et décisions d'architecture | |
| captures/ | Captures d'écran |
Les mots de passe, jetons et clés sont générés sur le Pi et rangés dans /etc/homelab/secrets/, hors du dépôt (voir SECURITY.md).
- DNS de secours sur le routeur, utilisé seulement si AdGuard ne répond pas.
- Home Assistant : bannissement après des échecs de connexion, double authentification.
- Arrêter Portainer, qui donne un accès complet à Docker et sert très peu.
- Une seconde destination pour les sauvegardes, indépendante du compte étudiant.
- Passer à Debian 13 en 2027, avant la fin du support de Debian 12 en juin 2028.
- Un onduleur si le compteur d'arrêts brutaux du SSD continue de monter.
MIT, voir LICENSE. Tout repose sur des projets libres, en particulier Home Assistant, Immich, Nextcloud, Uptime Kuma, Homepage, Glances, NetAlertX, ntfy, Kiwix, llama.cpp, Jellyfin, MapLibre, Protomaps, restic, rclone et Lynis.




