在平常的开发工作中，我们经常会用到 xxl-job，之前用过 quartz、@schedule等定时任务，xxl-job 是分布式任务调度框架，那么在 docker 下如何安装 xxl-job 呢？今天简单总结下主要步骤。
1：拉取 xxl-job 镜像
docker pull xuxueli/xxl-job-admin:版本号
根据自己的需求，拉取合适的 xuxueli/xxl-job-admin 版本，如果 docker pull xuxueli/xxl-job-admin 命令，后面不写版本号，那么默认拉取最新的 xxl-job 镜像。拉取完成后，可以使用 docker images 命令查看拉取到的镜像，xxl-job-admin 镜像如下：
注意：如果拉取镜像失败，可能是 docker 配置文件的问题。在 /etc/docker/ 目录下，修改 daemon.json 文件中的配置的镜像加速器。镜像加速器网上搜索很多，尝试修改配置，修改完后一定要重启docker服务，不然不生效。重启 docker 命令：systemctl restart docker。
2：初始化 xxl-job 对应的表
如图所示：
3：docker-compose.yml
xxl-job-admin:
restart: always
# docker 镜像
image: xuxueli/xxl-job-admin:2.4.0
# 容器名称
container_name: xxl-job-admin
volumes:
# 日志目录映射到主机目录
- /docker/xxl_job/logs:/data/logs
ports:
# 端口映射
- "9018:9018"
environment:
# 设置启动参数
PARAMS: '
--server.port=9018
--server.servlet.context-path=/xxl-job-admin
--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=123456
--spring.mail.username=xxx-job
--spring.mail.password=123456
# 代码里面需要指定的token
--xxl.job.accessToken=123456789zxcvbnm'注意：在 docker-compose 中启动 xxl-job 时，连接 mysql 不能直接用 localhost，而需要用容器名（如 mysql）或服务名（如 mysql:3306），localhost 无法访问到 mysql 容器因为docker网络隔离机制，两者是不同的容器实例，有各自独立的网络栈。
4：启动
docker compose up xxl-job-admin，docker compose up -d 不阻塞当前命令窗口，docker compose up 阻塞当前命令页面，可以看到启动实时日志。
查看启动状态：docker ps
5：测试
(1)：通过 ip:端口号 进行访问，登录的密码维护在 xxl_job_user 表中，登录即可，页面如下：
可能遇到的问题，访问不通，那么可能是防火墙端口的问题，可能是 xxl-job 端口防火墙未开导致的，不同的内核版本有不同的对应命令，如果是 Centos 内核版本，查看版本可以用 cat /etc/os-release 命令，可以先查看 9018 端口是否开了防火墙，如果没开，则添加后重启防火墙，相关命令如下：
查看防火墙开端口：firewall-cmd --zone=public --list-ports
添加端口：firewall-cmd --zone=public --add-port=9018/tcp --permanent
重启防火墙：firewall-cmd --reload
(2)：登录后可在页面管理登录的用户，如图
(3)：新增执行器
(4)：新增定时任务
(5)：查看运行日志
6：总结
以上为 docker 下安装 xxl-job 的基本步骤，主要是拉取镜像、初始化 xxl-job 对应的表、编写启动容器的 docker-compose.yml 文件，通过 docker compose up -d 启动。启动完成后可以通过 docker ps 查看容器的启动状态，如果启动失败，可以通过 docker logs 容器名称查看失败日志，根据失败日志修改对应的问题。启动成功后，可以在浏览器中输入 ip 地址和端口进行访问，登录的用户名和密码在 xxl-job-user 表中。