Come appare il messaggio
psql: error: connection to server at "db.example.com" (203.0.113.20), port 5432 failed: FATAL: no pg_hba.conf entry for host "198.51.100.7", user "appuser", database "appdb", SSL encryptionCause frequenti
- Non esiste una riga
hostper l'indirizzo del client, oppure l'intervallo di indirizzi è troppo stretto o scritto male. - Utente o database non corrispondono alla riga, ad esempio la riga vale per
allutenti ma per un altro database. - Il client usa SSL ma la riga è
hostnossl, o viceversa conhostssl. - Il file è stato modificato ma PostgreSQL non è stato ricaricato.
- Il client arriva da un indirizzo diverso da quello atteso, ad esempio una rete Docker, un NAT o un proxy.
Verifica
- Quali regole usa davvero il server, in ordine? Mostra anche gli errori nel file
sudo -u postgres psql -c 'SELECT line_number, type, database, user_name, address, auth_method, error FROM pg_hba_file_rules' - Su quali indirizzi è in ascolto il server?
sudo -u postgres psql -c 'SHOW listen_addresses' - La porta è aperta sul server?
sudo ss -tlnp | grep 5432 - L'indirizzo visto dal server: è nel testo dell'errore. Anche nel log
sudo tail -n 20 /var/log/postgresql/postgresql-*-main.log
Soluzione
- Prendi indirizzo, utente, database e modalità SSL dal testo dell'errore. È esattamente ciò che ha visto il server.
- Aggiungi una riga stretta a
pg_hba.conf, ad esempiohostssl appdb appuser 198.51.100.7/32 scram-sha-256. Usa l'indirizzo reale del client o un piccolo intervallo. - Ricarica:
sudo systemctl reload postgresql, poi controlla di nuovo l'elenco delle regole. - Non usare
0.0.0.0/0contrust. Lascia entrare chiunque in rete senza password. - Se il server non è raggiungibile affatto (connection refused), il passo successivo sono
listen_addresseso il firewall.
Scenario tipico
Sposti l'applicazione su una VM propria mentre il database resta sul vecchio server. Al primo avvio il log dice "no pg_hba.conf entry for host 198.51.100.7, user app, database appdb, no encryption". Il server è raggiungibile, ma il suo file di accesso non conosce questa combinazione. Il "no encryption" finale significa che il client è arrivato senza SSL; controlla se in pg_hba.conf ci sono solo righe hostssl.
Domande frequenti
Devo riavviare PostgreSQL?
No. Per pg_hba.conf basta un reload: systemctl reload postgresql oppure SELECT pg_reload_conf();.
L'indirizzo del client nell'errore non è il mio.
Allora un proxy, un NAT o il bridge Docker cambia l'indirizzo di origine. Scrivi la regola per l'indirizzo che il server riporta, oppure correggi il percorso di rete.
Che cosa significa "no encryption" nel messaggio?
Il client ha aperto la connessione senza SSL. Se per quell'indirizzo ci sono solo righe hostssl, nessuna corrisponde e il server rifiuta. Il client si collega con sslmode=require, oppure aggiungi una riga host adatta, cosa però sconsigliata per connessioni esterne.
La riga in pg_hba.conf basta anche senza listen_addresses?
No. Se il server ascolta solo su localhost, il client non arriva nemmeno al controllo del file e ottiene "Connection refused" o un timeout. Al contrario, il messaggio "no pg_hba.conf entry" mostra che la connessione è già stabilita. Per l'accesso remoto servono listen_addresses, il firewall e la riga.
Come verifico se PostgreSQL legge correttamente il mio pg_hba.conf?
Con SELECT * FROM pg_hba_file_rules; (da PostgreSQL 10), come amministratore. La vista elenca ogni riga del file con tipo, indirizzo, metodo e un campo errore per gli errori di sintassi. Non dimenticare l'ordine: vale la prima riga che corrisponde, anche se sotto ne segue una migliore.