Ein Wiki privater Natur

ISPConfig-tips

Ein paar sachen, wie workarounds z.B.

ISPConfig Tips

Fehlkonfiguration in sites-enabled: Wenn der Symlink fehlt

Kurzfassung (First Look, bevor man sich einen Wolf sucht)

ISPConfig schreibt vHost-Dateien immer nach /etc/apache2/sites-available/. Apache liest aber ausschließlich /etc/apache2/sites-enabled/. Wenn dort statt eines Symlinks eine echte Datei liegt, ist diese Datei immun gegen jeden ISPConfig-Resync, jeden datalog-Job und jedes Speichern in der UI. Man ändert also fleißig die falsche Datei.

Der 10-Sekunden-Erstcheck, bevor irgendeine Debug-Session beginnt:

find /etc/apache2/sites-enabled/ -maxdepth 1 -type f

Ergebnis: leer → alles im Lot, normales Debugging erlaubt.
Ergebnis: Treffer → da liegt eine Zombie-vHost-Datei, die ist zuerst zu behandeln (siehe unten).

Symptome, wie sie sich zeigen

Ursache

Typisch sind handeditierte Dateien in sites-enabled (z. B. in einer Debug-Nacht: "schnell mal" im falschen Verzeichnis gearbeitet) oder ein abgebrochener Config-Schreibvorgang. ISPConfig verwaltet sites-enabled per Symlink-Konvention; echte Dateien kennt sein Resync nicht und fasst sie nie wieder an.

Reparatur

# Alte Datei nachweisen und sichern
ls -la /etc/apache2/sites-enabled/
mv /etc/apache2/sites-enabled/NNN-domain.de.vhost /root/NNN-domain.de.vhost.bak

# Symlink sauber setzen (Namensschema mit Reihenfolge-Prefix beachten)
ln -s /etc/apache2/sites-available/domain.de.vhost /etc/apache2/sites-enabled/NNN-domain.de.vhost

apache2ctl configtest && systemctl reload apache2

Danach die Site test.php-gegenprüfen (siehe Diagnose-Befehle).

Diagnose-Befehle im Detail

Ist die geladene Datei identisch mit der in sites-available?

diff /etc/apache2/sites-enabled/NNN-domain.de.vhost /etc/apache2/sites-available/domain.de.vhost

Große Differenz = sites-available wird von Apache nicht gesehen, die echte Datei in sites-enabled gewinnt.

Welche Module entscheiden, welcher PHP-Block im vHost gewinnt?

apache2ctl -M | grep -iE "fastcgi|fcgid|proxy_fcgi"

Welche PHP-Variante läuft wirklich? test.php aufrufen und den Server API-Wert lesen:

vHost-Bindung prüfen (SNI-Falle):

apache2ctl -S 2>/dev/null | grep -i domain

Steht bei einer Site eine konkrete IP (1.2.3.4:443) statt *:443, gewinnt dieser vHost bei der vHost-Auswahl vor allen Wildcard-Sites: Anfragen auf 443 ohne passenden SNI-Namen in dieser IP-Gruppe bekommen das Default-Cert dieses vHosts statt des richtigen Zertifikats. Bei mir: ein einziges IP-Feld in einer Site kaputt das SNI-Matching für alle übrigen Domains. Fix: IPv4-Feld in der UI leeren, speichern, Resync.

Verwandte Leichen

Mehrere php Versionen für einen Kunden bereit stellen

https://www.howtoforge.com/ispconfig-php-debian/

https://www.howtoforge.com/ispconfig-php-ubuntu/

https://www.howtoforge.com/ispconfig-php-debian/#-install-php--10

Individuelle php Versionen.

Auf der Webseite immer zwischen fastcgi und fpm umschalten, wenn man die php Version geändert hat

Guter einfacher Test:

<?php
 phpinfo();  // allg. Informationen zur PHP-Installation
?>

FastCGI und PHP-FPM sind beides Mechanismen, um die Ausführung von PHP-Skripten auf einem Webserver zu verwalten. Hier ist der Unterschied:
FastCGI: FastCGI (Fast Common Gateway Interface) ist ein Protokoll, das es ermöglicht, PHP-Skripte außerhalb des Webserver-Prozesses auszuführen. Es ermöglicht eine getrennte Verwaltung der PHP-Prozesse und bietet dadurch bessere Skalierbarkeit und Performance. FastCGI wird oft in Kombination mit Webservern wie Apache oder Nginx verwendet.
PHP-FPM: PHP-FPM (PHP FastCGI Process Manager) ist eine spezifische Implementierung von FastCGI für PHP. Es ist ein Prozessmanager, der die Verwaltung und Steuerung der PHP-Prozesse übernimmt. PHP-FPM bietet zusätzliche Funktionen wie Pooling, um die Anzahl der PHP-Prozesse zu steuern, und ermöglicht die Konfiguration von Ressourcenlimits für einzelne Prozesse. PHP-FPM ist standardmäßig in PHP 5.3 und höher enthalten.
In Bezug auf PHP 8.3: PHP 8.3 unterstützt sowohl FastCGI als auch PHP-FPM. Du kannst wählen, welchen Mechanismus du verwenden möchtest, abhängig von deinen spezifischen Anforderungen und der Konfiguration deines Servers.

