So sieht die Meldung aus
The reverse proxy header configuration is incorrect. This is a security issue and can allow an attacker to spoof their IP address as visible to the Nextcloud.Häufige Ursachen
- Nextcloud läuft hinter nginx, Apache, Traefik, HAProxy oder einem Docker-Proxy, aber
trusted_proxiesfehlt in derconfig.php. - Der Proxy sendet
X-Forwarded-For,X-Forwarded-ProtoundHostnicht mit. overwriteprotocoloderoverwrite.cli.urlpassen nicht zur öffentlichen Adresse (http gegen https).- Mehr als eine Station, z. B. Cloudflare, dann nginx, dann der Nextcloud-Container, und nur eine davon ist vertraut.
- Der umgekehrte Fall: Es gibt keinen Proxy, aber
trusted_proxiesnennt noch eine alte Adresse.
Prüfen
- Welchen Proxys vertraut Nextcloud?
- Ist das Protokoll richtig erzwungen?
sudo -u www-data php occ config:system:get overwriteprotocol - Welche Header setzt der Proxy?
grep -rnE 'proxy_set_header|X-Forwarded' /etc/nginx/ - Antwort der Instanz prüfen (die Warnung steht unter Einstellungen → Verwaltung → Übersicht)
curl -sI https://cloud.example.com/status.php
Lösung
- Die Adresse des Proxys eintragen:
sudo -u www-data php occ config:system:set trusted_proxies 0 --value=192.0.2.10. Pro Proxy einen eigenen Index nutzen. - Das öffentliche Protokoll erzwingen:
sudo -u www-data php occ config:system:set overwriteprotocol --value=https. - Den Proxy die Header senden lassen:
proxy_set_header Host $host;,proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;undproxy_set_header X-Forwarded-Proto $scheme;. - Hinter Cloudflare dessen Adressbereiche in
trusted_proxieseintragen undforwarded_for_headersaufHTTP_CF_CONNECTING_IPsetzen. - Gibt es keinen Proxy,
trusted_proxiesundforwarded_for_headersentfernen.
Typisches Szenario
Nextcloud läuft als Docker-Container hinter Nginx Proxy Manager. In der Admin-Übersicht steht die Warnung zur Reverse-Proxy-Konfiguration, und im nextcloud.log trägt jeder Zugriff als remoteAddr die Adresse 172.18.0.1. Das ist die Docker-Bridge, nicht der Besucher. Öffne eine Log-Zeile, notiere die Adresse unter remoteAddr und prüfe mit occ config:system:get trusted_proxies, ob genau sie eingetragen ist. Schau erst danach in die Proxy-Konfiguration, denn dort entstehen die Header, die Nextcloud auswertet. Ändere noch nichts an overwritehost, bevor die Adresse feststeht.
Häufige Fragen
Warum heißt das Sicherheitsproblem?
Nextcloud glaubt die weitergeleitete IP nur vertrauten Proxys. Sonst könnte jeder einen gefälschten Header senden und sich hinter einer falschen Adresse verstecken, was auch den Brute-Force-Schutz aushebelt.
Warum zeigen alle Nutzer dieselbe IP?
Weil Nextcloud die Adresse des Proxys sieht. Dann kann der Brute-Force-Schutz alle Nutzer gleichzeitig bremsen, siehe Too many requests.
Welche Adresse trage ich bei trusted_proxies in Docker ein?
Die Adresse, von der Nextcloud die Anfragen des Proxys sieht, also remoteAddr im Log. Bei Docker ist das oft das Gateway oder die IP des Proxy-Containers im gemeinsamen Netz. Du kannst auch einen Bereich in CIDR-Schreibweise nehmen, etwa das Docker-Subnetz des Proxys.
Verschwindet die Warnung, wenn ich nur overwriteprotocol setze?
Nein. overwriteprotocol korrigiert das Schema, also https statt http in erzeugten Links. Die Warnung betrifft dagegen die Vertrauensstellung zum Proxy und den Header X-Forwarded-For. Meist brauchst du beide Einstellungen, jede löst ein anderes Symptom.
Was ändert sich, wenn zwei Proxys hintereinander stehen?
Dann müssen alle Proxys, die in der Kette auftauchen, als vertrauenswürdig eingetragen sein, sonst nimmt Nextcloud den Eintrag des nicht vertrauten Hops als Client-Adresse. Welche Header ausgewertet werden, steuert forwarded_for_headers; der Standard ist X-Forwarded-For.