Beszel : superviser ses serveurs et conteneurs avec un outil léger auto-hébergé

Vous avez trois ou quatre serveurs, quelques conteneurs Docker, un NAS, et aucune idée de leur état tant qu’un utilisateur ne se plaint pas. Prometheus et Grafana sont puissants mais lourds à mettre en place pour une petite infrastructure. Beszel répond exactement à ce besoin : une supervision open source légère, installée en quelques minutes, qui affiche l’historique du processeur, de la mémoire, des disques, du réseau et des conteneurs, avec des alertes. Présentation et installation pas à pas.

L’essentiel en 30 secondes

• Beszel se compose d’un hub (interface web et base de données) et d’agents installés sur chaque machine.
• Il suit le CPU, la mémoire, les disques, le réseau, les températures et les statistiques de chaque conteneur Docker ou Podman.
• Les alertes (seuils, machine injoignable) partent par e-mail ou vers des services de notification.
• L’agent consomme très peu de ressources, ce qui le rend adapté aux petits serveurs et aux Raspberry Pi.
• Licence MIT, gratuit, auto-hébergé.

Beszel, Uptime Kuma, Prometheus : qui fait quoi ?

Beszel et un outil de disponibilité comme Gatus se complètent bien : l’un regarde l’intérieur des machines, l’autre vérifie que les services répondent.

Installer le hub avec Docker

Sur une machine dédiée à la supervision (ou un petit serveur existant), créez un fichier docker-compose.yml :

services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    ports:
      - "8090:8090"
    volumes:
      - ./beszel_data:/beszel_data

docker compose up -d

Ouvrez http://adresse-du-serveur:8090, créez le compte administrateur. En production, placez le hub derrière un proxy inverse avec HTTPS, et épinglez une version précise de l’image plutôt que latest pour maîtriser les mises à jour.

Ajouter un serveur à surveiller

Dans l’interface, cliquez sur Ajouter un système : le hub génère une clé et la commande d’installation de l’agent. Deux méthodes :

Agent en conteneur

services:
  beszel-agent:
    image: henrygd/beszel-agent:latest
    container_name: beszel-agent
    restart: unless-stopped
    network_mode: host
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      LISTEN: 45876
      KEY: "ssh-ed25519 AAAA... (clé fournie par le hub)"

L’accès en lecture seule au socket Docker permet de remonter les statistiques de chaque conteneur.

Agent binaire

Le hub fournit aussi un script d’installation qui crée un service systemd. C’est la méthode à privilégier sur un serveur sans Docker ; un installateur existe également pour Windows.

Selon la configuration, c’est le hub qui se connecte à l’agent (port 45876, authentification par clé) ou l’agent qui établit la connexion vers le hub, pratique pour des machines derrière un pare-feu. Dans le premier cas, n’ouvrez ce port qu’à l’adresse du hub.

Configurer les alertes

Pour chaque système, activez les alertes utiles :

• Statut : machine injoignable (la plus importante) ;
• CPU au-dessus de 90 % pendant 10 minutes ;
• Mémoire au-dessus de 90 % ;
• Disque au-dessus de 85 %, pour avoir le temps d’agir ;
• Température sur les machines physiques et les NAS.

Les notifications passent par un serveur SMTP ou par des services comme ntfy, Gotify, Telegram, Discord ou Teams. Testez l’envoi dès la configuration : une alerte qui n’arrive pas ne sert à rien.

Sécuriser l’installation

1. Hub accessible uniquement en HTTPS, idéalement depuis le réseau interne ou un VPN.
2. Authentification forte : Beszel accepte la connexion via un fournisseur OpenID Connect comme Authentik.
3. Port de l’agent filtré pour n’accepter que le hub.
4. Socket Docker monté en lecture seule ; ne pas exposer l’API Docker sur le réseau. Voir sécurité des conteneurs Docker.
5. Sauvegarde régulière du dossier de données du hub (Beszel propose des sauvegardes automatiques, y compris vers un stockage S3).

Exploiter les données

L’historique permet de répondre à des questions concrètes : la lenteur signalée hier à 15 h correspond-elle à un pic d’entrées-sorties disque ? Quel conteneur consomme toute la mémoire ? Le disque de sauvegarde sera-t-il plein dans un mois ? Pour aller plus loin dans le diagnostic d’un serveur, combinez avec nos 15 commandes Linux de diagnostic.

Questions fréquentes

Beszel convient-il pour surveiller des équipements réseau ?

Non : il nécessite un agent sur chaque machine et ne gère pas le SNMP. Pour les commutateurs, pare-feu et bornes, utilisez un outil comme NetXMS.

Combien de serveurs peut-il surveiller ?

Plusieurs dizaines sans difficulté sur un petit hub. Il vise avant tout les petites et moyennes infrastructures.

Peut-on donner accès à plusieurs personnes ?

Oui, avec plusieurs comptes et un partage des systèmes entre utilisateurs, ce qui permet par exemple à un prestataire et à un responsable interne de consulter les mêmes tableaux de bord.

Les données quittent-elles mon infrastructure ?

Non. Tout est stocké sur votre hub, sans service cloud tiers.

Sources

• Beszel, documentation officielle.
• Dépôt GitHub du projet Beszel.

Besoin d’un accompagnement ?

MPCÂBLE Solutions Informatiques (MPCSI) accompagne particuliers, entreprises, associations et collectivités depuis Gaudiès, en Ariège : sur site en Occitanie, principalement dans un rayon de 40 km (Pamiers, Foix, Mirepoix, Saverdun, Castelnaudary), et à distance partout en France. Nous installons et suivons la supervision de vos serveurs dans le cadre de notre infogérance. Demandez un devis gratuit ou appelez le 05 32 42 99 98.