PostgreSQL connection refused: 8 Adımda Kesin Teşhis

▸Belirti

plaintext

psql: error: connection to server at "10.0.4.12", port 5432 failed:
could not connect to server: Connection refused
        Is the server running on that host and accepting TCP/IP connections?

Bu hata mesajı nettir: hedef portta dinleyen hiçbir süreç yok. Yani sorun kimlik doğrulama değil, ağ ya da süreç seviyesindedir.

Mesaj	Katman	Anlamı
`Connection refused`	Ağ/süreç	Portta dinleyen yok ya da bağlantı aktif reddedildi
`Connection timed out`	Ağ	Paketler düşüyor: firewall, security group, yanlış IP
`no pg_hba.conf entry`	Kimlik doğrulama	Sunucuya ulaşıldı, kural eşleşmedi

▸Adım adım teşhis

1. Sunucuya ağ erişiminiz var mı?

bash

pg_isready -h 10.0.4.12 -p 5432

2. Süreç ayakta mı ve hangi arayüzü dinliyor?

bash

sudo systemctl status postgresql
sudo ss -ltnp | grep 5432

ss çıktısında 127.0.0.1:5432 görüp 0.0.0.0:5432 görmüyorsanız, sunucu yalnızca yerel bağlantı kabul ediyor demektir.

3. Dinleme adresini kontrol edin.

sql

SHOW listen_addresses;
SHOW port;

Varsayılan localhost'tur. Değiştirmek için:

sql

ALTER SYSTEM SET listen_addresses = '*';

Bu ayar yeniden başlatma gerektirir:

bash

sudo systemctl restart postgresql

4. Firewall ve Security Group kontrolleri.

bash

sudo ufw status
sudo iptables -L -n | grep 5432

5. Docker port haritalama kontrolü. Konteyner içinde PostgreSQL çalışsa bile, -p 5432:5432 verilmediyse ana makineden ulaşılamaz:

bash

docker ps --format "table {{.Names}}\t{{.Ports}}"

6. Disk dolması kaynaklı çökme kontrolü.

bash

sudo tail -50 /var/log/postgresql/postgresql-17-main.log
df -h

▸İlgili Mühendislik Rehberleri ve İç Linkler

•PostgreSQL Password Authentication Failed Rehberi
•PostgreSQL İlk Restore Tatbikatı Runbook'u
•Test edilen sürümler: PostgreSQL 14 / 15 / 16 / 17

PostgreSQL connection refused: 8 Adımda Kesin Teşhis

▸Belirti

▸Adım adım teşhis

▸İlgili Mühendislik Rehberleri ve İç Linkler

PostgreSQL Diğer Üretim Rehberleri

PostgreSQL Backup'ınızı Doğrulayın: İlk Restore Tatbikatı

PostgreSQL Replication Lag: Darboğazı Adım Adım Teşhis Etme

psql CLI Hızlı Referans