Fehlerbehebung

Die meisten Probleme lassen sich auf einige wenige Ursachen zurückführen: PHP-Version, Dateiberechtigungen, Datenbankzugangsdaten, URL-Rewriting des Webservers oder ein fehlender Worker. Diese Seite listet die Symptome auf, mit denen Betreiber am häufigsten konfrontiert werden, und erklärt, wie jedes einzelne behoben werden kann. Im Zweifelsfall ist das PHP-Fehlerprotokoll der schnellste Weg zur Wahrheit.

Installationsprobleme

„Ihre PHP-Version wird nicht unterstützt"

TubePress erfordert PHP 8.2 oder neuer, erzwungen durch einen parse-sicheren Versionsschutz, der vor allem anderen ausgeführt wird. Wechseln Sie die PHP-Version in Ihrem Hosting-Panel (oder verweisen Sie den vhost auf einen neueren PHP-FPM-Socket) und laden Sie die Seite neu. Siehe Systemanforderungen.

„Verbindung zur Datenbank konnte nicht hergestellt werden"

Überprüfen Sie beim Datenbankschritt des Installers nochmals den Host (häufig localhost oder 127.0.0.1), den Datenbanknamen, Benutzer und Passwort sowie ob der Benutzer über die nötigen Rechte für diese Datenbank verfügt. Die Datenbank muss bereits vorhanden sein — der Installer erstellt Tabellen, nicht das Schema selbst.

Der Installer kann die Konfiguration nicht schreiben / Fehler „nicht beschreibbar"

Der Webserver benötigt während der Einrichtung Schreibzugriff auf config/ und storage/. Machen Sie diese Verzeichnisse für den PHP-Benutzer beschreibbar und versuchen Sie es erneut. Siehe die Berechtigungshinweise unter Installation.

Die Installation ist abgeschlossen, aber /install wird noch geladen

Die Installation schreibt config/installed.php. Fehlt diese Datei, geht die Anwendung davon aus, dass sie nicht installiert ist; wurde die Einrichtung abgeschlossen, sollte diese Datei vorhanden sein und der Installer sperrt sich selbst. Überprüfen Sie erneut, ob config/ beschreibbar war.

Die Website lädt, aber Seiten zeigen 404

Wenn die Startseite funktioniert, aber jede andere URL einen 404-Fehler zurückgibt, erreicht das URL-Rewriting den Front-Controller nicht.

• Apache — Bestätigen Sie, dass mod_rewrite aktiviert und AllowOverride All gesetzt ist, damit die mitgelieferte .htaccess berücksichtigt wird.
• Nginx — Ihr location /-Block muss zum Front-Controller durchfallen, z. B. try_files $uri $uri/ /index.php?$query_string;. Siehe Architektur für die Webserver-Hinweise.

Anmeldung & Admin-Zugang

Ich kann die Admin-Anmeldung nicht finden

Wenn Sie eine benutzerdefinierte Admin-URL aus Sicherheitsgründen festgelegt haben, befindet sich das Panel nicht mehr unter /admin — es antwortet nur noch unter Ihrem geheimen Pfad. Stellen Sie ihn aus der Tabelle settings wieder her, wenn Sie Datenbankzugriff haben. Siehe Sicherheit.

Die Zwei-Faktor-Authentifizierung sperrt mich aus

Wenn Sie Ihre Authenticator-App verlieren, deaktivieren Sie das TOTP des Benutzers in der Datenbank (die entsprechende Spalte in der Tabelle users), um wieder Zugang zu erhalten, und registrieren Sie sich erneut. Details unter Sicherheit.

Uploads & Medien

Große Uploads schlagen fehl oder laufen ab

Erhöhen Sie die PHP-Limits upload_max_filesize und post_max_size, und erhöhen Sie bei Nginx den Wert von client_max_body_size. Die Demo ermöglicht Uploads im Gigabyte-Bereich über einen hohen client_max_body_size-Wert; übernehmen Sie das auf Ihrem Server für große Dateien.

Ein Video wird nicht abgespielt

Neu hochgeladene Videos befinden sich möglicherweise noch in der Verarbeitung, bis die Transkodierung abgeschlossen ist. Überprüfen Sie, ob das Format für die Webauslieferung geeignet ist, ob die Rendition-Dateien im Speicher vorhanden sind und ob Ihr Server den korrekten MIME-Typ für .mp4/.webm sendet. Siehe Player.

Thumbnails oder Vorschauen fehlen

Die Thumbnail- und Vorschauerstellung benötigt die GD- oder Imagick-Erweiterung (sowie FFmpeg für videogenerierte Frames). Vergewissern Sie sich, dass diese installiert sind und uploads/ beschreibbar ist.

Transkodierung hängt fest

Wenn Aufträge in der Warteschlange verbleiben und nie abgeschlossen werden:

• Überprüfen Sie, ob FFmpeg installiert ist, wo immer die Transkodierung läuft (lokaler Server oder ein Remote-Worker).
• Wenn Sie externe Transkodierungsserver verwenden, überprüfen Sie, ob der Worker läuft und sein API-Schlüssel mit dem in der Verwaltung konfigurierten übereinstimmt.
• Stellen Sie sicher, dass der Scheduler läuft (siehe unten) — Auftragsverteilung und Wiederholungsversuche laufen über den Pseudo-cron.

Geplante Aufgaben werden nicht ausgeführt

Der Pseudo-cron wird nur bei Seitenaufrufen ausgelöst. Auf einer wenig besuchten Website hält der Heartbeat ihn am Laufen — stellen Sie sicher, dass heartbeat_enabled auf 1 gesetzt ist. Wenn Sie ihn deaktiviert haben, aktivieren Sie ihn erneut oder fügen Sie einen System-cron-Eintrag hinzu, der Ihre Website regelmäßig aufruft.

E-Mails werden nicht gesendet

Konfigurieren Sie SMTP unter E-Mail & Benachrichtigungen und verwenden Sie die integrierte Schaltfläche Test-E-Mail senden zur Bestätigung. Wenn die Tests fehlschlagen, überprüfen Sie SMTP-Host/-Port/-Zugangsdaten und ob Ihr Host ausgehende E-Mails erlaubt; richten Sie für eine gute Zustellbarkeit SPF/DKIM für Ihre Domain ein.

Leistung

Für eine schnelle Website bei höherer Last: aktivieren Sie OPcache, geben Sie PHP genügend Arbeitsspeicher, halten Sie MySQL im selben Netzwerk wie PHP, und lassen Sie die CTR-Neuberechnung und andere geplante Aufgaben laufen. TubePress wird mit den Indizes und chunkbasierten Jobs geliefert, die für große Bibliotheken erforderlich sind — siehe Wartung.

Updates schlagen fehl

Wenn ein Update nicht angewendet werden kann, überprüfen Sie, ob die Kern-Dateien für den PHP-Benutzer beschreibbar sind und ob Sie PHP 8.2+ verwenden. Erstellen Sie immer eine Sicherung vor dem Aktualisieren, damit Sie einen Rollback durchführen können. Siehe Aktualisierung.

Immer noch nicht weiter?

Sammeln Sie die genaue Fehlermeldung und die relevanten Protokollzeilen und öffnen Sie dann ein Ticket über Ihr Dashboard oder das Support-Widget im Admin-Bereich. Je mehr Kontext Sie angeben — PHP-Version, Webserver und was Sie getan haben —, desto schneller kann das Problem gelöst werden. Siehe Ankündigungen & Support.