lizheng007/xxl-job

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

镜像概述

XXL-Job是由许雪里开发的分布式任务调度平台，旨在解决分布式环境下任务调度的一致性、可靠性和可扩展性问题。该镜像封装了XXL-Job的核心组件，包括调度中心（Admin）和执行器（Executor），提供开箱即用的分布式任务调度能力，支持多种任务类型（如Bean、GLUE脚本、远程HTTP等），广泛应用于各类定时任务场景。

核心功能与特性

• 分布式调度：支持集群部署，任务调度由调度中心统一协调，避免单点故障
• 多样化任务类型：支持Bean模式、GLUE（Java/Shell/Python/PHP/NodeJS）模式、远程HTTP任务等
• 任务生命周期管理：提供任务创建、启动、暂停、删除、触发等全生命周期操作
• 监控与告警：实时监控任务执行状态，支持失败重试、超时控制及邮件/短信告警
• 弹性扩容：执行器支持动态扩容，调度中心自动发现新增执行器节点
• 日志管理：提供任务执行日志的在线查看、搜索与下载功能
• 高可用设计：调度中心支持集群部署，通过数据库锁保证调度一致性

使用场景与适用范围

XXL-Job适用于需要定时执行任务的各类业务场景，包括但不限于：

• 电商平台：订单超时自动取消、优惠券过期提醒、库存定时同步
• 数据处理：日志定时清洗、数据统计报表生成、ETL数据同步
• 系统运维：服务健康检查、定时备份、缓存预热与清理
• 消息推送：定时消息发送、通知提醒、营销活动推送

使用方法与配置说明

前置条件

• 需提前准备MySQL数据库（5.7+），并执行https://github.com/xuxueli/xxl-job/blob/master/doc/db/tables_xxl_job.sql
• 确保Docker环境已安装并运行

调度中心（Admin）部署

Docker Run 命令

bash
docker run -d \
  --name xxl-job-admin \
  -p 8080:8080 \
  -e SPRING_DATASOURCE_URL="jdbc:mysql://mysql-host:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai" \
  -e SPRING_DATASOURCE_USERNAME=root \
  -e SPRING_DATASOURCE_PASSWORD=root \
  -e XXL_JOB_ADMIN_ACCESS_TOKEN=default_token \
  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:
      - 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
      - XXL_JOB_ADMIN_ACCESS_TOKEN=default_token
    restart: always

环境变量说明

执行器（Executor）部署

Docker Run 命令

bash
docker run -d \
  --name xxl-job-executor \
  -p 9999:9999 \
  -e XXL_JOB_EXECUTOR_APPNAME=xxl-job-executor-sample \
  -e XXL_JOB_EXECUTOR_IP= \
  -e XXL_JOB_EXECUTOR_PORT=9999 \
  -e XXL_JOB_ADMIN_ADDRESSES=http://xxl-job-admin:8080/xxl-job-admin \
  -e XXL_JOB_ACCESS_TOKEN=default_token \
  -e XXL_JOB_EXECUTOR_LOGPATH=/data/applogs/xxl-job/jobhandler \
  -e XXL_JOB_EXECUTOR_LOGRETENTIONDAYS=30 \
  xuxueli/xxl-job-executor-sample:2.4.0

环境变量说明

访问调度中心

部署完成后，通过浏览器访问 http://<调度中心IP>:8080/xxl-job-admin，默认登录账号：admin，密码：***。登录后可进行任务管理、执行器配置、监控报表等操作。

注意事项

• 调度中心与执行器的版本需保持一致，避免兼容性问题
• 生产环境中建议修改默认访问令牌（XXL_JOB_ADMIN_ACCESS_TOKEN）以提高安全性
• 数据库需定期备份，避免任务配置数据丢失
• 执行器日志路径建议通过数据卷挂载，避免容器重启后日志丢失