CloudPanel auf einem Linux-VPS installieren (Ubuntu/Debian)

CloudPanel ist ein kostenloses, schlankes Control Panel, das Nginx, PHP-FPM, Datenbanken und SSL-Zertifikate über eine Weboberfläche verwaltet. Auf einem Infrawire Linux-VPS wird aus einem leeren Server in wenigen Minuten eine Hosting-Plattform für mehrere Websites. Diese Anleitung behandelt Ubuntu 24.04 und Debian 12.

📋 Voraussetzungen

Ein brandneuer KVM-VPS mit Ubuntu 24.04 oder Debian 12, auf dem sonst nichts installiert ist (kein Apache, Nginx, MySQL oder anderes Panel).
Mindestens 2 GB RAM und SSH-Zugang als root. In Ihrem Kundenbereich finden Sie die IP und das Root-Passwort des VPS.
Eine Domain, deren DNS-A-Eintrag (und AAAA, falls Sie IPv6 nutzen) auf VPS_IP zeigt.
Die Ports 22, 80, 443 und 8443 müssen aus dem Internet erreichbar sein.

🔄 1. System vorbereiten

Melden Sie sich als root an und aktualisieren Sie die Pakete. CloudPanel benötigt curl, wget und sudo.

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl wget sudo

Wurde der Kernel aktualisiert, starten Sie mit reboot neu und verbinden sich erneut, bevor Sie weitermachen.

⬇️ 2. Offiziellen Installer ausführen

Der Installer wird zuerst heruntergeladen, und seine SHA-256-Prüfsumme wird vor der Ausführung kontrolliert. Die Prüfsumme ändert sich mit jeder Installer-Version: Kopieren Sie den aktuellen Wert und die aktuelle Liste der Datenbank-Engines von der offiziellen Seite https://www.cloudpanel.io/docs/v2/getting-started/other/ (ersetzen Sie unten SHA256_FROM_DOCS).

Bash
1curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh
2echo "SHA256_FROM_DOCS install.sh" | sha256sum -c
3sudo CLOUD_PANEL_DB_ENGINE=MARIADB_11.4 bash install.sh

Die Variable CLOUD_PANEL_DB_ENGINE wählt den Datenbankserver. Dokumentiert sind MYSQL_8.4, MYSQL_8.0, MARIADB_11.4 und MARIADB_10.11. Ohne Angabe nutzt der Installer seinen Standard. sha256sum -c muss install.sh: OK ausgeben; bei FAILED brechen Sie ab und laden die Datei neu herunter. Die Installation dauert einige Minuten.

🔑 3. Ersten Admin-Account anlegen

Öffnen Sie https://VPS_IP:8443 im Browser. Das Zertifikat ist selbstsigniert, daher zeigt der Browser eine Warnung: Akzeptieren Sie sie für diese erste Anmeldung.

Der erste Besucher legt den Administrator an, also tun Sie das sofort. Tragen Sie Benutzernamen, E-Mail-Adresse und ein langes Passwort ein und melden Sie sich an. Lassen Sie das Panel nicht stundenlang ungeschützt erreichbar, bevor das Konto existiert.

🌐 4. PHP-Website hinzufügen

Klicken Sie im Panel auf Sites, dann auf Add Site und Create a PHP Site. Wählen Sie eine Anwendungsvorlage (Generic, WordPress, Laravel usw.), geben Sie example.com als Domain ein, wählen Sie eine PHP-Version und legen Sie Benutzer und Passwort der Website fest. CloudPanel erstellt den Nginx-vhost, einen PHP-FPM-Pool und einen eigenen Systembenutzer für die Website.

Laden Sie Ihre Dateien per SFTP mit dem Site-Benutzer (nicht root) nach /home/USER/htdocs/example.com hoch. Unter Databases können Sie außerdem eine Datenbank für die Website anlegen.

🔒 5. Let's-Encrypt-Zertifikat ausstellen

Prüfen Sie, ob example.com bereits auf VPS_IP zeigt:

Bash
1dig +short example.com

Öffnen Sie dann die Website, wechseln Sie zum Reiter SSL/TLS, klicken Sie auf Actions und wählen Sie New Let's Encrypt Certificate. Wählen Sie die einzubeziehenden Domainnamen aus und bestätigen Sie. Die Erneuerung übernimmt CloudPanel automatisch.

🛡️ 6. Das Panel absichern

Beschränken Sie in Admin Area > Security > Firewall den Port 8443 auf Ihre eigene IP-Adresse und entfernen Sie die Regel, die ihn für alle erlaubt. 22, 80 und 443 lassen Sie nach Bedarf offen.
Aktivieren Sie in Admin Area > Security Basic Auth für das Panel als zweite Hürde.
Aktivieren Sie in Ihrem Benutzerprofil die Zwei-Faktor-Authentifizierung.
Verwenden Sie ein langes, einmaliges Passwort und halten Sie das System aktuell:

Bash
1apt update && apt -y upgrade

✅ 7. Installation überprüfen

Bash
1ss -tlnp | grep -E ':(80|443|8443)\b'
2systemctl is-active nginx clp-agent
3curl -I https://example.com

Die Ports 80, 443 und 8443 sollten lauschen, beide Dienste active melden, und der letzte Befehl sollte HTTP 200 oder eine Weiterleitung mit gültigem Zertifikat liefern.

🧰 Fehlerbehebung

Der Installer startet nicht oder bricht ab: CloudPanel muss auf einem sauberen System installiert werden. War bereits ein anderer Webserver oder eine Datenbank vorhanden, installieren Sie das Betriebssystem über Ihren Kundenbereich neu und beginnen von vorn.
Port 8443 antwortet nicht: Prüfen Sie, ob die Firewall (Panel-Regeln und jede andere Firewall) ihn erlaubt und Ihre IP nicht aus der Freigabeliste entfernt wurde. Führen Sie auf dem Server ss -tlnp | grep 8443 aus.
Let's Encrypt schlägt fehl: Die Domain zeigt noch nicht auf den VPS, oder ein Proxy verdeckt die echte IP. Korrigieren Sie den DNS-Eintrag, warten Sie die Propagierung ab und versuchen Sie es erneut. Port 80 muss offen sein.
Admin-Passwort vergessen: Setzen Sie es in der Shell zurück mit clpctl user:reset:password --userName='admin' --password='NEW_PASSWORD'.

🎉 CloudPanel läuft: Fügen Sie Ihre Websites hinzu, sichern Sie Port 8443 und genießen Sie einen sauberen Hosting-Stack auf Ihrem VPS.