Fehlerbehebung

Panel-Fehler

Wenn Sie einen 500 | SERVER ERROR oder Ein unerwarteter Fehler ist beim Bearbeiten dieser Anfrage aufgetreten sehen, müssen Sie Ihre Panel-Logs überprüfen, indem Sie den folgenden Befehl ausführen.

tail -n 1000 /var/www/pelican/storage/logs/laravel-$(date +%F).log | grep "\[$(date +%Y)"

Wenn der obige Befehl nichts zurückgibt, haben Sie höchstwahrscheinlich falsche Berechtigungen für Ihren storage Ordner. Also müssen Sie das zuerst beheben. Sie können die korrekten Berechtigungen setzen, indem Sie sudo chmod -R 755 /var/www/pelican/storage/* /var/www/pelican/bootstrap/cache/ ausführen. Stellen Sie auch sicher, dass Ihre Panel-Dateien dem korrekten Benutzer gehören.

sudo chown -R www-data:www-data /var/www/pelican
sudo chown -R nginx:nginx /var/www/pelican
sudo chown -R apache:apache /var/www/pelican

Häufige Fehler

  • ErrorException: file_put_contents(_____): failed to open stream: Permission denied: Falsche Dateiberechtigungen/Besitz für die Panel-Dateien, siehe oben.
  • 502 Bad Gateway Error: Stellen Sie sicher, dass php-fpm läuft und dass Sie die korrekte PHP-Version in Ihrer Webserver-Konfiguration verwenden.
  • CSRF token mismatch: Aktivieren Sie SSL für Ihr Panel mit HTTPS-Protokoll-Schema in der APP_URL oder setzen Sie SESSION_SECURE_COOKIE auf false in Ihrer .env Datei.
  • Connection refused [tcp://_______:6379]: Redis läuft nicht oder ist aus anderen Gründen nicht erreichbar. (Beginnen Sie mit der Überprüfung des Status des Redis-Service: systemctl status redis-server)
  • SSL: no alternative certificate subject name matches target host name '_______': Das verwendete SSL-Zertifikat für Ihr Panel ist nicht gültig für Ihre Panel-Domain, siehe diese Anleitung für die Erstellung eines neuen SSL-Zertifikats.
  • General error: 8 attempt to write a readonly database: Ihre database.sqlite hat falsche Dateiberechtigungen und ist schreibgeschützt. Stellen Sie sicher, dass die Datei beschreibbar ist und dem korrekten Benutzer gehört.
  • Class '_____' not found: Das bedeutet normalerweise, dass Ihnen PHP-Erweiterungen fehlen. Stellen Sie sicher, dass alle benötigten Erweiterungen installiert sind und Sie die korrekte PHP-Version verwenden.
  • Connection timed out after 5001 miliseconds for _______:8080: Ihr Panel kann Wings nicht erreichen, siehe die Wings-Verbindungsprobleme-Schritte unten.

Wings-Verbindungsprobleme

Wings-Service überprüfen

Zuerst sollten Sie sicherstellen, dass der Wings-Service läuft. Führen Sie dazu systemctl status wings aus. Es sollte anzeigen, dass der Service aktiv und läuft. Wenn er in einem fehlgeschlagenen Zustand ist, führen Sie sudo wings diagnostics aus, um die Wings-Logs auf Fehler zu überprüfen.

Häufige Fehler

  • open /etc/letsencrypt/live/_____________/fullchain.pem: no such file or directory: Das SSL-Zertifikat für Wings fehlt, siehe diese Anleitung für die Erstellung eines SSL-Zertifikats.
  • Pool overlaps with other one on this address space: Sie haben bereits ein Docker-Netzwerk, das das Standard-Subnetz verwendet. (172.18.0.0/16) Ändern Sie das Subnetz in Ihrer Wings-Konfigurationsdatei und verwenden Sie systemctl stop wings && docker network rm pelican_nw && systemctl start wings, um die Änderung anzuwenden.
  • Error response from Panel: AccessDeniedHttpException: You are not authorized to access this resource. (HTTP/403): Ihr Wings-Token ist falsch, Sie müssen den Token in Ihrer config.yml Datei aktualisieren
  • Error response from Panel: _MissingResponseCode: No error response returned from API endpoint: Ihr Panel antwortet nicht korrekt. Das passiert normalerweise, wenn Cloudflare die Verbindung blockiert. Stellen Sie in diesem Fall sicher, dass Ihre Wings-IP zur Cloudflare-Firewall hinzugefügt wird. Wenn Sie Cloudflare nicht verwenden, könnte es ein anderer CDN/DDoS-Schutz-Service oder Ihr Anbieter sein.
  • remote: could not unmarshal response: invalid character '<' looking for beginning of value: Das ist im Grunde der gleiche Fehler wie oben: Cloudflare blockiert die Verbindung.

Wings-Port überprüfen

Wenn Sie bestätigt haben, dass Wings ohne Fehler läuft, sollten Sie sicherstellen, dass der Wings-Port (standardmäßig 8080) nicht von einer Firewall blockiert wird. Der beste Weg, dies zu überprüfen, ist die Verwendung von Online-Port-Checkern wie dnschecker.org

Es sollte "open" anzeigen, wenn Sie nach Ihrem Node-FQDN (z.B. node.example.com oder 123.123.123.123) und Ihrem Wings-Port (z.B. 8080) suchen. Wenn es "timed-out" anzeigt, haben Sie eine Firewall, die den Port blockiert. Das könnte eine interne Firewall (wie iptables) oder eine externe Firewall (z.B. von Ihrem Anbieter) sein.

NAT-Loopback überprüfen

Wenn sich Ihr Panel und Wings auf derselben Maschine oder demselben Netzwerk befinden und Sie Domains verwenden, sollten Sie NAT-Loopback-Probleme überprüfen. Bearbeiten Sie die /etc/hosts Datei auf Ihrer Panel/Wings-Maschine und fügen Sie einen Eintrag für Ihre IP und Domain hinzu.

/etc/hosts 
123.123.123.123 panel.example.com node.example.com

Wings-Verbindung überprüfen

Wenn Sie die obigen Punkte bestätigt haben, müssen Sie eine erweiterte Fehlerbehebung durchführen.

Panel <-> Wings Verbindung

Führen Sie curl <protokoll><node fqdn>:<node port> (z.B. curl https://node.example.com:8080 oder curl http://123.123.123.123:8080) auf Ihrer Panel-Maschine aus und schauen Sie, was es ausgibt.

Browser <-> Wings Verbindung

Öffnen Sie <protokoll><node fqdn>:<node port> (z.B. https://node.example.com:8080 oder http://123.123.123.123:8080) in Ihrem Browser und schauen Sie, was es ausgibt.

In beiden Fällen sollte es das ausgeben, wenn Wings erreichbar ist:

{"error" : "The required authorization heads were not present in the request."}
Info: Nicht sicher, was ein bestimmter Fehler bedeutet? Besuchen Sie unseren Discord und wir helfen Ihnen gerne!

Node-Einstellungen überprüfen

Wenn die obigen Verbindungsüberprüfungen beide erfolgreich waren, haben Sie möglicherweise die Node-Einstellungen im Panel falsch konfiguriert. Stellen Sie sicher, dass Ihr Node-FQDN/IP, Port und Schema (HTTP/HTTPS) korrekt ist.

Bei der Verwendung eines Reverse-Proxys könnten Sie unterschiedliche externe und interne Ports für Wings haben. (z.B. 80 intern und 443 extern) Stellen Sie in diesem Fall sicher, dass die Node-Einstellungen im Panel den externen Port verwenden, während die Wings-Konfigurationsdatei den internen Port verwendet!

Zeitpläne laufen nicht

Wenn Ihre Zeitpläne bei Processing hängen bleiben oder die Aufgaben nicht ausführen, überprüfen Sie Folgendes:

  • Ist Ihr Zeitplan so eingestellt, dass er NUR LÄUFT, WENN SERVER ONLINE IST und der Server ist gerade offline?
  • Läuft Ihr Queue-Worker-Service? (systemctl status pelican-queue)
  • Verwendet Ihr Queue-Worker-Service die korrekte PHP-Version? (php -v)
  • Ist Ihr Cronjob korrekt eingerichtet? (crontab -l -u www-data sollte einen Eintrag anzeigen, der php artisan schedule:run jede Minute ausführt)

Wenn Ihr Queue-Worker-Service nicht läuft, können Sie auch die Panel-Logs auf Fehler überprüfen.

tail -n 100 /var/www/pelican/storage/logs/laravel-$(date +%F).log | grep "\[$(date +%Y)"

Um den Queue-Worker-Service neu zu erstellen, können Sie php /var/www/pelican/artisan p:environment:queue-service --overwrite ausführen.