yangjinhai/xxl-job

XXL-JOB Docker镜像文档

镜像概述

XXL-JOB是一款分布式任务调度平台，旨在解决分布式系统中的任务调度问题。该Docker镜像封装了XXL-JOB的核心服务，提供开箱即用的分布式任务调度能力，支持任务的创建、执行、监控和管理，适用于各类需要定时或触发式任务调度的场景。

核心功能与特性

• 分布式调度：支持集群部署，任务可在多节点间负载均衡执行
• 任务管理：提供可视化界面，支持任务创建、编辑、启停、删除等操作
• 丰富的任务类型：支持Bean模式、GLUE模式（Java/Shell/Python/PHP等）、远程HTTP调用等
• 失败处理：支持失败重试、失败告警（邮件、钉钉等）
• 任务编排：支持任务依赖、串行/并行执行
• 监控与日志：提供任务执行日志、执行状态监控、统计分析
• 高可用设计：支持集群部署，避免单点故障

使用场景与适用范围

• 定时任务执行（如数据备份、报表生成、定时通知）
• 微服务架构下的跨服务任务调度
• 大数据处理任务触发与协调
• 系统监控与告警任务
• 电商场景中的定时活动、库存更新等

使用方法与配置说明

环境准备

使用前需准备MySQL数据库（5.7+），并初始化XXL-JOB所需表结构（SQL脚本可从https://github.com/xuxueli/xxl-job/blob/master/doc/db/tables_xxl_job.sql%E8%8E%B7%E5%8F%96%EF%BC%89%E3%80%82

镜像拉取

bash
docker pull xuxueli/xxl-job-admin:2.4.0  # 替换为最新版本

基本运行（docker run）

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 \
             --xxl.job.accessToken=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:
      - 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
               --xxl.job.accessToken=default_token
    depends_on:
      - mysql
    restart: always

  mysql:
    image: mysql:5.7
    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  # 挂载初始化SQL脚本
    restart: always

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

通过PARAMS环境变量传递配置参数，常用参数说明：

访问管理界面

服务启动后，通过http://localhost:8080/xxl-job-admin访问管理界面，默认账号密码：admin/123456。

数据持久化

建议通过挂载目录持久化日志文件，添加如下挂载配置：

bash
-v /path/to/logs:/data/applogs

注意事项

• 数据库需提前初始化，否则服务无法正常启动
• 生产环境建议修改默认访问令牌（accessToken）
• 集群部署时，多实例需连接同一数据库，确保配置一致
• 版本升级前请备份数据库数据