银河麒麟服务器安装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未启用,需回查前几步。

















