Projekt Phoenyx: MariaDB Master-Slave Replikation
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
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:
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.
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.
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:
- DNS für Dienste auf Server 1 umstellen.
- Auf Server 1 Schreibschutz entfernen:
STOP SLAVE; SET GLOBAL read_only = 0;