银河麒麟服务器安装canal前需确保java 8u292+/openjdk 11已安装、mysql binlog开启（row格式+唯一server-id）、selinux禁用，并正确配置canal.instance.master.address、dbusername等五项关键参数，最后通过startup.sh启动并验证example.log日志。
确认系统环境与前置依赖
银河麒麟服务器（V10 SP3或V11）安装Canal前，必须确保Java 8u292+或OpenJDK 11已就位，且MySQL/MariaDB服务可连通——Canal本质是MySQL的binlog解析客户端，没有可用的MySQL主库，Canal无法启动监听。
执行java -version验证JDK版本；若未安装，先用sudo apt install openjdk-11-jdk（Debian系适配源）或sudo yum install java-11-openjdk-devel（RPM系），注意银河麒麟V10默认使用yum兼容模式，V11部分版本已转向apt。
【必须关闭SELinux或配置策略，否则Canal无法绑定1099端口】检查状态：getenforce，若为Enforcing，临时禁用：sudo setenforce 0；永久禁用需编辑/etc/selinux/config，将SELINUX=enforcing改为disabled并重启。
下载并解压Canal部署包
访问阿里巴巴官方GitHub发布页（https://github.com/alibaba/canal/releases），选择最新稳定版，如v1.1.7。银河麒麟x86_64平台直接下载canal.deployer-1.1.7.tar.gz；ARM64平台务必核对是否提供aarch64构建包，否则需自行编译——官方未提供ARM原生包时，【不可强行解压x86_64包到ARM系统，会报“Exec format error”】。
使用wget下载：wget https://github.com/alibaba/canal/releases/download/canal-1.1.7/canal.deployer-1.1.7.tar.gz。
创建部署目录：sudo mkdir -p /opt/canal，然后解压：sudo tar -zxvf canal.deployer-1.1.7.tar.gz -C /opt/canal/。
配置MySQL主库开启binlog
登录MySQL服务器（可以是本机或远程），执行SHOW VARIABLES LIKE 'log_bin';，返回ON才表示binlog已启用。若为OFF，需编辑/etc/my.cnf（或/etc/mysql/my.cnf），在[mysqld]段下添加：
log-bin=mysql-binbinlog-format=ROWserver-id=1
保存后重启MySQL：sudo systemctl restart mysqld（或mysql，依实际服务名而定）。这三行缺一不可：Canal只支持ROW格式解析；server-id必须唯一且非0；log-bin名称要与后续Canal配置中destination匹配。
配置Canal服务参数
进入Canal配置目录：cd /opt/canal/conf。
复制模板实例配置：sudo cp example/instance.properties example/instance.properties.bak && sudo cp example/instance.properties .。
编辑instance.properties：sudo vim instance.properties，重点修改以下五项：
① canal.instance.mysql.slaveId = 1234（任意不与MySQL server-id冲突的整数）
② canal.instance.master.address = 192.168.1.100:3306（填真实MySQL主库IP和端口）
③ canal.instance.dbUsername = canal（该用户需有REPLICATION SLAVE权限）
④ canal.instance.dbPassword = Kylin@2026（密码需与创建用户时一致，特殊字符建议用单引号包裹）
⑤ canal.instance.filter.regex = mydb\..*（正则匹配需同步的库表，双反斜杠是Java转义要求）
保存退出。若MySQL启用了SSL，还需设置canal.instance.connectionCharset = UTF-8及canal.instance.enableDruid = false（Druid在麒麟部分版本存在类加载冲突）。
创建Canal专用数据库用户
方法一：在MySQL中执行授权语句（替换IP和密码）：
CREATE USER 'canal'@'%' IDENTIFIED BY 'Kylin@2026';GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT ON *.* TO 'canal'@'%';FLUSH PRIVILEGES;
方法二：若MySQL启用了密码强度策略（如validate_password插件），可能报错“Password validation failed”。此时需先执行：SET GLOBAL validate_password.policy=LOW;，再建用户——【此操作需root权限且仅限测试环境，生产环境应按等保要求设置强密码】。
启动Canal服务
回到Canal根目录：cd /opt/canal。
赋予脚本执行权限：sudo chmod +x bin/startup.sh bin/stop.sh。
执行启动：sudo sh bin/startup.sh。
查看日志确认是否成功：tail -f logs/example/example.log，出现## start the canal server.和start success即表示服务已就绪。若卡在“Wait for destination start”，说明MySQL连接失败或binlog未启用，需回查前几步。
