DE EN IT

~/errors / nginx

nginx: connect() to unix:/run/php/php-fpm.sock failed (13: Permission denied) while connecting to upstream

nginx trova il socket di PHP-FPM ma non ha il permesso di aprirlo. Il visitatore vede 502 Bad Gateway. Proprietario, gruppo o modo del socket non corrispondono all'utente con cui gira nginx.

daniele@mikweb: ~/errors — less nginx-php-fpm-socket-13-permission-denied.md

Come appare il messaggio

2026/10/29 10:03:17 [crit] 1234#1234: *321 connect() to unix:/run/php/php8.3-fpm.sock failed (13: Permission denied) while connecting to upstream, client: 203.0.113.5, server: example.com, request: "GET /index.php HTTP/2.0", upstream: "fastcgi://unix:/run/php/php8.3-fpm.sock:"

Cause frequenti

  • L'utente dei worker di nginx (user in nginx.conf) è diverso da listen.owner e listen.group del pool PHP-FPM.
  • listen.mode nel pool è troppo restrittivo e il gruppo non può scrivere sul socket.
  • Un pool separato per un sito gira con un utente proprio e il socket appartiene solo a quell'utente.
  • L'utente nginx non può entrare in una directory superiore del socket.
  • Il percorso in fastcgi_pass punta a un socket di un altro servizio.

Verifica

  1. Proprietario, gruppo e modo del socket
    ls -l /run/php/*.sock
  2. Con quale utente gira nginx?
    grep -E '^\s*user' /etc/nginx/nginx.conf
  3. Impostazioni del pool per il socket
    grep -rEn '^(listen|listen\.owner|listen\.group|listen\.mode|user|group) *=' /etc/php/*/fpm/pool.d/
  4. Si può entrare in ogni directory del percorso?
    namei -l /run/php/php-fpm.sock

Soluzione

  • Nel file del pool sotto /etc/php/<versione>/fpm/pool.d/ imposta listen.owner = www-data, listen.group = www-data e listen.mode = 0660, coerenti con l'utente nginx.
  • In alternativa aggiungi l'utente nginx al gruppo proprietario del socket.
  • Verifica che fastcgi_pass usi esattamente il percorso del socket di questo pool.
  • Riavvia il servizio PHP-FPM della tua versione (il nome contiene la versione) e ricontrolla il socket con ls -l.
  • Testa nginx: nginx -t && systemctl reload nginx.

Domande frequenti

Devo mettere il socket a 0666?

No. Così ogni utente locale può parlare con PHP-FPM. Usa proprietario e gruppo corretti con modo 0660.

In cosa differisce da Primary script unknown?

Qui nginx non raggiunge affatto PHP-FPM. Con Primary script unknown la connessione funziona ma PHP non trova il file dello script.

daniele@mikweb: ~/tools — ls

Strumento utile

daniele@mikweb: ~/errors — ls

Altri errori

cannot load certificatenginx: [emerg] cannot load certificate (PEM no start line, key values mismatch)too big headernginx: upstream sent too big header while reading response headerPrimary script unknownnginx + PHP-FPM: “Primary script unknown” / “File not found.”111: Connection refusednginx: connect() failed (111: Connection refused) verso upstreamupstream prematurely closed connectionnginx: upstream prematurely closed connection while reading response header from upstreamcould not build server_names_hashnginx: [emerg] could not build server_names_hash, you should increase server_names_hash_bucket_size

Nuovi articoli via e-mail

Un'e-mail per ogni nuovo articolo. Nessun tracciamento, puoi annullare quando vuoi. Come ringraziamento dopo la conferma: la mia checklist “Gestione server e patching” (PDF).

← Tutti i codici d'errore