Debian 上 MariaDB Galera 多主集群搭建指南
一 架构与准备
- 采用 MariaDB Galera Cluster 实现 多主同步复制，建议至少 3 节点，示例 IP：192.168.100.111/112/113。各节点需配置 主机名解析 或内网 DNS，保证互通。系统建议使用 Debian 12，MariaDB 版本示例 10.11。为提升稳定性，建议将各节点 /etc/hosts 加入记录：
192.168.100.111 galera-node1
192.168.100.112 galera-node2
192.168.100.113 galera-node3
同时准备数据库 root 密码与必要的系统账户权限。
二 安装 MariaDB 与 Galera
- 在所有节点安装软件包（Debian 12 通常安装 mariadb-server 会自动拉取 galera-4 等依赖）：
apt update && apt install -y mariadb-server mariadb-client galera-4
安装完成后先不要启动 MariaDB，后续通过引导方式启动第一个节点。
三 配置 Galera
- 编辑配置文件（Debian 12 常用路径：/etc/mysql/mariadb.conf.d/50-server.cnf），在文件末尾加入 Galera 配置。以下为 galera-node1 示例，其他节点仅修改 wsrep_node_address 与本机 IP：
[galera]
wsrep_on=ON
wsrep_provider=/usr/lib/galera/libgalera_smm.so
wsrep_cluster_address=“gcomm://192.168.100.111,192.168.100.112,192.168.100.113”
binlog_format=row
default_storage_engine=InnoDB
innodb_autoinc_lock_mode=2
bind-address=0.0.0.0
wsrep_cluster_name=“MariaDB_Cluster”
wsrep_node_address=“192.168.100.111”
wsrep_node_name=“galera-node1”
说明：
- 注释或调整 bind-address，确保监听 0.0.0.0（或指定内网接口）。
- 各节点使用相同 wsrep_cluster_name 与 wsrep_cluster_address，但 wsrep_node_address/name 唯一。
四 启动集群与验证
- 首次引导（仅在一个节点执行，例如 galera-node1）：
systemctl stop mariadb
galera_new_cluster
其他节点正常启动：
systemctl start mariadb
验证集群状态（任意节点执行）：
mysql -e “show status like ‘wsrep_cluster_size’;” # 期望值为 3
mysql -e “show status like ‘wsrep_connected’;” # 期望值为 ON
mysql -e “show status like ‘wsrep_incoming_addresses’;” # 应列出 3 个节点
mysql -e “show status like ‘wsrep_local_state_comment’;” # 查看同步状态描述
完成后建议运行 mysql_secure_installation 完成安全初始化（设置 root 密码、移除匿名用户等）。
五 防火墙与常见维护
- 防火墙放通端口（示例为 firewalld，生产可按需收紧网段）：
firewall-cmd --permanent --add-port=3306/tcp
firewall-cmd --permanent --add-port=4567/tcp
firewall-cmd --permanent --add-port=4568/tcp
firewall-cmd --permanent --add-port=4444/tcp
firewall-cmd --reload
说明：
- 3306 为 MySQL 客户端/复制流量；
- 4567 为 Galera 复制与组通信（TCP/UDP）；
- 4568 为增量状态转移（IST）；
- 4444 为状态快照传输（SST，如 rsync）。
- 维护账户一致性（Debian 系常见问题）：
集群启动后，除第一个节点外，其他节点的 /etc/mysql/debian.cnf 中 debian-sys-maint 账户密码可能与数据库不一致，导致系统维护任务失败。将第一个节点的该文件内容同步到其余节点，确保 client 与 mysql_upgrade 段一致。
- 重启与引导安全：
正常重启整个集群时，先在一个节点执行 galera_new_cluster，其余节点再启动 mariadb。若某节点报错 “It may not be safe to bootstrap the cluster from this node”，检查 /var/lib/mysql/grastate.dat 的 safe_to_bootstrap 标记；必要时将其设为 1 在该节点引导，或清理 grastate.dat/gvwstate.dat 后重试。
- 重要提示：
- 生产环境避免使用 –wsrep-new-cluster 连接到现有集群；该选项仅用于首次引导。
- 建议始终保留 至少 3 个节点 以获得更稳定的仲裁与容错能力。