Přeskočit na obsah

PostgreSQL s listen_addresses na IP docker0 po rebootu poslouchá jen na localhostu

import { Aside } from ‘@astrojs/starlight/components’;

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í.

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 selhal a PostgreSQL pokračoval jen s 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 5432
LISTEN 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ž Docker
  1. 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 = 1
    sysctl -p /etc/sysctl.d/90-pg-docker0-bind.conf
  2. 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.service
    Wants=docker.service
    systemctl daemon-reload && systemctl restart postgresql@16-main
  3. Restart závislého kontejneru (docker restart sogo) a kontrola ss -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 -tlnH s očekávaným seznamem adres, ne jen systemctl is-active; v PG logu hledat could not bind IPv4 address. Do post-reboot smoke testu přidat požadavek z kontejneru na DB.
  • Anti-pattern: listen_addresses s 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.
Přidal aiarchitekt.cz · 2. 11. 2026 1:00
Provozuje aiarchitekt.cz