Nextcloud-Upload-Limit von 2 GB beheben: So erlauben Sie das Hochladen großer Dateien

Ein Nextcloud-Upload, der bei 2 GB abbricht, wird üblicherweise durch eine einzelne Ebene im Upload-Prozess begrenzt, nicht durch eine zentrale Nextcloud-Einstellung. Um größere Dateien zu akzeptieren, legen Sie auf jeder Ebene, die den Upload verarbeitet – PHP, Webserver und gegebenenfalls Reverse-Proxy oder Hosting-Panel – eine Zielgröße oberhalb der Dateigröße fest. Prüfen Sie anschließend, ob Speicherplatz, temporärer Speicherplatz und die Timeout-Grenzen für die Übertragung ausreichen.

Diese Anleitung verwendet ein Ziel von 5 GB als Beispiel für Dateien bis zu ca. 4 GB. Wählen Sie ein Limit, das Ihrem tatsächlichen Anwendungsfall entspricht, berücksichtigen Sie gegebenenfalls den zusätzlichen Aufwand bei Anfragen und halten Sie die Einstellung in Ihrer gesamten Infrastruktur einheitlich. Die Beispiele beziehen sich auf einen selbstverwalteten Nextcloud-Server mit PHP; bei Managed Hosting, Containern und Appliances können andere Konfigurationspfade vorhanden sein.

Warum ein 2-GB-Upload fehlschlagen kann

Das aktuelle Nextcloud-Administrationshandbuch erklärt, dass große Uploads durch PHP- und Webserver-Konfigurationen eingeschränkt sein können. Bei Chunked Uploads sendet der Browser oder Client Teile, die Nextcloud zusammensetzt. Einige PHP-Dateigrößenanweisungen regeln diese Anfragen möglicherweise nicht, während Webserver- oder PHP-Timeouts weiterhin Einfluss nehmen können. Ein Proxy, eine Firewall, ein Speichersystem, ein Benutzerkontingent oder ein voller temporärer Speicherplatz können weitere Einschränkungen bedingen. Weitere Informationen finden Sie im Nextcloud-Administrationshandbuch für große Datei-Uploads und im Nextcloud-Benutzerhandbuch für große Uploads .

„2 GB“ kann auch 2.000.000.000 Byte oder 2 GiB (2.147.483.648 Byte) bedeuten. Angezeigter Grenzwert und tatsächlicher Byte-Schwellenwert stimmen möglicherweise nicht exakt überein. Notieren Sie den Fehler, die Dateigröße in Byte und ob der Fehler sofort oder erst nach Beginn des Vorgangs auftritt. Diese Angaben helfen dabei, die zu untersuchende Ebene zu identifizieren.

1. Identifizieren Sie die erste Ebene, die den Upload ablehnt.

Bevor Sie die Einstellungen ändern, notieren Sie sich, wie die Datei hochgeladen wurde: über die Nextcloud-Weboberfläche, den Desktop- oder mobilen Synchronisierungsclient oder eine WebDAV-Anwendung. Testen Sie eine Datei, die etwas größer als der bisherige Grenzwert ist, laden Sie aber während der Fehlersuche nicht wiederholt mehrere Gigabyte große Dateien hoch. Überprüfen Sie zum Zeitpunkt des Fehlers die Nextcloud-Administrationsübersicht und das Protokoll, das Webserver-Fehlerprotokoll, die PHP-FPM- oder Apache-Protokolle sowie alle Proxy- oder Hosting-Dashboards.

• Eine sofortige HTTP-413-Antwort deutet oft auf eine Beschränkung des Anfragetextes durch den Webserver oder Proxy hin.
• Eine PHP-Warnung, dass eine Datei die zulässige Größe überschreitet, verweist auf die PHP-Upload-Einstellungen für eine herkömmliche Multipart-Anfrage.
• Eine Übertragung, die zwar startet, aber ins Stocken gerät oder einen Timeout verursacht, deutet auf Anforderungstimeouts, eine unterbrochene Verbindung oder Ressourcenengpässe hin.
• Eine eindeutige Quotenmeldung bedeutet, dass der verfügbare Nextcloud-Speicher des Benutzers und nicht die Upload-Beschränkung des Servers das Problem darstellt.

Dies sind Hinweise, keine endgültigen Diagnosen: Ein Proxy kann einen Anwendungsfehler ersetzen, und die Protokolle unterscheiden sich je nach Bereitstellung. Vergleichen Sie die Zeitstempel der verschiedenen Ebenen, bevor Sie die Konfiguration bearbeiten.

