基于 Docker Compose 一键部署 XXL-Job 调度中心实战

1. 为什么选择Docker Compose部署XXL-Job？

第一次接触XXL-Job时，我尝试过传统部署方式：先手动安装MySQL，再配置Java环境，最后部署war包。光是处理各种依赖冲突就花了半天时间。直到发现Docker Compose方案，整个部署过程从半天缩短到10分钟。这种集装箱式的部署方式，就像把家具打包成标准集装箱运输，彻底解决了"在我的机器上能跑"的环境一致性问题。

XXL-Job作为分布式任务调度系统，核心组件包括调度中心和执行器。传统部署需要分别配置数据库、Web服务、日志系统等模块。而使用Docker Compose可以：

• 一键启动所有关联服务（MySQL+XXL-Job）
• 版本固化环境配置（再也不怕升级导致兼容性问题）
• 资源隔离（不会污染宿主机环境）
• 快速迁移（整个环境打包带走）

实测下来，用Docker Compose部署的生产环境，在服务器迁移时只需要拷贝一个docker-compose.yml文件和数据库卷，5分钟就能在新机器上重建完整环境。这对于需要频繁部署测试环境的团队特别友好。

2. 部署前的准备工作

2.1 安装Docker引擎

不同操作系统安装方式略有差异，这里以CentOS 7为例（其他系统可参考官方文档）：

# 卸载旧版本 sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine # 安装工具包 sudo yum install -y yum-utils device-mapper-persistent-data lvm2 # 设置稳定版仓库 sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # 安装社区版 sudo yum install docker-ce docker-ce-cli containerd.io # 启动服务 sudo systemctl start docker sudo systemctl enable docker

验证安装是否成功：

docker --version # 应该输出类似：Docker version 20.10.17, build 100c701

2.2 安装Docker Compose

推荐安装v2版本（注意命令中的docker compose中间没有横线）：

# 下载二进制文件 sudo curl -L "https://github.com/docker/compose/releases/download/v2.6.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose # 赋予执行权限 sudo chmod +x /usr/local/bin/docker-compose # 验证版本 docker compose version # 应输出：Docker Compose version v2.6.1

如果遇到权限问题，可以尝试将用户加入docker组：

sudo usermod -aG docker $USER newgrp docker # 刷新组权限

3. 编写Docker Compose编排文件

创建项目目录并编写docker-compose.yml：

version: '3.8' services: xxl-job: image: xuxueli/xxl-job-admin:2.3.1 container_name: xxl-job restart: unless-stopped ports: - "8080:8080" environment: PARAMS: >- --spring.datasource.url=jdbc:mysql://mysql:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai --spring.datasource.username=root --spring.datasource.password=123456 depends_on: mysql: condition: service_healthy networks: - xxl-net mysql: image: mysql:5.7 container_name: xxl-mysql restart: unless-stopped ports: - "3306:3306" environment: MYSQL_ROOT_PASSWORD: "123456" MYSQL_DATABASE: "xxl_job" volumes: - ./mysql/data:/var/lib/mysql - ./mysql/init:/docker-entrypoint-initdb.d healthcheck: test: ["CMD", "mysqladmin", "ping", "-h", "localhost"] interval: 5s timeout: 10s retries: 10 networks: - xxl-net networks: xxl-net: driver: bridge

这个配置有几个关键优化点：

1. 使用健康检查确保MySQL完全启动后再运行XXL-Job
2. 通过网络隔离创建专属bridge网络
3. 数据持久化：MySQL数据挂载到本地目录
4. 采用unless-stopped重启策略更合理

4. 初始化数据库

在项目目录下执行以下操作：

mkdir -p mysql/init wget -O mysql/init/tables_xxl_job.sql https://raw.githubusercontent.com/xuxueli/xxl-job/master/doc/db/tables_xxl_job.sql

这个SQL文件会自动在MySQL容器启动时执行，无需手动导入。如果需要自定义初始化脚本，可以继续在mysql/init目录添加.sql文件。

5. 启动与验证服务

一键启动所有服务：

docker compose up -d

观察日志确认服务状态：

docker compose logs -f

当看到XXL-Job日志出现"Started XxlJobAdminApplication in XX seconds"时，访问：

http://服务器IP:8080/xxl-job-admin

使用默认账号admin/123456登录。

如果遇到端口冲突，可以修改docker-compose.yml中的端口映射，比如：

ports: - "9080:8080" # 主机端口:容器端口

6. 生产环境调优建议

6.1 安全加固配置

默认配置存在安全风险，建议修改：

1. 修改默认管理员密码
2. 添加TLS证书启用HTTPS
3. 限制MySQL仅内网访问

调整后的环境变量示例：

environment: PARAMS: >- --spring.datasource.url=jdbc:mysql://mysql:3306/xxl_job?useUnicode=true --spring.datasource.username=xxl_user --spring.datasource.password=StrongPassword@123 --xxl.job.login.username=admin --xxl.job.login.password=NewAdminPassword!2023

6.2 性能优化参数

高并发场景下建议调整JVM参数：

xxl-job: environment: JAVA_OPTS: "-Xms1g -Xmx2g -XX:+UseG1GC"

MySQL配置优化（新建my.cnf文件并挂载）：

volumes: - ./mysql/conf:/etc/mysql/conf.d

6.3 备份与恢复方案

1. 定期备份MySQL数据卷：

docker run --rm --volumes-from xxl-mysql -v $(pwd)/backup:/backup alpine tar cvf /backup/mysql-$(date +%Y%m%d).tar /var/lib/mysql

2. 使用watchtower自动更新镜像：

services: watchtower: image: containrrr/watchtower volumes: - /var/run/docker.sock:/var/run/docker.sock command: --interval 3600 --cleanup

7. 常见问题排查

7.1 数据库连接失败

症状：XXL-Job启动时报"Communications link failure"

解决方法：

1. 检查MySQL容器日志：docker logs xxl-mysql
2. 确认网络连通性：docker exec xxl-job ping mysql
3. 验证数据库权限：

docker exec -it xxl-mysql mysql -uroot -p GRANT ALL PRIVILEGES ON xxl_job.* TO 'xxl_user'@'%';

7.2 调度任务不执行

可能原因：

• 执行器未注册
• 时间配置错误

检查步骤：

1. 进入Admin界面查看执行器列表
2. 确认任务CRON表达式正确
3. 检查执行器与调度中心时钟同步

7.3 内存溢出问题

在docker-compose.yml中添加内存限制：

xxl-job: deploy: resources: limits: memory: 2G

监控内存使用：

docker stats xxl-job