, ,

Beszel mit Docker installieren: Server und Container überwachen

•

min Lesezeit

•

Letzte Änderung

Du möchtest CPU, Arbeitsspeicher, Festplatten und Docker-Container deiner Server im Blick behalten, ohne direkt einen großen Prometheus-Stack aufzubauen? Beszel bietet dafür einen zentralen Hub und schlanke Agents. In dieser Anleitung richtest du den Hub zunächst nur im lokalen Netzwerk ein und verbindest anschließend einen Server. Die offizielle Dokumentation findest du bei Beszel.

Echte Beszel-Oberfläche mit Diagrammen für CPU, Arbeitsspeicher und Serverauslastung

Abbildung: Original-Screenshot aus der offiziellen Beszel-Dokumentation (MIT, HenryGD). Quelle. Die Abbildung stammt vom Projekt, nicht aus einer von uns selbst getesteten Installation.

Voraussetzungen

Du benötigst einen Linux-Server mit Docker Engine und dem Compose-Plugin, Zugriff auf das Terminal und einen Browser im selben vertrauenswürdigen Netzwerk. Für einen öffentlich erreichbaren Hub solltest du zuerst HTTPS und eine geeignete Zugriffskontrolle planen. Die Beispiele nutzen einen lokalen Port; ersetze die Beispiel-IP durch die Adresse deines Servers.

Projektverzeichnis erstellen

mkdir -p ~/services/beszel
cd ~/services/beszel
docker compose version

Die Versionsabfrage muss eine Compose-Version anzeigen. Falls stattdessen ein unbekannter Docker-Befehl erscheint, fehlt das Compose-Plugin. Installiere es über die Docker-Paketquelle deiner Distribution, bevor du fortfährst.

Compose-Datei anlegen

Speichere folgenden Inhalt in compose.yaml. Der Port wird bewusst an die Loopback-Adresse gebunden. Für einen Zugriff von einem anderen Gerät ist später ein authentifizierter Reverse Proxy oder ein SSH-Tunnel erforderlich.

services:
  beszel:
    image: henrygd/beszel:latest
    container_name: beszel
    restart: unless-stopped
    environment:
      APP_URL: http://localhost:8090
    ports:
      - '127.0.0.1:8090:8090'
    volumes:
      - ./beszel_data:/beszel_data

Der Ordner beszel_data enthält persistente Anwendungsdaten. Verwende im Produktivbetrieb statt latest einen nach Prüfung der Release Notes festgelegten Versionstag oder Image-Digest. Die URL in APP_URL muss zu deinem tatsächlichen Zugriffsweg passen, insbesondere bei einem Reverse Proxy.

Hub starten

docker compose config
docker compose up -d
docker compose ps

Beispielausgabe (nicht auf diesem Server getestet):

NAME     IMAGE                 SERVICE   STATUS
beszel   henrygd/beszel:latest beszel    Up

Mit docker compose config prüfst du zunächst die Syntax. Up zeigt anschließend, dass der Container läuft; es garantiert noch keine erfolgreiche Anmeldung. Öffne bei lokalem Zugriff http://localhost:8090 oder leite den Port mit SSH weiter.

Zugriff per SSH-Tunnel

ssh -L 8090:127.0.0.1:8090 BENUTZER@SERVER-IP

Ersetze BENUTZER und SERVER-IP durch deine Werte. Solange die SSH-Verbindung offen bleibt, erreichst du den Hub am eigenen Rechner über http://127.0.0.1:8090. Lege dort das Administratorkonto an und verwende ein einzigartiges Passwort.

Agent verbinden

Im Hub kannst du über Add System einen weiteren Rechner hinzufügen. Die Oberfläche erzeugt eine passende Agent-Konfiguration. Übernimm den dort angezeigten öffentlichen Schlüssel und gegebenenfalls Token ausschließlich aus deinem eigenen Hub. Die Agent-Dokumentation beschreibt SSH- und WebSocket-Verbindungen: Agent installieren.

Für Docker-Containerstatistiken benötigt der Agent unter Umständen lesenden Zugriff auf den Docker-Socket. Dieser Zugriff ist sicherheitskritisch, auch bei einer schreibgeschützten Einbindung, weil die Docker-API weitreichende Informationen über den Host offenlegen kann. Verwende nur die offiziell dokumentierte Konfiguration und betreibe den Agent in einer vertrauenswürdigen Umgebung.

Erfolg kontrollieren

docker compose logs --tail=60 beszel
curl -I http://127.0.0.1:8090

Beispielausgabe (nicht selbst getestet):

HTTP/1.1 200 OK

Ein HTTP-Status wie 200 oder eine Weiterleitung zur Anmeldung belegt, dass der Webdienst antwortet. Im Hub sollte das verbundene System nach kurzer Zeit aktuelle Messwerte anzeigen. Fehlen sie, kontrolliere Agent-Logs, Schlüssel, Token, DNS-Auflösung und die gewählte Verbindungsart.

Updates und Backups

Sichere vor Updates den persistenten Ordner beszel_data konsistent und teste die Wiederherstellung auf einer separaten Umgebung. Prüfe die offiziellen Releases und aktualisiere das Image erst danach. Für ein Upgrade im Projektverzeichnis verwendest du:

docker compose pull
docker compose up -d

Falls der Dienst nicht erreichbar ist, helfen docker compose ps und docker compose logs bei der Eingrenzung. Veröffentliche weder Admin-Zugang noch Agent-Token in Screenshots oder Logauszügen. Als Ergänzung zu diesem Monitoring eignet sich der bestehende Grafana-Artikel für umfangreichere Dashboards.


Schreiben Sie einen Kommentar

Ihre E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert