debian 上无官方“mysql 集群版”安装包，mysql-server 是单机版；需按需选型：推荐 mysql innodb cluster（依赖 mysqlsh 管理）、group replication 或 ndb cluster。
直接说结论：Debian 上没有官方叫 “MySQL 集群版” 的单一安装包，mysql-server 是单机版；真要集群，得明确选型——是 MySQL InnoDB Cluster（推荐）、MySQL Group Replication，还是 MySQL NDB Cluster（即传统 MySQL Cluster）。而 mysqlsh（MySQL Shell）本身不负责安装集群软件，它只在 MySQL 服务已就绪后，用于初始化、配置和管理 InnoDB Cluster。
下面分三块讲清楚怎么做、为什么这么选、以及最容易卡住的点。
用 mysqlsh 搭 InnoDB Cluster 前，必须先装对 MySQL 服务
InnoDB Cluster 依赖 MySQL 5.7.17+ 或 8.0+，且要求启用 binlog、gtid_mode=ON、enforce_gtid_consistency=ON 等关键参数。Debian 官方源的 mysql-server 包默认不满足这些条件，尤其 Debian 12/13 默认装的是 8.0.x，但配置文件里这些项是注释掉的。
- 必须手动改
/etc/mysql/mysql.conf.d/mysqld.cnf，在[mysqld]下添加：server-id = 1 log-bin = /var/log/mysql/mysql-bin gtid_mode = ON enforce_gtid_consistency = ON binlog_checksum = NONE
-
binlog_checksum = NONE是 MySQL Shell 8.0.29 之前版本的硬性要求（新版已放宽，但旧环境仍常见报错） - 改完记得
systemctl restart mysql，并用mysql -u root -p -e "SHOW VARIABLES LIKE 'gtid_mode';"验证是否生效
mysqlsh 不是安装器，而是集群编排工具
mysqlsh 本身不下载、不安装 MySQL 二进制或服务，它只是个交互式客户端 + JavaScript/Python 脚本运行时。你得先确保：
- 所有节点已装好同版本 MySQL（建议用 MySQL APT 仓库装，不是 Debian 默认源）
- 每个节点的
mysql服务能本地连通（mysql -S /var/run/mysqld/mysqld.sock） - 节点间 TCP 3306、33061（XCom 端口）、2480（Router 端口）互通，且防火墙放行
常见错误现象：
-
Cluster.addInstance()卡住或报Failed to connect to instance→ 实际是网络不通或 MySQL 没开远程访问（bind-address = 0.0.0.0且用户 host 是%） -
Dba.createCluster()报Invalid configuration: binlog is disabled→ 配置没生效或 MySQL 没重启 -
mysqlsh启动时报libssl.so.1.1: cannot open shared object file→ Debian 12+ 默认带 OpenSSL 3，需装兼容包：apt install libssl1.1
一键部署脚本的核心逻辑其实是“三步走”，不是真的一键
所谓“一键”，是指把重复操作封装成 shell 脚本，但它仍依赖人工确认和前置检查：
- 第一步：在每个节点上执行基础安装与配置（用
apt install mysql-server+ 写配置 + 重启） - 第二步：在第一个节点上用
mysqlsh --sql -u root -p -e "CREATE USER ... GRANT ..."创建集群管理账号（如clusteradmin@'%'），密码必须一致 - 第三步：用
mysqlsh --js -u clusteradmin -p -h node1 -e "dba.createCluster('mycluster', {ipAllowlist: '10.0.0.0/24'});"初始化，再addInstance()加其余节点
关键细节：
-
ipAllowlist必须显式指定，不能留空，否则创建失败 - 所有节点的
server-id必须唯一，且不能为 0 或重复 -
mysqlsh连接时若用 socket（-S），无法跨节点；集群操作必须走 TCP（-h）
最常被忽略的是：InnoDB Cluster 要求所有节点时间同步（systemd-timesyncd 或 chrony 必须跑着），哪怕差 2 秒，addInstance() 就可能超时失败，日志里却只显示模糊的 “timeout waiting for group communication”。
