Upload scheitert mit „Permission denied“: Dateirechte klären
Kurz gesagt: Wenn Bild-Uploads, Plugin-Updates oder Exporte mit „Permission denied“ oder „Failed to open stream“ scheitern, darf der Prozess, der die Datei schreibt, das Zielverzeichnis nicht beschreiben. Fast immer liegt das an einem Unterschied zwischen dem Benutzer, unter dem Ihr Web-Server oder PHP-FPM läuft, und dem Eigentümer der Dateien, etwa nach einem Upload per FTP oder einem Umzug. Die Lösung ist nicht chmod 777, sondern eine klare Regel: wem die Dateien gehören, welche Verzeichnisse beschreibbar sein müssen und welche Rechte genügen. Dieser Artikel zeigt, wie Sie den Fehler eingrenzen und sauber beheben.
Wer schreibt eigentlich?
Ein Upload landet nicht als „Sie“ auf dem Server, sondern als der Benutzer des Prozesses, der die Anfrage verarbeitet. Bei PHP-FPM legt die Pool-Konfiguration diesen Benutzer fest. Die PHP-Dokumentation zur FPM-Konfiguration nennt die Option user als „Unix user of FPM processes“ und als Pflichtangabe, dazu group. Je nach Distribution heißt dieser Benutzer www-data, nginx, apache oder hat bei Hosting-Panels einen eigenen Namen pro Website.
Den laufenden Benutzer finden Sie schnell heraus:
ps -eo user,comm | grep -E 'php-fpm|nginx|apache|httpd' | sort | uniq
Danach prüfen Sie Eigentümer und Rechte des Zielverzeichnisses:
ls -ld /var/www/shop/uploads
namei -l /var/www/shop/uploads/2026
namei -l zeigt den gesamten Pfad Stufe für Stufe. Das ist wichtig, weil schon ein einziges übergeordnetes Verzeichnis ohne Ausführrecht den Zugriff blockiert, auch wenn der Zielordner selbst korrekt eingestellt ist.
Rechte in Kürze lesen
Linux unterscheidet für Eigentümer, Gruppe und alle anderen je Lesen (r), Schreiben (w) und Ausführen (x). Bei Verzeichnissen bedeutet x, dass man hineinwechseln darf, und w, dass man darin Dateien anlegen, umbenennen oder löschen darf. Die Handbuchseiten chmod(1) und chown(1) beschreiben, wie Sie Rechte in symbolischer oder oktaler Schreibweise setzen und Eigentümer ändern, auch rekursiv.
Ein praxistaugliches Muster für Websites sieht so aus:
- Verzeichnisse mit 755 oder 750, Dateien mit 644 oder 640.
- Nur die Verzeichnisse, in die die Anwendung schreiben muss, bekommen Schreibrechte für den Web-Benutzer: Uploads, Cache, temporäre Dateien.
- Konfigurationsdateien mit Zugangsdaten so restriktiv wie möglich, lesbar für den Web-Benutzer, aber nicht für alle.
Häufige Ursachen
Upload per FTP oder SFTP mit anderem Benutzer. Dateien, die Sie als Ihr eigener Benutzer hochladen, gehören Ihnen. Will PHP später dort schreiben, fehlt das Recht.
Umzug oder Wiederherstellung aus Backup. Beim Entpacken als root gehören plötzlich alle Dateien root.
Neue Unterordner entstehen mit falscher Gruppe. Legt ein Deploy-Skript als anderer Benutzer einen Monatsordner an, kann PHP dort nichts ablegen.
Ein restriktiver Standard für neue Dateien. Die umask eines Dienstes bestimmt, mit welchen Rechten er neue Dateien anlegt. Ist sie sehr streng, kann ein zweiter Prozess die Datei nicht mehr bearbeiten.
Sicherheitsmodule. Auf manchen Systemen verhindert SELinux oder AppArmor das Schreiben, obwohl die klassischen Rechte stimmen. Ein Hinweis darauf sind Einträge im Audit-Protokoll.
Sauber beheben
Legen Sie zuerst fest, wem die Dateien gehören sollen. Zwei Modelle sind verbreitet:
- Ein Deploy-Benutzer besitzt den Code, der Web-Benutzer darf nur in bestimmte Ordner schreiben. Das ist das sicherere Modell, weil ein Angreifer, der über die Website Code ausführt, nicht die Programmdateien selbst ändern kann.
- Der Web-Benutzer besitzt alles. Das ist bequemer, etwa wenn das CMS sich selbst aktualisieren soll, erhöht aber das Risiko.
Für Modell 1 setzen Sie die Gruppe des Upload-Ordners auf die Gruppe des Web-Servers und vererben sie an neue Unterordner mit dem setgid-Bit:
sudo chown -R deploy:www-data /var/www/shop/uploads
sudo find /var/www/shop/uploads -type d -exec chmod 2775 {} +
sudo find /var/www/shop/uploads -type f -exec chmod 664 {} +
Die 2 vor 775 ist das setgid-Bit für Verzeichnisse. Neue Dateien und Ordner darin übernehmen dann die Gruppe des übergeordneten Ordners. Passen Sie Benutzer- und Gruppennamen an Ihr System an.
Wenn danach immer noch Fehler auftreten, prüfen Sie die Protokolle von PHP-FPM und des Web-Servers. Dort steht meist der vollständige Pfad, an dem der Zugriff scheiterte.
Warum 777 keine Lösung ist
chmod -R 777 macht den Fehler sofort weg, weil dann jeder Benutzer auf dem System alles schreiben darf. Auf geteilten Servern betrifft das auch andere Kunden, und auf dem eigenen Server erleichtert es Angreifern, Schadcode abzulegen. Außerdem verdeckt es die eigentliche Ursache, die beim nächsten Deploy wieder auftaucht. Wer einmal 777 gesetzt hat, sollte es nach der Fehlersuche wieder zurücknehmen.
Rechte dauerhaft richtig halten
Damit der Fehler nicht nach jedem Update zurückkommt, gehört die Rechtevergabe in den Ablauf, nicht in die Erinnerung einzelner Personen. Schreiben Sie die Befehle für Eigentümer und Rechte als festen Schritt ins Deploy-Skript, direkt nach dem Kopieren der Dateien. Wer per SFTP arbeitet, kann im Programm einstellen, mit welchen Rechten neue Dateien angelegt werden, und sollte sich mit dem Deploy-Benutzer anmelden statt mit einem persönlichen Konto.
Halten Sie außerdem schriftlich fest, welche Ordner beschreibbar sein müssen. Diese Liste ist kürzer, als viele denken: meist Uploads, Cache, temporäre Dateien und vielleicht ein Ordner für Exporte. Alles andere darf schreibgeschützt bleiben. Wenn ein neues Plugin plötzlich Schreibrechte an ungewöhnlicher Stelle verlangt, ist das ein guter Anlass nachzufragen, wozu. Und testen Sie nach jedem Serverumzug einen Upload, bevor Sie die alte Umgebung abschalten.
Beispiel zur Veranschaulichung
Eine Fahrradwerkstatt in Freiburg (Beispiel zur Veranschaulichung) zieht ihre Website auf einen neuen Server und spielt das Backup als root ein. Danach scheitern Bild-Uploads mit „Failed to open stream: Permission denied“. ls -ld zeigt root als Eigentümer des Upload-Ordners, PHP-FPM läuft als www-data. Die Agentur setzt Eigentümer deploy, Gruppe www-data, Verzeichnisse auf 2775 und Dateien auf 664. Der Code bleibt für PHP schreibgeschützt. Uploads funktionieren wieder, und neue Monatsordner erben die richtige Gruppe.
Typische Fehler
- Rechte nur am Zielordner prüfen, nicht am ganzen Pfad.
- Mit 777 „reparieren“ und es danach vergessen.
- Rekursiv auf alles Schreibrechte setzen, auch auf Programmcode und Konfiguration.
- Nach jedem Deploy von Hand nachbessern, statt das Deploy-Skript anzupassen.
- Sicherheitsmodule wie SELinux übersehen, wenn klassische Rechte korrekt sind.
Häufige Fragen
Wie finde ich heraus, als welcher Benutzer PHP läuft?
Mit ps wie oben gezeigt oder in der Pool-Konfiguration von PHP-FPM unter user und group.
Reicht es, nur den Upload-Ordner zu ändern?
Meist ja, sofern alle übergeordneten Verzeichnisse für den Web-Benutzer betretbar sind. Prüfen Sie den Pfad mit namei -l.
Was bewirkt das setgid-Bit genau?
Bei Verzeichnissen sorgt es dafür, dass neue Dateien und Unterordner die Gruppe des Verzeichnisses übernehmen statt der Hauptgruppe des anlegenden Benutzers.
Darf das CMS sich selbst aktualisieren?
Das ist eine Abwägung zwischen Komfort und Sicherheit. Wenn Sie Updates über ein Deploy einspielen, braucht das CMS keine Schreibrechte auf den eigenen Code.
Wenn Uploads oder Updates auf Ihrem Server immer wieder an Rechten scheitern und Sie eine dauerhafte Regel möchten, richten wir sie gern gemeinsam ein: Dateirechte prüfen lassen.