xiekp/xxl-job

XXL-Job Docker镜像文档

镜像概述

XXL-Job Docker镜像是基于XXL-Job分布式任务调度平台构建的容器化部署方案。XXL-Job是一个轻量级、高性能、功能全面的分布式任务调度框架，支持集群部署、任务编排、定时执行、失败重试等核心能力，广泛应用于企业级定时任务调度场景。该镜像提供了便捷的部署方式，简化了传统部署流程，可快速集成到各类应用架构中。

核心功能和特性

• 分布式调度：支持集群部署模式，任务自动负载均衡，提高系统吞吐量
• 灵活的任务配置：支持Cron表达式、固定间隔、任务依赖等多种调度方式
• 完善的任务管理：提供Web控制台，支持任务创建、编辑、启停、删除等全生命周期管理
• 监控与报警：实时监控任务执行状态，支持邮件、短信等多种报警方式
• 高可用设计：集群部署避免单点故障，任务失败自动重试机制
• 丰富的执行器支持：支持Java、Python、Go等多语言执行器，适配不同技术栈

使用场景和适用范围

• 企业级定时任务：如数据同步、报表生成、日志清理等周期性任务
• 微服务架构任务调度：跨服务任务协调与执行
• 高并发任务处理：通过集群调度分散任务压力
• 任务执行监控：需要实时掌握任务运行状态的业务场景
• 复杂任务编排：多任务依赖关系管理与执行

使用方法和配置说明

环境变量配置

Docker部署示例

基本部署（需提前准备MySQL数据库）

bash
docker run -d \
  --name xxl-job-admin \
  -p 8080:8080 \
  -e SPRING_DATASOURCE_URL="jdbc:mysql://192.168.1.100:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai" \
  -e SPRING_DATASOURCE_USERNAME="xxl_job" \
  -e SPRING_DATASOURCE_PASSWORD="xxl_job_password" \
  xuxueli/xxl-job-admin:2.4.0

Docker Compose部署（含MySQL）

创建docker-compose.yml文件：

yaml
version: '3'
services:
  mysql:
    image: mysql:8.0
    container_name: xxl-job-mysql
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: xxl_job
      MYSQL_USER: xxl_job
      MYSQL_PASSWORD: xxl_job_password
    volumes:
      - ./sql:/docker-entrypoint-initdb.d
    ports:
      - "3306:3306"
    networks:
      - xxl-job-network

  xxl-job-admin:
    image: xuxueli/xxl-job-admin:2.4.0
    container_name: xxl-job-admin
    depends_on:
      - mysql
    environment:
      SPRING_DATASOURCE_URL: "jdbc:mysql://mysql:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai"
      SPRING_DATASOURCE_USERNAME: "xxl_job"
      SPRING_DATASOURCE_PASSWORD: "xxl_job_password"
      SERVER_PORT: 8080
    ports:
      - "8080:8080"
    networks:
      - xxl-job-network

networks:
  xxl-job-network:
    driver: bridge

初始化数据库

需提前在MySQL中创建xxl_job数据库，并执行官方提供的初始化SQL脚本（可从https://github.com/xuxueli/xxl-job%E8%8E%B7%E5%8F%96%60doc/db/tables_xxl_job.sql%60%EF%BC%89%E3%80%82

访问与使用

1. 部署完成后，通过http://localhost:8080/xxl-job-admin访问管理控制台
2. 默认登录账号：admin，密码：123456
3. 在控制台中配置执行器、创建任务、设置调度规则并启动任务

注意事项

• 生产环境建议使用外部独立数据库，避免容器内数据库数据丢失
• 根据业务需求调整JVM参数，可通过JAVA_OPTS环境变量设置（如-e JAVA_OPTS="-Xms512m -Xmx512m"）
• 集群部署时，需确保所有节点连接同一数据库，且服务端口不冲突
• 定期备份数据库，防止任务配置数据丢失