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
- In der ISPConfig-UI umgestellte PHP-Version/Modus wirkt nicht, die Site liefert weiter die alte Version (phpinfo im test.php zeigt Beweis).
- vHost in
sites-availablesieht korrekt aus, aber Änderungen kommen "nicht an". - Resync meldet Erfolge,
sys_datalogwird abgearbeitet, trotzdem ändert sich am Verhalten nichts. - Bei mir konkret: sites-enabled enthielt für web2 (zockertown.de) eine echte Datei mit altem fcgid-Setup inkl.
FCGIWrapperauf einen php-cgi8.3-Starter. Alle FPM-Umstellungen ins Leere gelaufen, bis der Symlink sauber gesetzt war.
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"
fcgid_modulegeladen → FastCGI/Fcgid-Blöcke im vHost sind aktiv, Starter-Skript wird ausgeführt (SAPI: CGI/FastCGI, oft alte PHP-Version).- nur
proxy_fcgi_module→SetHandler "proxy:fcgi://..."greift, echtes FPM (SAPI: FPM/FastCGI).
Welche PHP-Variante läuft wirklich? test.php aufrufen und den Server API-Wert lesen:
CGI/FastCGI→ php-cgi über Starter-Skript (oft/var/www/php-fcgi-scripts/webXX/.php-fcgi-starter)FPM/FastCGI→ PHP-FPM-Pool
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
domain.de.vhost.errin sites-available: ISPConfig-Rollback-Datei eines fehlgeschlagenen Schreibvorgangs. Zeigt oft den Stand vor dem Fehler, hilft bei forensischen Fragen, kann danach entfernt werden.- Verwaiste Starter-Skripte unter
/var/www/php-fcgi-scripts/webXX/: bleiben bei FPM-Sites liegen, sind harmlos, solange kein fcgid sie ruft. - Bei PostgreSQL-Analogie denken: gleiche Klasse von Fehler (Datei an Stellen, die die Verwaltung nicht mehr anfasst).
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:

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