引导者

# 简介XXL-JOB 是一个分布式任务调度平台，支持定时任务的管理与执行。它具有简单易用、功能丰富等特点，广泛应用于企业级项目中。而 Docker 的出现极大简化了应用部署流程，通过容器化技术让环境配置更加便捷。本文将详细介绍如何使用 Docker 安装和运行 XXL-JOB。---## 一、准备工作### 1.1 系统要求 - 操作系统：Linux（推荐 Ubuntu 或 CentOS） - Docker 版本：19.03 及以上 - Docker Compose 版本：1.25 及以上### 1.2 环境配置 在开始之前，请确保以下工具已正确安装： - Docker：可以通过官方文档进行安装。 - Docker Compose：用于管理多个容器的应用场景。安装完成后，可以通过以下命令验证版本信息： ```bash docker --version docker-compose --version ```---## 二、拉取 XXL-JOB 镜像XXL-JOB 提供了官方的 Docker 镜像，可以直接从 Docker Hub 下载。以下是拉取镜像的步骤：```bash docker pull xuxueli/xxl-job-admin ```此镜像包含了 XXL-JOB 的核心组件，包括调度中心和执行器。---## 三、创建并启动容器### 3.1 创建网络 为了方便容器之间的通信，建议先创建一个自定义的 Docker 网络： ```bash docker network create xxl-job-net ```### 3.2 启动调度中心 调度中心是 XXL-JOB 的核心服务，负责任务的管理和调度。可以使用以下命令启动调度中心容器： ```bash docker run -d \--name xxl-job-admin \--network xxl-job-net \-p 8080:8080 \-v /path/to/config:/data/appadmin \xuxueli/xxl-job-admin ``` 参数说明： - `-d`：后台运行容器。 - `--name`：指定容器名称。 - `--network`：连接到自定义网络。 - `-p`：映射端口，将宿主机的 8080 端口映射到容器内的 8080 端口。 - `-v`：挂载本地目录 `/path/to/config` 到容器内 `/data/appadmin` 目录，用于存储配置文件。### 3.3 启动执行器 执行器是 XXL-JOB 的任务执行节点，通常需要部署多个实例以提高可用性。以下是启动执行器容器的示例： ```bash docker run -d \--name xxl-job-executor \--network xxl-job-net \-e XXL_JOB_ADMINAddresses=http://<调度中心IP>:8080 \-e XXL_JOB ExecutorPort=9999 \-e XXL_JOB LogPath=/data/logs/xxl-job \-v /path/to/logs:/data/logs/xxl-job \xuxueli/xxl-job-executor ``` 参数说明： - `XXL_JOB_ADMINAddresses`：指定调度中心的地址。 - `XXL_JOB ExecutorPort`：执行器监听的端口号。 - `XXL_JOB LogPath`：日志存储路径。 - `-v`：挂载本地目录 `/path/to/logs` 到容器内 `/data/logs/xxl-job`。---## 四、访问调度中心启动完成后，可以通过浏览器访问调度中心的 Web 界面。默认登录地址为： ``` http://<宿主机IP>:8080/xxl-job-admin ``` 初始用户名和密码均为 `admin`。---## 五、配置执行器登录调度中心后，需要手动添加执行器信息： 1. 进入“执行器管理”页面。 2. 点击“新增执行器”，填写相关信息（如执行器名称、IP 地址、端口等）。 3. 保存配置后，执行器即可被调度中心识别并管理。---## 六、常见问题### 6.1 容器无法启动 检查是否有端口冲突或挂载目录权限问题。### 6.2 调度中心无法访问 确认防火墙规则是否允许外部访问 8080 端口。### 6.3 执行器未注册成功 确保调度中心和执行器之间的网络连通性正常。---## 七、总结通过 Docker 安装 XXL-JOB 极大地简化了部署过程，使得开发者能够快速搭建任务调度平台。本文详细介绍了从准备到实际部署的全过程，希望对读者有所帮助。如果遇到问题，可以参考官方文档或社区论坛获取更多支持。

