Symptom: bash: ./bin/server-tools: Permission denied
Prüfung:
ls -la bin/server-tools
Lösung:
chmod +x bin/server-tools
Symptom: /usr/local/bin/server-tools: Permission denied, obwohl die Installation erfolgreich war.
Ursache: Das installierte Binary ist absichtlich chmod 700 (nur root). Ein direkter Aufruf ohne sudo schlägt fehl, auch für den Owner-losen Fall.
Lösung:
sudo server-tools <command>
# nicht: server-tools <command>
Symptom: Script bricht sofort ab
Lösung:
sudo server-tools <command>
# oder
sudo su -
server-tools <command>
Symptom: ERROR: MySQL connection failed
Prüfung:
# MySQL laeuft?
systemctl status mysql
# Credentials vorhanden?
cat /root/.my.cnf
# Manuell testen
mysql -e "SELECT 1"
Lösung:
# Credentials anlegen
echo -e "[client]\npassword=DEIN_ROOT_PASSWORT" > /root/.my.cnf
chmod 600 /root/.my.cnf
Symptom: Im interaktiven Menu erscheint Database Management [mysql not installed], CLI-Befehl server-tools db ... bricht ab.
Ursache: Weder mysql/mysqldump noch mariadb/mariadb-dump sind im PATH — typischerweise weil mariadb-client nicht installiert ist.
Lösung:
apt-get install mariadb-client
Danach ist das Datenbankmenü automatisch wieder aktiv. Alle anderen Features (VHost, SSL, Firewall etc.) funktionieren auch ohne diese Installation normal.
Symptom: ERROR: Apache configuration test failed
Prüfung:
apache2ctl configtest
Lösung: Die Ausgabe von configtest zeigt den Fehler. Häufige Ursachen:
# PHP-FPM pruefen
systemctl status php8.3-fpm
# Module aktivieren
a2enmod headers proxy_fcgi
systemctl reload apache2
Symptom: server-tools vhost audit zeigt [DRIFT]-Zeilen für einzelne Direktiven (z.B. fehlender X-Forwarded-Header oder ProxyPass-Abweichung).
Ursache: Der VHost wurde nach der Erstellung manuell bearbeitet, oder er stammt aus einer Version vor der jeweiligen Vorlagen-Ergänzung.
Lösung: Die betroffene Direktive manuell in der VHost-Config nachtragen (Pfad über vhost info --domain <domain> ermitteln) und danach erneut auditieren. vhost audit schreibt nichts automatisch zurück - es meldet nur die Abweichung.
Symptom: server-tools vhost audit meldet [SKIP] template audit not yet implemented for nginx.
Ursache: Die Drift-Erkennung prüft aktuell ausschließlich Apache-Direktiven und ist für Nginx-Backends noch nicht implementiert.
Lösung: Keine - Nginx-VHosts manuell mit der kanonischen Vorlage vergleichen, bis Nginx-Support für vhost audit nachgezogen ist.
Symptom: ERROR: ACL support not available oder setfacl: command not found
Prüfung:
# ACL-Tools installiert?
which setfacl getfacl
# Filesystem unterstuetzt ACLs?
mount | grep acl
Lösung:
# ACL-Paket installieren
apt-get install acl
# Falls ACLs nicht im Mount aktiviert sind
mount -o remount,acl /var/www
Symptom: WARNING: Config file is world-readable
Lösung:
chmod 600 /etc/server-tools/config
Wenn ein Problem nicht in dieser Liste steht: Das Audit-Log unter
/var/log/server-tools-audit.logenthält Details zu allen ausgeführten Operationen und aufgetretenen Fehlern.