Projekt Phoenyx: MariaDB Master-Slave Replikation

Kategorie: Advanced / Datenbank | Dokumentation

Architektur & Zielsetzung

Ziel ist der Aufbau einer ausfallsicheren Datenbank-Infrastruktur zwischen zwei Servern über ein internes VLAN, um Datensicherheit für Vaultwarden, WordPress und weitere Dienste zu gewährleisten.

Master (Server 2)

IP: 192.168.10.30 (VLAN)
Version: MariaDB 11.3
Rolle: Active Write

Slave (Server 1)

IP: 192.168.10.10 (VLAN)
Version: MariaDB 11.3
Rolle: Read-Only Replica

Netzwerk: Kommunikation erfolgt ausschließlich über das interne VLAN (192.168.10.0/24), nicht über das öffentliche Internet.

Voraussetzungen & Vorbereitung (Host-Level)

IP-Forwarding auf dem Slave (Server 1)

Damit Docker-Container auf Server 1 mit dem externen VLAN kommunizieren können, muss IP-Forwarding im Kernel aktiviert sein.
Fehlerbild bei Nichtbeachtung: Error 101: Network is unreachable.

# Temporär aktivieren (zum Testen)
sysctl -w net.ipv4.ip_forward=1

# Dauerhaft speichern in /etc/sysctl.conf
echo "net.ipv4.ip_forward=1" >> /etc/sysctl.conf

Firewall Priorisierung auf dem Master (Server 2)

Da auf Server 2 Mailcow läuft, blockieren deren strikte Firewall-Regeln oft den Port 3306, bevor eigene Regeln greifen. Die Freigabe muss an die erste Stelle der INPUT Chain gesetzt werden.

Fehlerbild bei Nichtbeachtung: Error 115: Operation in progress (Timeout).

# Regel an Position 1 der INPUT Chain einfügen
iptables -I INPUT 1 -s 192.168.10.10 -p tcp --dport 3306 -j ACCEPT
WICHTIG: iptables Regeln müssen persistent gespeichert werden (z.B. via iptables-save oder netfilter-persistent), sonst sind sie nach einem Reboot weg.

Einrichtung Master (Server 2)

Docker Konfiguration

Das Docker-Netzwerk darf nicht auf Internal: true stehen, da sonst keine Port-Bindings an den Host weitergegeben werden. Der Port muss explizit gebunden werden.

Datei: docker-compose.yml

services:
  mariadb-global:
    image: mariadb:11.3
    ports:
      # Bindet an 0.0.0.0 (Sicherheit erfolgt durch VLAN Firewall)
      # WICHTIG: Nicht an die IP binden, wenn Docker-Proxy Probleme macht.
      - "3306:3306" 
    volumes:
      - ./config:/etc/mysql/conf.d:ro
    # ... restliche Konfiguration ...

Datei: ./config/replication.cnf

[mysqld]
server-id        = 1
log_bin          = /var/log/mysql/mysql-bin.log
expire_logs_days = 7
bind-address     = 0.0.0.0
sync_binlog      = 1
innodb_flush_log_at_trx_commit = 1

Replikations-User anlegen

Login in die DB:

docker exec -it mariadb-global mariadb -u root -p

SQL-Befehle:

CREATE USER 'repl_user'@'192.168.10.10' IDENTIFIED BY 'DeinSicheresPasswort';
GRANT REPLICATION SLAVE ON *.* TO 'repl_user'@'192.168.10.10';
FLUSH PRIVILEGES;

Einrichtung Slave (Server 1)

Docker Konfiguration

Auch hier: Das Docker-Netzwerk muss ein Standard Bridge Network sein (kein Internal Network), damit der Container nach außen telefonieren darf.

Datei: docker-compose.yml

services:
  mariadb-replica:
    image: mariadb:11.3
    environment:
      - MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
    volumes:
      - ./data:/var/lib/mysql
      - ./config:/etc/mysql/conf.d:ro
    ports:
      - "127.0.0.1:3306:3306" # Nur lokal erreichbar

Datei: ./config/replica.cnf

[mysqld]
server-id = 2
read_only = 1  # Schreibschutz (verhindert Datenchaos)
log_bin   = /var/log/mysql/mysql-bin.log
relay_log = /var/log/mysql/mysql-relay-bin.log

Initialisierung & Synchronisation

Um die Replikation zu starten, muss der Slave den exakten Startpunkt (Log File & Position) des Masters kennen.

Dump erstellen & Position merken (Auf Master)

Um Datenkonsistenz zu garantieren, werden Tabellen kurz gesperrt.

Einloggen: docker exec -it mariadb-global mariadb -u root -p

SQL Befehle für Lock und Status:

FLUSH TABLES WITH READ LOCK;
SHOW MASTER STATUS;

-> NOTIERE: File (z.B. mysql-bin.000001) und Position (z.B. 16670)

Zweites Terminal öffnen für Dump (während Terminal 1 offen bleibt!)
Hinweis: mariadb:11.3 nutzt mariadb-dump statt mysqldump

docker exec mariadb-global mariadb-dump -u root -p --all-databases > /tmp/master.sql

Terminal 1: Sperre aufheben

UNLOCK TABLES;

Dump einspielen & Starten (Auf Slave)

Kopiere master.sql auf Server 1 und importiere es beim Start (oder via mariadb < master.sql).

Login auf Slave DB: docker exec -it mariadb_replica mariadb -u root -p

STOP SLAVE;
CHANGE MASTER TO
  MASTER_HOST='192.168.10.30',
  MASTER_USER='repl_user',
  MASTER_PASSWORD='DeinSicheresPasswort',
  MASTER_PORT=3306,
  MASTER_LOG_FILE='mysql-bin.000001',  -- Wert aus dem Schritt zuvor
  MASTER_LOG_POS=16670;                -- Wert aus dem Schritt zuvor
START SLAVE;

Troubleshooting Guide (Gelöste Probleme)

Während der Einrichtung traten folgende Fehler auf und wurden gelöst:

Error 101 Network is unreachable

Ursache 1: Docker Netzwerk war als Internal: true konfiguriert. Der Container hatte kein Gateway nach außen.
Lösung: Netzwerk löschen und ohne --internal Flag neu erstellen.

Ursache 2: net.ipv4.ip_forward = 0 auf dem Host.
Lösung: sysctl -w net.ipv4.ip_forward=1.

Error 115 Operation in progress (Timeout)

Ursache 1: Firewall auf Master blockierte Zugriff. Mailcow-Regeln überschrieben Standard-Regeln.
Lösung: iptables -I INPUT 1 ... (Insert an Position 1).

Ursache 2: Docker Port-Binding falsch.
Lösung: Ports auf 3306:3306 ändern (statt an IP zu binden), um Docker-Proxy Probleme zu umgehen.

Error 1236 Impossible position

Ursache: Der Master-Container wurde neu erstellt (force-recreate). Dadurch wurden die Binary Logs zurückgesetzt. Der Slave suchte nach einer Log-Position, die nicht mehr existierte.
Lösung: Auf Master SHOW MASTER STATUS ausführen und auf Slave mit CHANGE MASTER TO ... die neuen Koordinaten eintragen.

Disaster Recovery (Notfallplan)

Wenn Server 2 ausfällt:

  1. DNS für Dienste auf Server 1 umstellen.
  2. Auf Server 1 Schreibschutz entfernen:
STOP SLAVE;
SET GLOBAL read_only = 0;