01 November 2026

Wie richtet man Streaming Replication in PostgreSQL ein?

Zwei matte schwarze Rack-Server im Rechenzentrum, verbunden durch leuchtende Glasfaserkabel, die PostgreSQL-Replikation symbolisieren.
KI-generiertes Bild

Die Streaming Replication gehört zu den zuverlässigsten Methoden, um PostgreSQL® für den produktiven Einsatz hochverfügbar zu machen. Sie überträgt Write-Ahead-Log-Daten (WAL) in Echtzeit vom Primary-Server auf einen oder mehrere Replica-Server und sorgt so dafür, dass im Fehlerfall ein aktueller Standby bereitsteht. Diese Anleitung führt Sie Schritt für Schritt durch die vollständige Einrichtung einer PostgreSQL Streaming Replication, vom ersten Handgriff auf dem Primary bis zur Statusprüfung auf dem Replica.

Die beschriebene Konfiguration eignet sich für PostgreSQL® 14 und neuere Versionen. Kleinere Unterschiede in Pfaden oder Parameternamen zwischen Versionen sind möglich, das grundlegende Vorgehen bleibt jedoch identisch.

Voraussetzungen für die PostgreSQL Streaming Replication

Bevor Sie mit der eigentlichen Konfiguration beginnen, stellen Sie sicher, dass Ihre Umgebung die folgenden Anforderungen erfüllt. Eine saubere Ausgangssituation erspart Ihnen später aufwendige Fehlersuche.

  • Zwei Server (oder virtuelle Maschinen) mit derselben PostgreSQL®-Version und demselben Betriebssystem
  • Netzwerkverbindung zwischen Primary und Replica, idealerweise mit niedriger Latenz
  • Ausreichend Speicherplatz auf dem Replica für eine vollständige Kopie der Datenbank-Cluster-Daten
  • Root- oder sudo-Rechte auf beiden Servern
  • Bekannte IP-Adressen beider Server (im Folgenden als primary_ip und replica_ip bezeichnet)
  • PostgreSQL® läuft auf dem Primary und ist erreichbar

Prüfen Sie außerdem, ob Firewallregeln den PostgreSQL®-Standardport 5432 zwischen den beiden Servern freigeben. Ist das nicht der Fall, passen Sie die Regeln entsprechend an, bevor Sie weitermachen.

Den Primary-Server für die Replikation konfigurieren

Auf dem Primary-Server nehmen Sie zwei zentrale Konfigurationsdateien in den Blick: postgresql.conf und pg_hba.conf. Erstere steuert das Verhalten des Servers, letztere regelt den Zugriff.

postgresql.conf anpassen

Öffnen Sie postgresql.conf (üblicherweise unter /etc/postgresql/<version>/main/ oder /var/lib/pgsql/<version>/data/) und setzen Sie die folgenden Parameter:

  1. Setzen Sie wal_level = replica, damit PostgreSQL® alle für die Replikation notwendigen WAL-Informationen schreibt.
  2. Setzen Sie max_wal_senders = 3 (oder mehr, wenn Sie mehrere Replicas planen), um gleichzeitige Replikationsverbindungen zu erlauben.
  3. Setzen Sie wal_keep_size = 64 (in MB), damit der Primary genügend WAL-Segmente vorhält, falls der Replica kurzzeitig nicht erreichbar ist.
  4. Stellen Sie sicher, dass listen_addresses = '*' gesetzt ist, damit der Server Verbindungen von außen annimmt.

Replikationsbenutzer anlegen und pg_hba.conf erweitern

Legen Sie in PostgreSQL® einen dedizierten Replikationsbenutzer an, der ausschließlich für die Streaming-Verbindung verwendet wird:

  1. Melden Sie sich als postgres-Benutzer an und öffnen Sie psql.
  2. Führen Sie CREATE ROLE replicator WITH REPLICATION LOGIN PASSWORD 'sicheres_passwort'; aus.
  3. Tragen Sie in pg_hba.conf eine neue Zeile ein, die dem Replica-Server Zugriff gewährt: host replication replicator replica_ip/32 scram-sha-256
  4. Starten Sie PostgreSQL® auf dem Primary neu: systemctl restart postgresql

Nach dem Neustart sollte der Primary auf dem konfigurierten Port lauschen und Replikationsverbindungen akzeptieren. Überprüfen Sie das mit ss -tlnp | grep 5432.

Den Replica-Server mit pg_basebackup einrichten

