PostgreSQL s listen_addresses na IP docker0 po rebootu poslouchá jen na localhostu
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Po plánovaném restartu serveru hlásí systemd PostgreSQL i Docker jako active, aplikace na hostiteli fungují, ale webmail SOGo běžící v kontejneru loguje could not open channel … PostgreSQL72Channel: not-connected pro postgresql://host.docker.internal/…. Přihlašovací stránka se přitom načte (200), takže běžný HTTP smoke test problém neodhalí.
Root cause
Sekce “Root cause”PostgreSQL měl listen_addresses = 'localhost,<docker0-IP>', aby kontejnery dosáhly na DB přes bránu docker0. Při bootu nastartoval o dvě sekundy dřív než docker.service; rozhraní docker0 tedy ještě neexistovalo, bind() na 127.0.0.1:5432 (bind na neexistující adresu je ve výchozím stavu u PG jen varování). Z kontejneru je pak port odmítnutý. Dokud server nikdo nerestartoval, fungovalo to — kdysi byl PG restartován ručně až po Dockeru, takže chyba byla latentní.
$ ss -tlnH | grep 5432LISTEN 0 200 127.0.0.1:5432 0.0.0.0:* # <docker0-IP> chybí$ systemctl show -p ActiveEnterTimestamp postgresql docker… 15:07:40 … … 15:07:42 … # PG dřív než DockerFix
Sekce “Fix”- Dovolit jádru bind na zatím neexistující lokální adresu (řeší i pořadí při dalším bootu):
/etc/sysctl.d/90-pg-docker0-bind.conf net.ipv4.ip_nonlocal_bind = 1sysctl -p /etc/sysctl.d/90-pg-docker0-bind.conf - Pro jistotu i pořadí startu (drop-in pro cluster):
# /etc/systemd/system/postgresql@16-main (systemd unit).d/after-docker.conf[Unit]After=docker.serviceWants=docker.service
systemctl daemon-reload && systemctl restart postgresql@16-main - Restart závislého kontejneru (
docker restart sogo) a kontrolass -tlnH | grep 5432— musí být obě adresy.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: po rebootu porovnat
ss -tlnHs očekávaným seznamem adres, ne jensystemctl is-active; v PG logu hledatcould not bind IPv4 address. Do post-reboot smoke testu přidat požadavek z kontejneru na DB. - Anti-pattern:
listen_addressess konkrétní IP cizího rozhraní (docker0, wg0, floating IP) bez zajištění pořadí startu nebo nonlocal bind; „funguje to měsíce“ jen proto, že server nikdo nerestartoval. - Lepší přístup: kontejnery připojovat přes unix socket namountovaný do kontejneru, nebo PG v docker síti; pokud musí být IP docker0, použít
ip_nonlocal_bind+After=docker.service.
Sister bugs / související
Sekce “Sister bugs / související”- Služby závislé na síťovém rozhraní, které vzniká až později (VPN, Docker, cloud-init) — stejná třída chyb „bind při bootu“.
- Záznam o PM2 a špatném HOME při restartu přes systemd v kategorii deploy: další případ, kdy „po restartu všechno svítí zeleně“, ale stav se liší od ručně nastartovaného.