So installieren Sie das Cachet-Statusseiten-System auf Debian 12

Cachet ist ein Open-Source-Statusseiten-System, das in PHP geschrieben ist. Es ermöglicht Ihnen, Ausfallzeiten und Systemfehler in Ihrer Infrastruktur zu überwachen. Cachet bietet eine JSO-API, sogar Berichte, Metriken, mehrere Benachrichtigungsmethoden und Zwei-Faktor-Authentifizierung.

Im folgenden Tutorial zeigen wir Ihnen, wie Sie die Cachet-Statusseite auf einem Debian 12-Server installieren. Sie werden Cachet als Docker-Container mit der PostgreSQL-Datenbank und dem Nginx-Webserver ausführen.

Voraussetzungen

Bevor Sie fortfahren, stellen Sie sicher, dass Sie Folgendes haben:

• Einen Debian 12-Server.
• Einen Nicht-Root-Benutzer mit Sudo-Rechten.
• Eine UFW wurde installiert und konfiguriert.
• Einen Domainnamen, der auf eine Server-IP-Adresse verweist.

Docker-Engine installieren

In diesem Beispiel installieren Sie Cachet als Container über Docker. Daher müssen Sie die Docker-Engine auf Ihrem Debian-System installieren. In diesem Beispiel verwenden Sie die offiziellen Docker-Engine-Pakete.

Zuerst führen Sie den folgenden Befehl aus, um die Pakete curl und ca-certificates zu installieren.

sudo apt install ca-certificates curl -y

Fügen Sie nun den GPG-Schlüssel für das Docker-Repository hinzu, indem Sie den folgenden Befehl ausführen.

sudo install -m 0755 -d /etc/apt/keyrings  
sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc  
sudo chmod a+r /etc/apt/keyrings/docker.asc

Fügen Sie als Nächstes das Docker-Engine-Repository für das Debian-System mit dem folgenden Befehl hinzu.

