CLONE INSTANCE 能在5–10分钟内完成TB级从节点部署,但需确保插件状态为ACTIVE、donor授BACKUP_ADMIN、recipient授CLONE_ADMIN、recipient设clone_valid_donor_list、克隆后删除auto.cnf并重置server_uuid,任一环节缺失均会导致失败。

CLONE INSTANCE 能在 5–10 分钟内完成 TB 级从节点部署,但不是执行一条命令就完事——插件没真正激活、权限配错角色、clone_valid_donor_list 漏设、auto.cnf 冲突,任一环节出问题都会卡住或静默失败。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
确认 clone 插件状态为 ACTIVE,不是“装了就行”
插件加载失败是克隆失败的第一大原因。很多人执行过INSTALL PLUGIN clone SONAME 'mysql_clone.so'; 就以为万事大吉,其实它只对当前会话生效,重启 mysqld 后立刻失效。
- 必须在 donor 和 recipient 两端的 my.cnf 中都添加:
[mysqld] plugin-load-add = mysql_clone.so clone = FORCE_PLUS_PERMANENT- 重启后运行:
SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'clone';,两台机器结果都必须是 ACTIVE
- 检查 SELECT @@plugin_dir; 返回路径下是否存在 mysql_clone.so(Linux)或 mysql_clone.dll(Windows),且 MySQL 进程用户有读+执行权限
- SELinux 或 AppArmor 可能拦截加载,临时用 setenforce 0 验证是否为此类问题
donor 和 recipient 权限必须分设,不能复用同一个账号
克隆不走复制权限体系,REPLICATION SLAVE 对克隆完全无效;混用账号会导致 ERROR 3095 (HY000): Insufficient privileges。
- donor 实例上创建用户(如 'cloner'@'192.168.1.10'),并授予:
-
BACKUP_ADMIN(必需,用于读取物理页) -
REPLICATION SLAVE(后续配主从用,非克隆所需但必须)
'cloner'@'%'),只授:
-
CLONE_ADMIN(隐含BACKUP_ADMIN+SHUTDOWN,因克隆后要自动重启)
FLUSH PRIVILEGES;
- donor 的 bind_address 不能是 127.0.0.1,得设为 0.0.0.0 或具体内网 IP,并确保防火墙/云安全组放行 3306 端口
recipient 上必须提前设 clone_valid_donor_list,否则连接直接被拒
这个变量是远程克隆的“白名单开关”,不设或格式错,CLONE INSTANCE 会报 ER_CLONE_DONOR_NOT_FOUND 或连接超时。
- 在 recipient 上执行:SET GLOBAL clone_valid_donor_list = '192.168.1.10:3306';
- 格式必须严格为 IP:PORT,不能带 http://、不能写域名、不支持 IPv6
- 它是 global 级变量,session 级设置无效
- 若 donor 是多端口实例(如同时开 3306 和 3307),可用逗号分隔:'192.168.1.10:3306,192.168.1.10:3307'克隆后必须手动处理 server_uuid 和复制配置,否则无法连主库
克隆是物理拷贝,auto.cnf 文件原样复制,recipient 启动后 @@server_uuid 与 donor 完全一致,CHANGE REPLICATION SOURCE TO 会直接拒绝连接。
- 克隆完成、recipient 自动重启后,第一件事:删掉 auto.cnf(Linux 默认路径 /var/lib/mysql/auto.cnf,Windows 在 datadir 下)
- 重启 MySQL,执行 SELECT @@server_uuid;,确认已变更
- 检查 donor 当前位点:SELECT BINLOG_FILE, BINLOG_POSITION FROM performance_schema.clone_status;
- 在 recipient 上执行 CHANGE REPLICATION SOURCE TO,填入 donor 的 IP、复制账号、位点信息
- 注意:my.cnf 中必须提前配好唯一 server_id、gtid_mode = ON、log_bin 开启,否则复制线程起不来
auto.cnf 不删、clone_valid_donor_list 不设、CLONE_ADMIN 权限没给 recipient —— 这三处最容易被跳过,也是线上扩容时最常卡住的地方。


















