Hitéa

Outils

Tirelire Vigie SecureSend Explicateur crontab Quel LLM local ? Générateur de QR code Tout le catalogue

Contenu

Blog Guides

Projet open source · Auto-hébergé

Vigie

Une seule page, chez vous, qui vous dit si votre homelab va bien : services, hyperviseurs Proxmox, serveurs, appareils du réseau, mises à jour en retard. Et un message Telegram quand quelque chose demande votre attention.

Licence
Apache-2.0, gratuit
Installation
Docker ou Node 22 et systemd
Données
Un fichier SQLite chez vous
Interface
Français et anglais

Vigie lit, il ne touche à rien : jetons en lecture seule, aucune action sur les machines surveillées. Il tourne sur votre serveur, sans compte en ligne ni service externe obligatoire, et garde son historique dans un fichier SQLite.

Aperçu

Vigie : cockpit : état global, indicateurs, hyperviseurs
Cockpit : état global, indicateurs, hyperviseurs
Vigie : inventaire du réseau
Inventaire du réseau
Vigie : mises à jour à traiter
Mises à jour à traiter
Vigie : alertes actives
Alertes actives
Vigie : mode mur, pour un écran dédié
Mode mur, pour un écran dédié

Captures réalisées sur des données de démonstration : tous les noms et adresses sont inventés.

Ce que fait Vigie

Services surveillés

Sondes HTTP, TCP, DNS et certificats TLS, avec l'historique de disponibilité de 24 heures à 90 jours et la latence. Des widgets lisent l'API de vos applis (Pi-hole, qBittorrent ou n'importe quelle API JSON).

Proxmox en lecture seule

Nœuds, VM et conteneurs, stockage, santé des disques (SMART, usure), tâches en échec et sauvegardes : planning, matrice sur 7 jours, invités hors de tout job. Un jeton PVEAuditor et une CA épinglée suffisent.

Un agent léger sur vos serveurs

dash-report, un script shell lu par SSH avec une commande forcée, remonte disques, conteneurs Docker, services systemd, mises à jour apt en attente, redémarrage nécessaire, posture SSH et pare-feu, et ports en écoute.

Inventaire du réseau

Les appareils du réseau, trouvés par scans ARP, baux DHCP, Pi-hole, Proxmox et mDNS, avec leur historique de présence, une carte et une alerte pour chaque nouvel appareil.

Mises à jour suivies

Version installée contre dernière version publiée (GitHub, registres Docker, PyPI, Gitea, apt), correctifs de sécurité et dates de fin de vie, avec la possibilité d'ignorer ou de reporter en notant pourquoi.

Alertes qui ne crient pas pour rien

Délais de grâce, dépendances entre alertes, heures calmes et résumé quotidien. Messages Telegram avec boutons, bot interactif, acquittements et silences motivés. ntfy en second canal.

Mode mur

Une vue plein écran pour un écran dédié, avec thème clair ou sombre.

Plugins

Gitea (activité, CI et runners) et ntfy sont des plugins. Une interface interne, documentée, permet d'écrire les vôtres.

Installation avec Docker

Docker Compose est la méthode la plus simple : un assistant pose la configuration (titre, langue, mot de passe administrateur, Proxmox, Gitea).

git clone https://github.com/HiteaFR/vigie.git && cd vigie
docker compose build
docker compose run --rm init
docker compose up -d

Ouvrez ensuite http://127.0.0.1:8088 sur l'hôte Docker. Sans configuration, le service démarre en mode « configuration requise » et son journal indique de lancer init.

  • Le port n'est publié que sur 127.0.0.1 : placez un reverse proxy HTTPS devant pour y accéder depuis le réseau.
  • L'installation sans Docker (Node 22, unité systemd fournie) et l'agent dash-report sont décrits dans la documentation du dépôt.
  • L'historique et la configuration vivent dans le volume de données : sauvegardez-le.

Sécurisé par défaut

  • Écoute sur 127.0.0.1 par défaut, en-tête Host vérifié.
  • Lecture de l'API derrière une session, connexion administrateur depuis la machine locale seulement par défaut.
  • Les jetons restent sur le serveur, dans un fichier d'environnement en 0600 ; jetons Proxmox et Gitea en lecture seule.
  • Chaque écriture (acquittement, silence…) est journalisée, la plupart avec un motif.

Bon à savoir

  • Pensé pour un homelab : un seul compte administrateur, pas de gestion d'utilisateurs ni de rôles.
  • L'agent vise les serveurs Linux Debian ou Ubuntu (apt, systemd) ; ailleurs, seules les sondes et Proxmox s'appliquent.
  • Pas encore de version publiée : l'interface des plugins est interne et peut changer.

Gratuit et open source

Node.js 22 Express React 19 Vite Tailwind 4 SQLite (node:sqlite)
Voir le dépôt