Mit einer funktionierenden Primary-Konfiguration können Sie jetzt den Replica-Server initialisieren. Das Werkzeug pg_basebackup erstellt eine konsistente Kopie des gesamten Datenbank-Clusters und legt gleichzeitig die nötigen Konfigurationsdateien an.

  1. Stoppen Sie PostgreSQL® auf dem Replica, falls er bereits läuft: systemctl stop postgresql
  2. Leeren Sie das Datenverzeichnis auf dem Replica (Vorsicht: Alle vorhandenen Daten gehen verloren): rm -rf /var/lib/postgresql/<version>/main/*
  3. Führen Sie pg_basebackup als postgres-Benutzer aus:

pg_basebackup -h primary_ip -U replicator -D /var/lib/postgresql/<version>/main/ -P -Xs -R

Der Parameter -R ist entscheidend: Er erstellt automatisch eine standby.signal-Datei und trägt die Verbindungsparameter in postgresql.auto.conf ein. Nach Abschluss des Befehls ist das Datenverzeichnis des Replicas eine vollständige Kopie des Primärservers, bereit für den Standby-Betrieb. Der Fortschritt wird während des Vorgangs angezeigt, bei großen Datenmengen kann dies einige Minuten dauern.

Die Replikation starten und den Status prüfen

Starten Sie nun PostgreSQL® auf dem Replica-Server und vergewissern Sie sich, dass die Streaming-Verbindung zum Primary aufgebaut wird.

  1. Starten Sie den Replica: systemctl start postgresql
  2. Prüfen Sie auf dem Primary, ob eine Replikationsverbindung aktiv ist:

SELECT client_addr, state, sent_lsn, write_lsn, flush_lsn, replay_lsn FROM pg_stat_replication;

Erscheint hier eine Zeile mit dem Status streaming, ist die PostgreSQL Streaming Replication erfolgreich eingerichtet. Auf dem Replica können Sie den Standby-Status zusätzlich mit SELECT pg_is_in_recovery(); bestätigen, was t (true) zurückgeben sollte. Damit ist Ihr PostgreSQL Primary-Replica-Setup einsatzbereit.

Häufige Probleme bei der Streaming Replication beheben

Auch bei sorgfältiger Vorbereitung können beim Einrichten der Replikation Schwierigkeiten auftreten. Die folgenden Punkte decken die häufigsten Stolpersteine ab und zeigen, wie Sie diese beheben.

Verbindung vom Replica wird abgelehnt

Wenn pg_basebackup oder der Replica keine Verbindung zum Primary aufbauen kann, prüfen Sie folgende Punkte:

  • Ist der Eintrag in pg_hba.conf korrekt und wurde PostgreSQL® danach neu geladen (SELECT pg_reload_conf();)?
  • Stimmt die IP-Adresse des Replicas in pg_hba.conf mit der tatsächlichen Adresse überein?
  • Gibt die Firewall den Port 5432 zwischen beiden Servern frei?

Replikation bricht ab oder bleibt hinter dem Primary zurück

Ein zu großer Replikationsrückstand (Replication Lag) deutet oft auf Netzwerkprobleme oder eine zu niedrig angesetzte wal_keep_size hin. Erhöhen Sie den Wert schrittweise und beobachten Sie pg_stat_replication auf dem Primary. Fällt der Replica so weit zurück, dass benötigte WAL-Segmente nicht mehr vorhanden sind, müssen Sie pg_basebackup erneut ausführen. Für Umgebungen, in denen längere Ausfallzeiten des Replicas möglich sind, empfiehlt sich der Einsatz von Replication Slots, die WAL-Segmente so lange aufbewahren, bis der Replica sie verarbeitet hat.

Standby startet nicht im Recovery-Modus

Fehlt die Datei standby.signal im Datenverzeichnis des Replicas, startet PostgreSQL® als eigenständiger Primary und nicht als Standby. Prüfen Sie, ob die Datei vorhanden ist. Falls nicht, legen Sie sie manuell an (touch standby.signal) und starten Sie den Dienst erneut. Stellen Sie außerdem sicher, dass primary_conninfo in postgresql.auto.conf die korrekten Verbindungsparameter enthält.

So unterstützt credativ® Sie bei der PostgreSQL-Replikation

Die Einrichtung einer Streaming Replication ist ein guter erster Schritt, aber eine produktionsreife PostgreSQL-Hochverfügbarkeit umfasst mehr: Monitoring, automatisches Failover, Backup-Strategien und laufende Optimierung. Genau hier setzt das PostgreSQL® Kompetenz-Center von credativ® an.

Wir begleiten Sie über den gesamten PostgreSQL®-Lebenszyklus und bieten konkrete Unterstützung in folgenden Bereichen:

  • High Availability und Cluster-Konfiguration: Planung und Implementierung von Replikationsarchitekturen, die Ihren Anforderungen an Ausfallsicherheit gerecht werden
  • Monitoring-Umgebungen: Maßgeschneiderte Überwachung, die Replikationsstatus, Lag und Systemgesundheit kontinuierlich im Blick behält
  • Tuning und Optimierung: Analyse und Anpassung Ihrer PostgreSQL®-Konfiguration für maximale Performance und Stabilität
  • Migrationsprojekte: Unterstützung beim Wechsel auf neue PostgreSQL®-Versionen oder bei der Umstellung von anderen Datenbanksystemen
  • Workshops und Schulungen: Individuelle Trainings für Ihr Team zu Replikation, Administration und Betrieb

Möchten Sie Ihre PostgreSQL®-Umgebung auf eine solide, hochverfügbare Basis stellen? Kontaktieren Sie uns und wir besprechen gemeinsam, welche Lösung am besten zu Ihrer Infrastruktur passt.

Transparenzhinweis: PostgreSQL® ist eine Marke der PostgreSQL Community Association of Canada. credativ® ist Competence Center für PostgreSQL®. Die Nennung dient ausschließlich der sachlichen Beschreibung von Dienstleistungen von credativ®. Es besteht keine darüber hinausgehende geschäftliche Verbindung zu den genannten Markeninhabern.

Ähnliche Artikel

Kategorien: credativ® Inside

über den Autor

Peter Dreuw

Head of Sales & Marketing

zur Person

Peter Dreuw arbeitet seit 2016 für die credativ GmbH und ist seit 2017 Teamleiter. Seit 2021 ist er Teil des Management-Teams als VP Services der Instaclustr. Mit der Übernahme durch die NetApp wurde seine neue Rolle "Senior Manager Open Source Professional Services". Im Rahmen der Ausgründung wurde er Mitglied der Geschäftsleitung als Prokurist. Sein Aufgabenfeld ist die Leitung des Vertriebs und des Marketings. Er ist Linux-Nutzer der ersten Stunden und betreibt Linux-Systeme seit Kernel 0.97. Trotz umfangreicher Erfahrung im operativen Bereich ist er leidenschaftlicher Softwareentwickler und kennt sich auch mit hardwarenahen Systemen gut aus.

Beiträge ansehen


Beitrag teilen: