Dokumentation / Fehlerbehebung

Fehlerbehebung

Die meisten Einrichtungsprobleme laufen auf DNS, die Cloud-Firewall oder die Blockade des ausgehenden Ports 25 hinaus. So erkennen und beheben Sie jedes.

Das Panel öffnet sich unter meiner Domain nicht

  • http://server-IP/ funktioniert, aber die Domain nicht — das DNS löst noch nicht auf. Prüfen Sie panel.yourdomain.com unter dnschecker.org (Typ A). Ist es leer, sind Ihre DNS-Records oder Nameserver nicht gesetzt — siehe Ihre Domain richten.
  • Die Domain hat gar keine Nameserver — die Registrar-Delegation ist nicht veröffentlicht, oder Sie haben Records bei einem DNS-Anbieter gesetzt, der nicht autoritativ ist. Prüfen Sie NS unter dnschecker.org (Typ NS); ist es leer oder falsch, korrigieren Sie die Nameserver bei Ihrem Registrar oder wechseln Sie zu Cloudflare.
  • Die Nameserver zeigen irgendwohin, aber es löst dennoch nicht auf („REFUSED") — der DNS-Anbieter bedient die Zone gar nicht. Aktivieren Sie dort die DNS-Verwaltung oder verschieben Sie die Domain zu Cloudflare (es bedient die Zone immer, sobald sie hinzugefügt ist).

HTTPS ist nicht aktiv (Schloss fehlt)

HTTPS schaltet sich automatisch innerhalb von ~5 Minuten ein, sobald panel.yourdomain.com auf den Server zeigt. Falls nicht:

  • Bestätigen Sie, dass der A-Record auf die richtige IP auflöst (dnschecker.org).
  • Stellen Sie sicher, dass die Ports 80 und 443 in Ihrer Cloud-Firewall offen sind.
  • Wenn Sie Cloudflare verwenden, setzen Sie den panel-Record auf DNS only (graue Wolke), nicht proxied.
  • Um es jetzt zu erzwingen: per SSH als root einloggen und sudo nimbopanel-enable-https ausführen.

Kunden können keine E-Mails senden / ausgehende Mail wird zurückgewiesen oder läuft in einen Timeout

Öffnen Sie System → Outgoing mail, bevor Sie irgendetwas annehmen. Die Karte misst, ob dieser Server das Internet auf Port 25 erreichen kann, und sagt es klar. Meldet sie den Port als blockiert, richten Sie ein Relay über das Formular auf derselben Karte ein — siehe E-Mail-Zustellbarkeit & Versand. Ein funktionierendes Relay zeigt status=sent im Mail-Log.

Sagt die Karte, Port 25 sei offen, ist die Blockade nicht Ihr Problem und die Ursache liegt woanders: Prüfen Sie die Rückweisungsnachricht des Empfängers und prüfen Sie SPF/DKIM/DMARC unten.

Mail wird gesendet, landet aber im Spam

Die Nachricht ist nicht vollständig authentifiziert. Prüfen Sie, dass alle drei für die sendende Domain veröffentlicht sind und bestehen:

  • SPF enthält Ihr Relay (z. B. include:spf.brevo.com).
  • DKIM — die Domain ist in Ihrem Relay verifiziert und ihre DKIM-Records sind in Ihrem DNS.
  • DMARC — ein v=DMARC1; p=none; …-Record existiert (Nimbopanel fügt pro Domain einen hinzu).

Eingehende E-Mail kommt nie an

  • Bestätigen Sie, dass der MX-Record der Domain auf mail.yourdomain.com zeigt und dass mail.yourdomain.com auf Ihren Server auflöst.
  • Stellen Sie sicher, dass der eingehende Port 25 in Ihrer Cloud-Firewall offen ist (der eingehende Port 25 ist fast nie blockiert — nur der ausgehende).

Eine Werkzeugseite (Webmail, phpMyAdmin) zeigt einen Fehler oder lädt nicht

  • phpMyAdmin gibt ohne Panel-Sitzung 401 zurück — das ist erwartet; öffnen Sie es von innerhalb des Panels (Single Sign-on).
  • Keine der beiden Kacheln erscheint im Panel eines Kunden — sie gibt es nur unter Debian/Ubuntu. Auf AlmaLinux, Rocky und RHEL blendet das Panel beide aus, statt einen Kunden auf eine nicht vorhandene Seite zu schicken. Das ist Absicht, kein Fehler.
  • Webmail / eine Website gibt 502 zurück — ein PHP-Dienst könnte neu gestartet worden sein. Prüfen Sie die Dienste mit systemctl status. Bleibt es nach einem Moment bestehen, führen Sie den Updater erneut aus (sudo nimbopanel update), um die verwaltete Konfiguration erneut anzuwenden.

Probleme mit der Website eines Kunden

  • Eine Regel in .htaccess bewirkt nichts. Die Website ist im übersetzten Modus. Drücken Sie entweder Translate now unter Domains → Apache / .htaccess oder aktivieren Sie die volle .htaccess-Unterstützung. Die Tabelle auf jener Seite listet genau, welche Direktiven übersprungen werden. Siehe .htaccess — die zwei Modi.
  • Jede Seite gibt 500 zurück, sofort nach dem Umschalten auf volle .htaccess-Unterstützung. Apache fehlt ein Modul, das die Datei benötigt — mod_rewrite ist das übliche, und es ist unter Debian und Ubuntu standardmäßig aus. Führen Sie den Installer erneut aus (sudo nimbopanel update), der die erforderlichen Module aktiviert; schalten Sie das Konto in der Zwischenzeit zurück.
  • Jede Seite gibt 502 zurück bei einem Konto im vollen .htaccess-Modus, während andere Websites in Ordnung sind. Apache läuft nicht: systemctl status apache2 (Debian/Ubuntu) oder httpd (RHEL-Familie).
  • Die Website gibt 404 zurück oder zeigt ein leeres Verzeichnis nach einer Änderung des Document Root. Der Ordner wird genau so veröffentlicht, wie eingetippt, und wird angelegt, falls er nicht existiert, sodass ein Tippfehler einen leeren Ordner statt eines Fehlers erzeugt. Lesen Sie den Wert in der Zeile der Domain und korrigieren Sie ihn. Siehe Aus einem anderen Ordner als public_html veröffentlichen.
  • Die .env- oder Konfigurationsdatei einer Website ist herunterladbar. Der Document Root liegt darüber. Verschieben Sie den Document Root in den public-Ordner der Anwendung; curl -sI https://domain/.env sollte mit 403 antworten.

Alle Websites gingen auf einmal offline

Wenn alle Websites im selben Moment ausfielen, läuft üblicherweise php-fpm nicht. Prüfen Sie mit systemctl status php*-fpm. Weigert es sich mit Address already in use zu starten, während kein php-fpm-Prozess läuft, wurde eine veraltete Socket-Datei von einem Prozess hinterlassen, der abrupt starb — aktuelle Nimbopanel-Versionen räumen diese vor dem Start selbst auf.

Wo Sie nachsehen

  • Panel- und Dienstprotokolle liegen im systemd-Journal: journalctl -u nimbopanel -n 50.
  • Ergebnisse der Mail-Zustellung: journalctl -t postfix/smtp --since -10min (achten Sie auf status=sent / status=bounced).
  • Das Installationsprotokoll liegt unter /var/log/nimbopanel-install.log.

Immer noch festgefahren? Notieren Sie das genaue Symptom und die relevante Log-Zeile — das reicht meist, um es schnell einzugrenzen.