MySQL数据库主从同步搭建，一键脚本部署

知识分享

2026-09-26 09:00

11 阅读

MySQL主从同步是数据库高可用和读写分离的基础，本文提供一套一键脚本部署方案，让你在10分钟内完成主从复制配置。
适合刚接触Linux和MySQL的运维新手，照着操作即可获得一个可用的主从环境。

部署前需要确认的几件事

开始之前，请确保满足以下条件，否则脚本可能执行失败。

两台服务器（或虚拟机），分别作为主库和从库，建议最低配置1核2G。
操作系统为CentOS 7/8或Ubuntu 20.04/22.04，且已安装MySQL 5.7或8.0。
主从服务器之间网络互通，安全组或防火墙开放3306端口。
主库和从库的MySQL root密码已知，或拥有可执行GRANT、REPLICATION SLAVE权限的账号。
主库和从库的server-id必须不同，脚本会自动检测并提示修改。

关键点：主从同步的原理是主库将二进制日志（binlog）发送给从库，从库重放这些日志来实现数据一致。
因此主库必须开启binlog，且主从的server-id不能重复。

一键脚本准备与执行

脚本已封装环境检查、配置修改和同步启动逻辑，你只需在主库和从库分别执行。

1. 下载脚本并赋予执行权限

wget https://example.com/mysql_replication_setup.sh  # 请替换为实际脚本地址
chmod +x mysql_replication_setup.sh

如果无法下载，可将下方脚本内容保存为 mysql_replication_setup.sh。

2. 脚本内容（核心片段）

#!/bin/bash
# MySQL主从一键部署脚本（简化版）
# 用法：./mysql_replication_setup.sh [master|slave] [master_ip] [repl_password]

ROLE=$1
MASTER_IP=$2
REPL_PASS=$3

if [ "$ROLE" == "master" ]; then
    # 主库配置
    sed -i '/\[mysqld\]/a server-id=1\nlog-bin=mysql-bin\nbinlog-format=ROW' /etc/my.cnf
    systemctl restart mysqld
    mysql -uroot -p -e "CREATE USER 'repl'@'%' IDENTIFIED BY '$REPL_PASS'; GRANT REPLICATION SLAVE ON *.* TO 'repl'@'%'; FLUSH PRIVILEGES;"
    mysql -uroot -p -e "SHOW MASTER STATUS;"
elif [ "$ROLE" == "slave" ]; then
    # 从库配置
    sed -i '/\[mysqld\]/a server-id=2\nrelay-log=mysql-relay-bin\nlog-slave-updates=1\nread-only=1' /etc/my.cnf
    systemctl restart mysqld
    mysql -uroot -p -e "CHANGE MASTER TO MASTER_HOST='$MASTER_IP', MASTER_USER='repl', MASTER_PASSWORD='$REPL_PASS', MASTER_LOG_FILE='mysql-bin.000001', MASTER_LOG_POS=154; START SLAVE;"
    mysql -uroot -p -e "SHOW SLAVE STATUS\G"
fi

注意：脚本中的 MASTER_LOG_FILE 和 MASTER_LOG_POS 需根据主库 SHOW MASTER STATUS 的实际输出替换。
一键脚本通常会自动获取，若手动执行请务必核对。

3. 执行脚本

在主库运行：

./mysql_replication_setup.sh master 192.168.1.100 YourReplPassword

在从库运行：

./mysql_replication_setup.sh slave 192.168.1.100 YourReplPassword

将 192.168.1.100 替换为你的主库IP，YourReplPassword 替换为自定义复制密码。

避坑指南：这些错误最容易出现

根据实际部署经验，以下问题会导致同步失败或中断。

server-id冲突：如果主从server-id相同，从库会拒绝连接。脚本会自动检查，但手动配置时务必确保主库为1，从库为2（或任意不同数字）。
防火墙未放行：从库连接主库3306端口被拦截，表现为 Slave_IO_Running: Connecting。请检查安全组和iptables。
复制账号权限不足：必须授予 REPLICATION SLAVE 权限，MySQL 8.0还需 REPLICATION CLIENT。
binlog未开启：主库若未配置 log-bin，SHOW MASTER STATUS 返回空，从库无法定位日志。
数据不一致：如果主库已有数据，从库需先导入全量备份再启动同步，否则会报错。

建议：首次搭建时，主从库均为空数据，可避免大部分一致性问题。

验证同步是否生效

在从库执行以下命令，检查两个关键线程状态。

SHOW SLAVE STATUS\G

观察输出中：

Slave_IO_Running: Yes
Slave_SQL_Running: Yes
Seconds_Behind_Master: 0（或较小数值）

若两个线程均为Yes，说明同步已正常运行。
然后可以在主库创建测试表并插入数据，在从库查询验证。

-- 主库执行
CREATE DATABASE test_repl;
USE test_repl;
CREATE TABLE t1 (id INT);
INSERT INTO t1 VALUES (1);

-- 从库执行
SELECT * FROM test_repl.t1;

能查询到数据即表示主从同步搭建成功。

常见疑问

从库能写入数据吗？
默认从库是只读的（read-only=1），但拥有SUPER权限的用户仍可写入，生产环境建议严格限制。

主库重启后同步会中断吗？
不会自动中断，但需确保主库binlog文件未被清理。如果主库执行过 RESET MASTER，从库需要重新配置同步点。

如何停止或重置同步？
在从库执行 STOP SLAVE; 暂停，RESET SLAVE ALL; 清除所有同步配置。重新配置需再次执行 CHANGE MASTER TO。

一键脚本适用于生产环境吗？
脚本适合快速搭建测试环境。生产环境建议根据业务负载调整binlog格式、同步模式（半同步/异步）并配置监控告警。

按本文步骤操作后，你应该已经拥有一个运行中的MySQL主从架构。
遇到同步中断时，优先检查网络、账号权限和binlog位置，大多数问题都能快速定位。

Nginx访问日志切割脚本，按天分割日志文件

MySQL数据库binlog开启，数据误删恢复