flyceek/xxl-job

XXL-Job 分布式任务调度平台 Docker 镜像

镜像概述

XXL-Job 是一个轻量级分布式任务调度平台，该 Docker 镜像封装了 XXL-Job 服务端（Admin）和执行器（Executor），提供开箱即用的分布式任务调度能力，支持任务的创建、执行、监控和管理，适用于各类需要定时或触发式任务调度的场景。

核心功能与特性

• 分布式调度：支持集群部署，任务均匀分配到多个执行器节点，提高任务处理效率
• 任务管理：提供Web界面管理任务，支持CRON表达式、任务参数、执行策略等配置
• 监控报警：实时监控任务执行状态，支持失败重试、邮件/短信报警
• 高可用：服务端集群部署确保调度中心高可用，执行器弹性伸缩
• 多语言支持：支持Java、Python、Go等多语言执行器集成

使用场景与适用范围

• 定时任务：如数据备份、报表生成、日志清理等周期性任务
• 分布式任务：需要多节点协同处理的大型任务，如数据同步、批量处理
• 微服务架构：在微服务环境中统一管理各服务的定时任务
• 高可靠任务：对任务执行可靠性要求高的场景，如***交易对账、订单超时处理

使用方法与配置说明

环境准备

• Docker 1.13+
• Docker Compose (可选，用于多容器部署)
• 数据库（MySQL 5.7+，用于存储任务元数据）

快速启动（服务端 Admin）

bash
docker run -d \
  --name xxl-job-admin \
  -p 8080:8080 \
  -e PARAMS="--spring.datasource.url=jdbc:mysql://mysql-host:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai \
              --spring.datasource.username=root \
              --spring.datasource.password=root" \
  xuxueli/xxl-job-admin:2.4.0

Docker Compose 配置示例

yaml
version: '3'
services:
  xxl-job-admin:
    image: xuxueli/xxl-job-admin:2.4.0
    container_name: xxl-job-admin
    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=root
    depends_on:
      - mysql
    networks:
      - xxl-job-network

  mysql:
    image: mysql:5.7
    container_name: xxl-job-mysql
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=xxl_job
    volumes:
      - ./sql:/docker-entrypoint-initdb.d
    networks:
      - xxl-job-network

networks:
  xxl-job-network:

核心配置参数（环境变量 PARAMS）

访问与使用

1. 启动容器后，访问 http://localhost:8080/xxl-job-admin
2. 默认登录账号：admin，密码：***
3. 在Web界面创建任务，配置执行器、CRON表达式、任务参数等
4. 启动执行器节点，注册到调度中心，开始任务调度

注意事项

• 首次启动需确保数据库已初始化，可通过挂载SQL脚本到MySQL容器的/docker-entrypoint-initdb.d目录
• 生产环境建议配置xxl.job.accessToken增强安全性
• 服务端和执行器建议使用集群部署以提高可用性