2. PHP-Limits für Browser-Formular-Uploads festlegen

Suchen Sie die PHP-Konfiguration, die vom Nextcloud-Webprozess verwendet wird. Unter Debian oder Ubuntu befindet sich eine typische PHP-FPM-Datei unter `/usr/php/ php /etc/php/<version>/fpm/php.ini-fpm`; Apache mit mod_php verwendet üblicherweise eine separate Datei apache2/php.ini. Die PHP-Befehlszeilenkonfiguration kann abweichen, daher ändert die alleinige Bearbeitung der von `nextcloud.php` angegebenen Datei möglicherweise nichts an der Website. Die PHP-Konfigurationsanleitungphp --ini von Nextcloud beschreibt den serverseitigen Konfigurationskontext.

Bei einer Speicherbegrenzung von 5 GB überprüfen Sie bitte folgende Einstellungen in der aktiven Web-PHP-Konfiguration:

upload_max_filesize = 5G
post_max_size = 5G
max_input_time = 3600
max_execution_time = 3600

post_max_sizeDie Upload-Dauer sollte mindestens so groß sein wie die upload_max_filesizeUpload-Dauer. Die Einstellung beider Werte auf denselben Zielwert ist ein praktischer Ausgangspunkt für einen Multipart-Upload einer einzelnen Datei. Die oben genannten Zeitangaben sind Beispiele und keine Garantie für den erfolgreichen Abschluss der Übertragung: Wählen Sie eine Dauer, die Ihrer verfügbaren Bandbreite und Ihren Betriebsrichtlinien entspricht. Erhöhen Sie die maximale Upload-Dauer in PHP nicht memory_limitauf 5 GB, nur weil die Datei 5 GB groß ist. PHP dokumentiert, dass die max_input_timeUpload-Dauer die Zeit für den Empfang von Upload-Eingaben beinhaltet und dass das Upload-Verhalten von den entsprechenden Direktiven abhängt; konsultieren Sie die Dokumentation zu häufigen Fehlern beim PHP-Upload .

3. Erhöhen Sie das Anfragelimit des Webservers.

Nginx mit PHP-FPM

Legen Sie im aktiven Nginx-Serverblock für Nextcloud eine Obergrenze für den Anfragetext fest, die die größte zu akzeptierende Datei nicht überschreitet. Beispiel: 5 GB

client_max_body_size 5G;

Platzieren Sie die Direktive im entsprechenden httpKontext , serverum locationeinen Konflikt mit einem niedrigeren Wert in einem spezifischeren Block zu vermeiden. Nginx dokumentiert diese Direktive in seiner Kernmodulreferenz . Das Installationsbeispiel für Nextcloud mit Nginx enthält außerdem Einstellungen für Upload-Größe und Timeout. Überprüfen Sie die Konfiguration sudo nginx -tvor dem Neustart von Nginx.

Apache

Prüfen Sie, ob der aktive virtuelle Host, die Verzeichniskonfiguration oder die eingebundene Konfiguration die erforderlichen Werte festlegt LimitRequestBody. Bei Apache-Versionen, deren Standard- oder explizite Obergrenze niedriger als Ihr Zielwert ist, erhöhen Sie diese auf die benötigte Byteanzahl oder verwenden Sie 0die Option „keine Apache-Beschränkung“ nur dann, wenn dies für Ihre Bereitstellung akzeptabel ist. Stellen Sie sicher, dass die Direktive in einem Kontext platziert ist, der von Ihrer Apache-Version und -Konfiguration zugelassen wird. Apache beschreibt das Verhalten in der Dokumentation zu LimitRequestBody . Führen Sie den Befehl apachectl configtestvor dem Neuladen des Dienstes aus.

4. Überprüfen Sie Reverse-Proxys, Container und Speicher.

Wenn der Datenverkehr über eine andere Nginx-Instanz, einen Load Balancer, ein Hosting-Control-Panel oder einen Sicherheitsproxy geleitet wird, müssen dessen Beschränkungen hinsichtlich Body-Größe und Timeout den Upload ebenfalls zulassen. Eine Anfrage kann abgelehnt werden, bevor sie Nextcloud erreicht. Aktualisieren Sie nur die Ebene, die diese Einstellung verwaltet, und überprüfen Sie anschließend deren Logs und Antwortcode. Ändern Sie bei Docker oder anderen Container-Bereitstellungen die in den laufenden Container eingebundene Konfiguration oder die unterstützten Umgebungseinstellungen für dieses Image; eine Host-PHP-Datei wird vom Container möglicherweise gar nicht verwendet.

