保姆级教程：在Ubuntu 22.04上用Docker一键部署CloudCanal社区版（附端口占用排查）

保姆级教程在Ubuntu 22.04上零障碍部署CloudCanal社区版当你第一次听说CloudCanal这个数据同步工具时可能和我当初一样既兴奋又忐忑。兴奋的是它号称能简化数据库之间的数据流动忐忑的是部署过程会不会暗藏玄机。作为过来人我完全理解这种心情——毕竟谁都不想在一台崭新的Ubuntu服务器上折腾半天却卡在某个莫名其妙的报错上。这就是为什么我决定写这份真正意义上的保姆级教程。不同于那些只给命令不解释的速成指南我会带你用Docker一步步搭建CloudCanal测试环境更重要的是告诉你每个步骤背后的原理和可能遇到的坑。相信我跟着这份指南走即使你是第一次接触Docker的新手也能在30分钟内完成部署并看到登录界面。1. 环境准备打造完美的部署基础1.1 系统要求核查在开始下载安装包之前我们需要确保你的Ubuntu 22.04系统满足最低运行要求。CloudCanal社区版对硬件和软件环境有一些特定限制操作系统兼容性确认系统架构uname -m应返回x86_64确认非虚拟化环境systemd-detect-virt应返回none硬件资源配置# 检查CPU核心数需≥4 grep -c ^processor /proc/cpuinfo # 检查内存大小需≥8GB free -h | awk /Mem:/ {print $2}注意如果在云服务器上部署建议选择通用计算型实例如AWS的t3.xlarge或阿里云的ecs.g6.xlarge。实测2核4GB的机器虽然能启动但执行同步任务时容易出现OOM错误。1.2 端口占用排查CloudCanal默认使用多个端口冲突是部署失败的首要原因。推荐使用以下组合命令一次性检查所有必需端口sudo netstat -tulnp | grep -E 8111|9090|55000|25000|55005如果发现占用你有两个选择终止占用进程谨慎操作sudo kill -9 PID修改CloudCanal的默认端口需要后续调整docker-compose.yml常见端口冲突场景8111常被某些监控工具占用9090Prometheus的默认端口55000某些MySQL衍生产品的管理端口2. Docker环境精装配置2.1 安装最新版Docker引擎官方文档说Docker 17即可但我强烈建议安装20.10版本。旧版Docker在存储驱动和网络模式上可能引发兼容性问题。以下是经过优化的安装脚本# 卸载旧版本如有 sudo apt-get remove docker docker-engine docker.io containerd runc # 设置仓库 sudo apt-get update sudo apt-get install -y \ ca-certificates \ curl \ gnupg \ lsb-release sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo \ deb [arch$(dpkg --print-architecture) signed-by/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable | sudo tee /etc/apt/sources.list.d/docker.list /dev/null # 安装Docker引擎 sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin # 验证安装 sudo docker run hello-world2.2 配置Docker加速器国内用户务必配置镜像加速以避免拉取镜像超时sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json -EOF { registry-mirrors: [https://你的ID.mirror.aliyuncs.com], exec-opts: [native.cgroupdriversystemd], log-driver: json-file, log-opts: { max-size: 100m }, storage-driver: overlay2 } EOF sudo systemctl daemon-reload sudo systemctl restart docker2.3 安装7z解压工具CloudCanal的安装包采用7z格式压缩Ubuntu默认不包含该解压工具sudo apt-get update sudo apt-get install -y p7zip-full p7zip-rar验证安装7z --help | head -n 1 # 应显示7-Zip [64] 16.02...3. 安装包处理与解压技巧3.1 下载与校验建议使用wget直接下载到/opt目录sudo mkdir -p /opt/cloudcanal cd /opt/cloudcanal sudo wget https://cloudcanal-community.oss-cn-hangzhou.aliyuncs.com/latest/cloudcanal.7z下载完成后务必校验文件完整性sudo 7z l cloudcanal.7z | grep -E console|mysql|prometheus|sidecar # 应看到四个tar镜像文件3.2 安全解压实践解压时建议使用以下命令组合避免权限问题sudo 7z x cloudcanal.7z -o/opt/cloudcanal sudo chown -R $USER:$USER /opt/cloudcanal cd /opt/cloudcanal解压后的关键文件说明文件/目录用途说明重要等级docker-compose.yml容器编排配置★★★★★startup.sh启动脚本★★★★★upgrade.sh升级脚本★★★★☆scripts/运维脚本目录★★★☆☆*.tarDocker镜像归档文件★★★★★4. 启动与初始化全流程4.1 首次启动的正确姿势不要直接运行startup.sh先执行预检查# 检查镜像完整性 for img in console.tar mysql.tar prometheus.tar sidecar.tar; do tar -tf $img /dev/null || echo $img 损坏 done # 检查端口占用再次确认 ./scripts/check_ports.sh # 如果没有这个脚本可以用前面的netstat命令确认无误后使用nohup防止SSH断开导致进程终止nohup ./startup.sh startup.log 21 tail -f startup.log正常启动你会看到如下关键日志[OK] MySQL container started [OK] Console service is up4.2 访问控制台与初始配置当看到cloudcanal start提示后打开Chrome访问http://服务器IP:8111使用以下默认凭证登录用户名testclougence.com密码clougence2021首次登录必做操作修改管理员密码账户设置检查机器管理中测试节点状态验证测试数据源连接4.3 常见启动问题排查如果启动失败按以下步骤诊断# 查看容器日志 docker logs cloudcanal-console # 检查容器状态 docker ps -a | grep -E cloudcanal|mysql # 检查端口实际监听情况 sudo ss -tulnp | grep -E 8111|9090典型问题解决方案端口冲突# 修改docker-compose.yml中的端口映射 vi docker-compose.yml # 例如将8111:8111改为8112:8111镜像加载失败# 手动加载镜像 docker load -i console.tar磁盘空间不足df -h /var/lib/docker docker system prune -f5. 生产环境进阶配置5.1 数据持久化设置默认配置数据存储在容器内部重启会丢失。建议挂载外部卷# 修改docker-compose.yml services: mysql: volumes: - /data/cloudcanal/mysql:/var/lib/mysql console: volumes: - /data/cloudcanal/config:/app/config5.2 资源限制配置避免容器占用过多资源services: mysql: deploy: resources: limits: cpus: 2 memory: 4G5.3 备份与恢复策略建议每日备份关键数据# 创建备份脚本/opt/cloudcanal/scripts/backup.sh #!/bin/bash docker exec cloudcanal-mysql mysqldump -uclougence -p123456 --all-databases /backups/cloudcanal-$(date %F).sql find /backups -type f -mtime 7 -delete设置cron定时任务0 2 * * * /opt/cloudcanal/scripts/backup.sh6. 效能优化实战技巧经过三个月的实际使用我发现这些调整能显著提升CloudCanal性能网络参数调优# 在宿主机执行 sudo sysctl -w net.core.somaxconn32768 sudo sysctl -w vm.overcommit_memory1MySQL容器配置# 在docker-compose.yml中添加 environment: - innodb_buffer_pool_size2G - innodb_io_capacity2000监控配置# 启用详细指标收集 docker exec cloudcanal-console curl -X POST http://localhost:9090/api/v1/admin/metrics/enable