docker如何安装xxl-job-admin

# Docker如何安装xxl-job-admin

## 一、xxl-job-admin简介

xxl-job是一个轻量级分布式任务调度平台，其核心设计目标是开发迅速、学习简单、轻量级、易扩展。xxl-job-admin是调度系统的管理后台，负责任务调度和管理。通过Docker容器化部署可以极大简化安装流程，实现快速部署。

## 二、安装前准备

### 1. 环境要求
- Docker 17.05+
- MySQL 5.7+
- 建议配置：2核CPU/4GB内存/20GB磁盘

### 2. 获取镜像
官方提供两种获取方式：
```bash
# 方式一：从Docker Hub拉取
docker pull xuxueli/xxl-job-admin:2.3.1

# 方式二：自行构建
git clone https://github.com/xuxueli/xxl-job.git
cd xxl-job
mvn clean package
docker build -t xxl-job-admin .

三、MySQL数据库配置

1. 创建数据库

CREATE DATABASE `xxl_job` DEFAULT CHARACTER SET utf8mb4;

2. 初始化表结构

执行官方提供的SQL脚本：

docker run -it --rm mysql:5.7 mysql -h[数据库IP] -u[用户名] -p[密码] xxl_job < /path/to/xxl-job/doc/db/tables_xxl_job.sql

四、启动xxl-job-admin容器

1. 基本启动命令

docker run -d \
  -p 8080:8080 \
  -e PARAMS="--spring.datasource.url=jdbc:mysql://[数据库IP]:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai \
  --spring.datasource.username=[用户名] \
  --spring.datasource.password=[密码]" \
  --name xxl-job-admin \
  xuxueli/xxl-job-admin:2.3.1

2. 推荐使用docker-compose

创建docker-compose.yml文件：

version: '3'
services:
  xxl-job:
    image: xuxueli/xxl-job-admin:2.3.1
    container_name: xxl-job-admin
    ports:
      - "8080:8080"
    environment:
      PARAMS: |
        --spring.datasource.url=jdbc:mysql://mysql:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8
        --spring.datasource.username=root
        --spring.datasource.password=123456
    depends_on:
      - mysql
    networks:
      - xxl-net

  mysql:
    image: mysql:5.7
    container_name: xxl-mysql
    environment:
      MYSQL_ROOT_PASSWORD: 123456
      MYSQL_DATABASE: xxl_job
    volumes:
      - ./mysql/data:/var/lib/mysql
      - ./mysql/init:/docker-entrypoint-initdb.d
    networks:
      - xxl-net

networks:
  xxl-net:
    driver: bridge

启动服务：

docker-compose up -d

五、访问与验证

1. 访问管理后台：

   http://服务器IP:8080/xxl-job-admin
   

2. 默认登录凭证：

   • 用户名：admin
   • 密码：123456

3. 检查健康状态：

   docker logs xxl-job-admin
   

六、常见问题解决

1. 数据库连接失败

检查： - 数据库IP是否正确 - 网络是否互通 - 用户名密码是否正确 - 数据库权限是否开放

2. 端口冲突

修改映射端口：

-p 8888:8080

3. 时区问题

添加时区参数：

-e TZ=Asia/Shanghai

七、升级与维护

1. 版本升级：

docker pull xuxueli/xxl-job-admin:新版本号
docker-compose down
docker-compose up -d

1. 数据备份： 定期备份MySQL数据库：

docker exec xxl-mysql mysqldump -u root -p123456 xxl_job > xxl_job_backup.sql

八、总结

通过Docker部署xxl-job-admin具有以下优势： - 环境隔离，避免污染主机环境 - 一键部署，简化安装流程 - 便于扩展和迁移 - 版本管理方便

建议生产环境配合Nginx做反向代理，并配置HTTPS安全访问。 “`