restart statt reload nach PHP-Umstellungen

FPM bindet Sockets/Ports beim Reload nicht immer neu
Deshalb beispielsweise
systemctl restart php8.4-fpm

Soweit die KI.

Was bringt es nun?

FastCGI FPM/FastCGI FPM
"transactions": 16000, "transactions": 16000, 〰
"availability": 100.00, "availability": 100.00, 〰
"elapsed_time": 249.07, "elapsed_time": 195.81, ✅
"data_transferred": 80.72, "data_transferred": 80.72, 〰
"response_time": 0.14, "response_time": 0.11, ✅
"transaction_rate": 64.24, "transaction_rate": 81.71, ✅
"throughput": 0.32, "throughput": 0.41, ✅
"concurrency": 8.81, "concurrency": 9.35, ✅
"successful_transactions": 16000, "successful_transactions": 16000, 〰
"failed_transactions": 0, "failed_transactions": 0, 〰
"longest_transaction": 11.10, "longest_transaction": 10.24, ✅
"shortest_transaction": 0.07 "shortest_transaction": 0.07 〰

〰 entspricht Gleich
✅ entspricht Besser

Der Sieger sollte klar sein.
Prüfmethode war siege -c 10 -r 100 https://zockertown.de/s9y

Lets encrypt

tips

ISPConfig Let's Encrypt: SSL-Haken verschwindet nach dem Speichern
Symptom
Nach dem Anlegen einer neuen Website oder beim Nachholen von SSL wird das Zertifikat erstellt, aber im ISPConfig-Interface erscheint der Let's Encrypt-Schalter automatisch wieder als deaktiviert. Die Seite hat ein gültiges Cert (curl funktioniert), aber die Automatisierung zum Renewal ist gestört.

Screenshot des Problems:
bildschirmfoto_vom_2026-10-20_18-32-33.png
SSL: ✓
Let's Encrypt:

Ursache

ISPConfig setzt den LE-Haken zurück, wenn:

Der SSL-vHost nicht vollständig generiert war (Cron-Job lief noch nicht durch)
Die HTTP-01-Challenge blockiert war (Firewall/Rewrite-Regeln)
Die Website mit konkreter IP statt * angelegt wurde (SNI-Probleme bei Subdomains)
Das Cert existiert, die Datei ist da – aber der CronJob, der das Renewal auslöst, wird für diese Domain nicht mehr angestoßen.

Lösung (Zweistufen-Verfahren)

Nicht beide Haken gleichzeitig setzen!

Schritt Aktion Warten
1 Nur "SSL" anhaken → speichern 1 Minute (Cron)
2 Prüfen: grep SSLCertificateFile /etc/apache2/sites-available/XXX.vhost
3 "Let's Encrypt" nachziehen → speichern 1 Minute (Cron)
4 Prüfen: curl -s https://domain/healthcheck
Wichtig: Wenn nach Schritt 3 der Haken wieder weg ist → einfach nochmal speichern (dritter Durchgang). Die zweite Speicherung wird oft stabil.

Diagnose-Befehle

Zertifikat existiert?

ls -la /var/www/clients/client*/web*/ssl/ | grep domain

Apache zeigt das richtige Cert?

openssl s_client -connect [domain]:443 -servername [domain] </dev/null 2>/dev/null | \ openssl x509 -noout -subject

Cron-Job wurde ausgeführt?

tail -20 /var/log/ispconfig/cron.log | grep -i letsencrypt

Warnhinweis
Falls nach Schritt 1 das Cert bereits in der ssl/-Verzeichnis liegt (vom vorherigen Versuch): ISPConfig nutzt diese Datei bei Schritt 2 weiter, wenn der LE-Job startet. Es entsteht kein neues Cert, die alte Generation bleibt bestehen. Erst nach Ablauf (90 Tage bei Let's Encrypt) wird ein Renewal versucht.

Prävention
IP-Feld bei Subdomains immer auf * lassen
Firewall lässt Port 80 durch (HTTP-01-Challenge)
.htaccess erlaubt /.well-known/acme-challenge/
Nach Änderung der Subdomain-Struktur alle betroffenen Websites nach dem Verfahren durchgehen