Große Uploads verbrauchen ebenfalls Ressourcen. Stellen Sie sicher, dass das Nextcloud-Datenvolume über ausreichend freien Speicherplatz verfügt und das temporäre Verzeichnis von PHP oder des Webservers die Arbeitslast bewältigen kann. Bei Chunk-Uploads kann temporärer Speicherplatz erforderlich sein, während die Chunks zusammengesetzt werden; Objektspeicher-Bereitstellungen benötigen möglicherweise zusätzlichen temporären Speicherplatz. Planen Sie mehrere Uploads gleichzeitig ein, nicht nur eine Datei mit maximaler Größe. Lesen Sie den Abschnitt von Nextcloud zu temporärem Speicherplatz und Uploads großer Dateien, bevor Sie das Limit in einer stark ausgelasteten Installation erhöhen.

5. Änderungen anwenden und mit einem kontrollierten Test überprüfen.

Nachdem die Konfigurationsprüfungen erfolgreich waren, laden oder starten Sie die entsprechenden PHP-FPM- und Webserver-Dienste neu, damit diese die aktualisierten Einstellungen übernehmen. Die genauen Dienstnamen variieren je nach Distribution und PHP-Version. Vermeiden Sie es, nicht benötigte Produktionsdienste neu zu starten. Laden Sie anschließend eine Datei hoch, die knapp über der vorherigen 2-GB-Grenze liegt – beispielsweise eine bekannte Testdatei mit ca. 2,1 GB – und verwenden Sie dabei denselben Client und dieselbe Route, die ursprünglich fehlgeschlagen ist. Achten Sie darauf, dass die Testdatei unter dem neuen Limit bleibt, und überwachen Sie den freien Speicherplatz, die Protokolle und den Übertragungsfortschritt.

Ein erfolgreicher Test sollte ohne HTTP-Größenfehler oder Timeout abgeschlossen werden, die Datei im vorgesehenen Nextcloud-Ordner landen und beim Überprüfen vom Client eine plausible Dateigröße aufweisen. Bei wichtigen Dateien empfiehlt es sich, die Prüfsummen von Quell- und Zielverzeichnis zu vergleichen, sofern Ihr Workflow dies unterstützt. Ein Fortschrittsbalken, der 100 % erreicht, bestätigt nicht automatisch die Vollständigkeit der gespeicherten Datei.

Wenn diese Lösung nicht ausreicht

• Der Web-Upload funktioniert, der Desktop-Client jedoch nicht: Überprüfen Sie das Timeout-Verhalten von Client, Proxy und Server. Nextcloud-Clients verwenden Chunked Uploads, daher behebt eine Änderung der PHP-Konfiguration upload_max_filesizeallein möglicherweise kein Problem mit Chunk-Anfragen oder dem finalen Assembly-Timeout.
• Die Fehlermeldung besagt, dass der Speicherplatz des Benutzers erschöpft ist: Passen Sie das Nextcloud-Kontingent oder den freien Speicherplatz dieses Benutzers an; eine Erhöhung des Anforderungslimits schafft keine zusätzliche Kapazität.
• Der Fehler tritt bei jedem Client bei der gleichen Byteanzahl auf: Suchen Sie nach einer gemeinsamen Proxy-, WAF-, Hosting-Provider- oder Webserver-Beschränkung und korrelieren Sie deren Protokolle mit der Anfrage.
• Die Uploads werden zwar abgeschlossen, belegen aber zu viel temporären Speicherplatz: Reduzieren Sie die Anzahl gleichzeitiger Uploads, stellen Sie ausreichend temporären Speicherplatz sicher oder überprüfen Sie das dokumentierte Chunking- und Speicherverhalten Ihres Backends.

Durch die Erhöhung des Upload-Limits können Nutzer mehr Daten an den Server senden. Daher sollte dies mit Quoten, Überwachung, ausreichendem Speicherplatz und sinnvollen Zugriffskontrollen einhergehen. Es gibt kein allgemeingültiges sicheres Maximum: Die praktische Obergrenze hängt vom langsamsten Faktor im Anfragepfad sowie der Kapazität des Servers und des Speichersystems ab.

Referenzen

• Nextcloud-Server-Administrationshandbuch: Hochladen großer Dateien
• Nextcloud Server-Administrationshandbuch: PHP-Konfiguration
• NGINX-Dokumentation: client_max_body_size
• Apache HTTP Server-Dokumentation: LimitRequestBody
• PHP-Handbuch: Häufige Upload-Fehler