简介XXL-JOB 是一个分布式任务调度平台，支持定时任务的管理与执行。它具有简单易用、功能丰富等特点，广泛应用于企业级项目中。而 Docker 的出现极大简化了应用部署流程，通过容器化技术让环境配置更加便捷。本文将详细介绍如何使用 Docker 安装和运行 XXL-JOB。---

一、准备工作

1.1 系统要求 - 操作系统：Linux（推荐 Ubuntu 或 CentOS） - Docker 版本：19.03 及以上 - Docker Compose 版本：1.25 及以上

1.2 环境配置 在开始之前，请确保以下工具已正确安装： - Docker：可以通过官方文档进行安装。 - Docker Compose：用于管理多个容器的应用场景。安装完成后，可以通过以下命令验证版本信息： ```bash docker --version docker-compose --version ```---

二、拉取 XXL-JOB 镜像XXL-JOB 提供了官方的 Docker 镜像，可以直接从 Docker Hub 下载。以下是拉取镜像的步骤：```bash docker pull xuxueli/xxl-job-admin ```此镜像包含了 XXL-JOB 的核心组件，包括调度中心和执行器。---

三、创建并启动容器

3.1 创建网络 为了方便容器之间的通信，建议先创建一个自定义的 Docker 网络： ```bash docker network create xxl-job-net ```

3.2 启动调度中心 调度中心是 XXL-JOB 的核心服务，负责任务的管理和调度。可以使用以下命令启动调度中心容器： ```bash docker run -d \--name xxl-job-admin \--network xxl-job-net \-p 8080:8080 \-v /path/to/config:/data/appadmin \xuxueli/xxl-job-admin ``` 参数说明： - `-d`：后台运行容器。 - `--name`：指定容器名称。 - `--network`：连接到自定义网络。 - `-p`：映射端口，将宿主机的 8080 端口映射到容器内的 8080 端口。 - `-v`：挂载本地目录 `/path/to/config` 到容器内 `/data/appadmin` 目录，用于存储配置文件。

3.3 启动执行器 执行器是 XXL-JOB 的任务执行节点，通常需要部署多个实例以提高可用性。以下是启动执行器容器的示例： ```bash docker run -d \--name xxl-job-executor \--network xxl-job-net \-e XXL_JOB_ADMINAddresses=http://<调度中心IP>:8080 \-e XXL_JOB ExecutorPort=9999 \-e XXL_JOB LogPath=/data/logs/xxl-job \-v /path/to/logs:/data/logs/xxl-job \xuxueli/xxl-job-executor ``` 参数说明： - `XXL_JOB_ADMINAddresses`：指定调度中心的地址。 - `XXL_JOB ExecutorPort`：执行器监听的端口号。 - `XXL_JOB LogPath`：日志存储路径。 - `-v`：挂载本地目录 `/path/to/logs` 到容器内 `/data/logs/xxl-job`。---

四、访问调度中心启动完成后，可以通过浏览器访问调度中心的 Web 界面。默认登录地址为： ``` http://<宿主机IP>:8080/xxl-job-admin ``` 初始用户名和密码均为 `admin`。---

五、配置执行器登录调度中心后，需要手动添加执行器信息： 1. 进入“执行器管理”页面。 2. 点击“新增执行器”，填写相关信息（如执行器名称、IP 地址、端口等）。 3. 保存配置后，执行器即可被调度中心识别并管理。---

六、常见问题

6.1 容器无法启动 检查是否有端口冲突或挂载目录权限问题。

6.2 调度中心无法访问 确认防火墙规则是否允许外部访问 8080 端口。

6.3 执行器未注册成功 确保调度中心和执行器之间的网络连通性正常。---

七、总结通过 Docker 安装 XXL-JOB 极大地简化了部署过程，使得开发者能够快速搭建任务调度平台。本文详细介绍了从准备到实际部署的全过程，希望对读者有所帮助。如果遇到问题，可以参考官方文档或社区论坛获取更多支持。