sersoong/xxl-job

XXL-Job Docker镜像文档

镜像概述

XXL-Job Docker镜像是基于XXL-Job分布式任务调度平台构建的容器化部署包。XXL-Job是一个轻量级、高性能、分布式的任务调度框架，支持定时任务、任务编排、失败重试、监控告警等功能，广泛应用于企业级任务调度场景。该镜像提供标准化部署方式，简化环境配置，支持快速集成到容器化架构中。

核心功能与特性

• 分布式调度：支持集群部署，任务可在多节点间负载均衡执行，提高系统可用性与吞吐量。
• 任务管理：提供任务CRUD、启停控制、执行日志查看等全生命周期管理功能。
• 丰富的任务类型：支持Bean模式、GLUE模式（Java/Shell/Python/PHP等）、远程HTTP任务等多种任务类型。
• 监控与告警：实时监控任务执行状态，支持邮件、短信等告警方式，及时发现任务异常。
• 失败重试：支持任务失败自动重试，可配置重试次数与间隔，提高任务可靠性。
• 容器化优化：基于Alpine基础镜像构建，体积小巧，支持环境变量配置，适配容器编排平台（如K8s、Docker Compose）。

使用场景

• 定时任务调度：如数据同步、报表生成、日志清理等周期性任务。
• 分布式任务处理：需多节点协同执行的大规模任务，如分布式计算、数据分片处理。
• 任务监控与运维：需要实时跟踪任务状态、快速定位故障的企业级应用。
• 微服务架构集成：作为独立任务调度服务，与微服务体系解耦，提供跨服务任务调度能力。

使用方法

前置条件

• 已安装Docker环境（Docker 19.03+）。
• 需提前部署MySQL数据库（XXL-Job依赖MySQL存储任务元数据），并初始化https://github.com/xuxueli/xxl-job/blob/master/doc/db/tables_xxl_job.sql%E3%80%82

快速启动（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_ACCESS_TOKEN=default_token \
  xuxueli/xxl-job-admin:2.4.0

Docker Compose配置

创建docker-compose.yml文件：

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:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=root
      - XXL_JOB_ACCESS_TOKEN=default_token
    depends_on:
      - mysql
    restart: always

  mysql:
    image: mysql:8.0
    container_name: xxl-job-mysql
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=xxl_job
    volumes:
      - ./tables_xxl_job.sql:/docker-entrypoint-initdb.d/tables_xxl_job.sql
    restart: always

执行启动命令：

bash
docker-compose up -d

核心配置参数

访问与使用

1. 启动后，通过 http://localhost:8080/xxl-job-admin 访问管理界面。
2. 默认登录账号：admin，密码：123456。
3. 在管理界面中配置执行器（任务执行节点）、创建任务、监控任务状态。

注意事项

• 生产环境中需修改XXL_JOB_ACCESS_TOKEN为强密钥，避免未授权访问。
• 数据库需配置持久化存储，防止任务元数据丢失。
• 高可用部署时，可部署多个xxl-job-admin实例，通过负载均衡器（如Nginx）对外提供服务。