echo \  
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian \  
$(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \  
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Sobald das Docker-Repository hinzugefügt wurde, aktualisieren und aktualisieren Sie Ihren Paketindex mit dem folgenden Befehl.

sudo apt update

Jetzt installieren Sie die Docker-Engine auf Ihrem System mit dem folgenden Befehl. Geben Sie Y ein, um die Installation zu bestätigen.

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Nach Abschluss der Installation sollte der Docker-Dienst automatisch ausgeführt werden. Überprüfen Sie den Status des Docker-Dienstes mit dem folgenden Befehl.

sudo systemctl status docker

Sie sollten eine Ausgabe sehen, die wie folgt aussieht:

Um sicherzustellen, dass Ihr Benutzer den Container ausführen und starten kann, müssen Sie ihn mit dem folgenden Befehl zur docker-Gruppe hinzufügen.

sudo usermod -aG sudo alice

Zum Schluss melden Sie sich als Ihr Benutzer an und führen Sie den docker-Befehl unten aus, um einen Container hello-world auszuführen.

su - alice  
docker run hello-world

Wenn Ihre Konfiguration erfolgreich ist, sollten Sie die Ausgabe ‘Hello Docker’ wie folgt erhalten:

Cachet mit Docker und PostgreSQL-Datenbank ausführen

Nachdem Sie Docker installiert haben, müssen Sie das Cachet-Projekt herunterladen und Ihre Installation konfigurieren. In diesem Fall installieren und führen Sie Cachet als Nicht-Root-Benutzer mit einem Docker-Container aus.

Laden Sie das Cachet-Projekt in das Verzeichnis cachet-docker herunter und wechseln Sie in dieses Verzeichnis.

git clone https://github.com/cachethq/Docker.git cachet-docker  
cd cachet-docker

Öffnen Sie die Datei docker-compose.yml mit dem folgenden Befehl im Nano-Editor.

nano docker-compose.yml

Ändern Sie den Standard-Host-Port auf 8000 wie folgt. Sie können auch die Datenbankdetails mit Ihren Informationen anpassen und die Standardversion von Cachet vorerst auf 2.4 belassen.

 ports:  
 - 8000:8000

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie nun die folgenden Docker-Befehle aus, um Ihr Cachet-Image zu erstellen und Container für sowohl Cachet als auch PostgreSQL auszuführen.

docker compose build  
docker compose up

Unten sehen Sie einen Screenshot, als das Docker-Image für Cachet erstellt wurde.

Unten sehen Sie den Screenshot, als Container/Dienste für sowohl Cachet als auch PostgreSQL ausgeführt wurden.

In den ausführlichen Protokollen des Cachet-Containers finden Sie einen Fehler zur APP_KEY-Konfiguration. Kopieren Sie den generierten APP_KEY und drücken Sie Ctrl+c, um die Container zu beenden.

Öffnen Sie als Nächstes die docker-compose.yml-Datei erneut mit dem Nano-Editor.

nano docker-compose.yml

Ändern Sie den Standard-APP_KEY-Parameter wie folgt. Stellen Sie sicher, dass Sie die base64-Zeichenfolge einfügen.

APP_KEY=base64:WfKUhY0wAOyr5hkxoctZUSWPGdXbBUWFvNLCoI7kTU8=

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie nun den Docker-Befehl unten aus, um die Container für Cachet und PostgreSQL zu beenden und sie dann erneut zu starten.

docker compose down  
docker compose up -d

Sobald die Container gestartet sind, überprüfen Sie die Liste der laufenden Container mit dem folgenden Befehl.

docker compose ps

Wie Sie unten sehen können, laufen sowohl die Cachet- als auch die PostgreSQL-Container. Der Cachet-Container läuft auf Port 8000.

Nginx als Reverse-Proxy einrichten

Jetzt, da Cachet als Container auf Port 8000 läuft, installieren und konfigurieren Sie Nginx als Reverse-Proxy für Cachet.

Installieren Sie Nginx auf Ihrem Debian-Server mit dem folgenden Befehl.

sudo apt install nginx -y

Sobald die Installation abgeschlossen ist, erstellen Sie eine neue Nginx-Serverblockkonfiguration /etc/nginx/sites-available/cachet mit dem folgenden Befehl im Nano-Editor.

sudo nano /etc/nginx/sites-available/cachet

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie den server_name-Parameter mit Ihrem Domainnamen ändern.

server {  
 listen 80;  
 server_name status.howtoforge.local;  
 location / {  
 proxy_pass http://127.0.0.1:8000;  
 proxy_set_header Host $host;  
 proxy_set_header X-Real-IP $remote_addr;  
 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
 proxy_set_header X-Forwarded-Proto $scheme;  
 }  
}

Speichern Sie die Datei und beenden Sie den Editor.

Führen Sie als Nächstes den Nginx-Befehl unten aus, um den Cachet-Serverblock zu aktivieren und Ihre Nginx-Syntax zu überprüfen. Wenn Sie eine korrekte Syntax haben, sollten Sie die Ausgabe ‘syntax is ok‘ erhalten.

sudo ln -s /etc/nginx/sites-available/cachet /etc/nginx/sites-enabled/  
sudo nginx -t

Zuletzt starten Sie den Nginx-Webserver neu, um die Cachet-Serverblockkonfiguration anzuwenden, und überprüfen Sie den Nginx-Dienst, um sicherzustellen, dass er läuft.

sudo systemctl restart nginx  
sudo systemctl status nginx

Wenn Nginx läuft, sollten Sie die Ausgabe active(running) erhalten.

UFW (Uncomplicated Firewall) einrichten

Bevor Sie auf Cachet zugreifen, müssen Sie sicherstellen, dass sowohl die HTTP- als auch die HTTPS-Ports erlaubt sind. Auf Ubuntu erlauben Sie den Verkehr zu sowohl HTTP als auch HTTPS über UFW (Uncomplicated Firewall).

Stellen Sie sicher, dass UFW aktiviert ist, und führen Sie nun den folgenden Befehl aus, um das Profil ‘Nginx Full‘ in UFW zu aktivieren. Dies ermöglicht den Verkehr für sowohl HTTP- als auch HTTPS-Protokolle zu Ihrem Nginx-Webserver.

sudo ufw allow 'Nginx Full'

Überprüfen Sie nun Ihre Liste der aktivierten Regeln in UFW mit dem folgenden Befehl.

sudo ufw status

Sie werden sehen, dass das Profil ‘Nginx Full‘ in UFW aktiviert ist.

Cachet mit HTTPS sichern

An diesem Punkt sollte Ihr Cachet über Nginx zugänglich sein. Um Ihre Installation zu sichern, aktivieren Sie HTTPS für Cachet über SSL von Letsencrypt.

Führen Sie den folgenden Befehl aus, um Certbot und das Certbot Nginx-Plugin zu installieren. Geben Sie Y ein, um die Installation zu bestätigen.

sudo apt install certbot python3-nginx-certbot

Sobald die Installation abgeschlossen ist, führen Sie den Certbot-Befehl unten aus, um SSL/TLS-Zertifikate für Ihre Cachet-Installation zu generieren. Stellen Sie sicher, dass Sie die Details des Domainnamens und die E-Mail-Adresse mit Ihren Informationen ändern.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d status.howtoforge.local

Nachdem alles abgeschlossen ist, sollten Ihre SSL/TLS-Zertifikate im Verzeichnis /etc/lestencrypt/live/status.howtoforge.local gespeichert sein. Außerdem sollte Ihr Cachet über HTTPS gesichert sein.

Cachet installieren

Starten Sie Ihren bevorzugten Webbrowser und besuchen Sie Ihre Cachet-Installation https://status.howtoforge.local/. Wenn Ihre Installation erfolgreich ist, sollten Sie die folgende Seite erhalten.

Wählen Sie den Standard-Cache Driver, Queue Driver und Session Driver auf Database. Geben Sie dann die Details Ihres Mailservers ein.

Klicken Sie auf Next, um fortzufahren.

Richten Sie nun den Namen der Statusseite, die Standardzeitzone und die Standardsprache ein. Klicken Sie dann erneut auf Next.

Erstellen Sie nun einen neuen Admin-Benutzer für Cachet, indem Sie Ihren Benutzernamen, Ihre E-Mail und Ihr Passwort eingeben. Klicken Sie dann auf Complete Setup, um zu bestätigen.

Sobald die Installation abgeschlossen ist, sehen Sie Folgendes - klicken Sie auf Go to the dashboard.

Melden Sie sich bei Cachet mit Ihrem Benutzernamen und Passwort an und klicken Sie auf Login.

Wenn Ihre Installation erfolgreich ist, sollten Sie das Cachet-Dashboard wie folgt erhalten:

Fazit

Herzlichen Glückwunsch! Sie haben jetzt die Cachet-Statusseite auf dem Debian 12-Server mit Docker installiert. Ihre Cachet-Installation läuft mit einer PostgreSQL-Datenbank und einem Nginx-Webserver. Sie können jetzt Ihre Websites mit Cachet überwachen.