Come appare il messaggio
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.Cause frequenti
- Nextcloud gira dietro nginx, Apache, Traefik, HAProxy o un proxy Docker, ma
trusted_proxiesmanca inconfig.php. - Il proxy non invia
X-Forwarded-For,X-Forwarded-ProtoeHost. overwriteprotocolooverwrite.cli.urlnon corrispondono all'indirizzo pubblico (http contro https).- Più di un passaggio, ad esempio Cloudflare, poi nginx, poi il container Nextcloud, e solo uno è considerato fidato.
- Il caso opposto: non c'è alcun proxy, ma
trusted_proxieselenca ancora un vecchio indirizzo.
Verifica
- Di quali proxy si fida Nextcloud?
- Il protocollo è forzato correttamente?
sudo -u www-data php occ config:system:get overwriteprotocol - Quali header imposta il proxy?
grep -rnE 'proxy_set_header|X-Forwarded' /etc/nginx/ - Controlla la risposta dell'istanza (l'avviso è in Impostazioni → Amministrazione → Panoramica)
curl -sI https://cloud.example.com/status.php
Soluzione
- Aggiungi l'indirizzo del proxy:
sudo -u www-data php occ config:system:set trusted_proxies 0 --value=192.0.2.10. Un indice per ogni proxy. - Forza il protocollo pubblico:
sudo -u www-data php occ config:system:set overwriteprotocol --value=https. - Fai inviare gli header al proxy:
proxy_set_header Host $host;,proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;eproxy_set_header X-Forwarded-Proto $scheme;. - Dietro Cloudflare aggiungi i suoi intervalli di indirizzi a
trusted_proxiese impostaforwarded_for_headerssuHTTP_CF_CONNECTING_IP. - Se non c'è alcun proxy, rimuovi
trusted_proxieseforwarded_for_headers.
Scenario tipico
Nextcloud gira come container Docker dietro Nginx Proxy Manager. Nel pannello di amministrazione compare l'avviso sulla configurazione del reverse proxy e in nextcloud.log ogni richiesta ha come remoteAddr l'indirizzo 172.18.0.1. È il bridge di Docker, non il visitatore. Apri una riga del log, annota l'indirizzo in remoteAddr e controlla con occ config:system:get trusted_proxies se proprio quello è elencato. Solo dopo guarda la configurazione del proxy, perché lì nascono gli header che Nextcloud valuta. Non toccare overwritehost finché non conosci l'indirizzo.
Domande frequenti
Perché si parla di problema di sicurezza?
Nextcloud crede all'IP inoltrato solo se arriva da proxy fidati. Altrimenti chiunque potrebbe inviare un header falso e nascondersi dietro un indirizzo diverso, aggirando anche la protezione brute force.
Perché tutti gli utenti mostrano lo stesso IP?
Perché Nextcloud vede l'indirizzo del proxy. Allora la protezione brute force può rallentare tutti gli utenti insieme, vedi too many requests.
Quale indirizzo inserisco in trusted_proxies con Docker?
L'indirizzo da cui Nextcloud vede arrivare le richieste del proxy, cioè remoteAddr nel log. Con Docker è spesso il gateway o l'IP del container proxy nella rete condivisa. Puoi usare anche un intervallo in notazione CIDR, per esempio la subnet Docker del proxy.
L'avviso sparisce se imposto solo overwriteprotocol?
No. overwriteprotocol corregge lo schema, cioè https invece di http nei link generati. L'avviso riguarda invece la fiducia nel proxy e l'header X-Forwarded-For. Di solito servono entrambe le impostazioni; ognuna risolve un sintomo diverso.
Che cosa cambia se ci sono due proxy in sequenza?
Allora tutti i proxy presenti nella catena devono essere elencati come fidati, altrimenti Nextcloud prende la voce del salto non fidato come indirizzo del client. Gli header letti si controllano con forwarded_for_headers; il predefinito è X-Forwarded-For.