单机部署xxl-job – 大雄的家

一、环境概览与部署思路

准备云服务器（本文以腾讯云 CVM 为例，操作系统为 CentOS 8）。
安装并配置基础环境：JDK（1.8+）和 Maven，用于编译并运行 XXL-JOB；安装并配置 MySQL 8.0 数据库。
获取 XXL-JOB 源码并编译：通过 Maven 打包生成可执行 JAR 包（xxl-job-admin）。
配置并启动 XXL-JOB Admin：作为调度中心，部署在同一台服务器上。
配置安全组及防火墙：只开放必要端口（比如：SSH/22、XXL-JOB Admin/8080、MySQL/3306 是否对外开放视需求）。
验证部署：通过访问外网 http://<服务器IP>:8080 测试 XXL-JOB Admin 页面是否正常。

二、准备云服务器（CVM）

略

三、安装基础环境

1. 更新系统

sudo yum -y update

2. 安装 OpenJDK 1.8

略

3. 安装 Maven

sudo yum install -y maven

验证安装：

mvn -version

如能正确显示 Maven 版本号（例如 Apache Maven 3.5.x 或更高），表示安装成功。

四、安装 MySQL 8.0

略

五、配置数据库、创建表结构

登录数据库：

mysql -u root -p

录数据库，导入 XXL-JOB 提供的 SQL 表结构：

XXL-JOB 在源码中自带初始化表结构脚本文件 /xxl-job/doc/db/tables_xxl_job.sql。
可先将其内容复制出来，然后在 MySQL 命令行中执行：

mysql -u root -p < tables_xxl_job.sql

六、获取 XXL-JOB 源码

安装 Git（若未安装）：

sudo yum install -y git

克隆 XXL-JOB 源码（以 GitHub 为例，Gitee 类似）：

git clone https://github.com/xuxueli/xxl-job.git
cd xxl-job

切换到合适的分支或 Tag（示例以 v2.4.2 为例）：

git checkout v2.4.2

七、配置 XXL-JOB Admin 并编译打包

调度中心配置文件地址：

/xxl-job/xxl-job-admin/src/main/resources/application.properties

调度中心配置内容说明（参考官方文档分布式任务调度平台XXL-JOB）：

单机部署主要修改数据库密码

### 调度中心JDBC链接：链接地址请保持和 2.1章节 所创建的调度数据库的地址一致
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/xxl_job?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=root_pwd
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
### 报警邮箱
spring.mail.host=smtp.qq.com
spring.mail.port=25
spring.mail.username=xxx@qq.com
spring.mail.password=xxx
spring.mail.properties.mail.smtp.auth=true
spring.mail.properties.mail.smtp.starttls.enable=true
spring.mail.properties.mail.smtp.starttls.required=true
spring.mail.properties.mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory
### 调度中心通讯TOKEN [选填]：非空时启用；
xxl.job.accessToken=
### 调度中心通讯超时时间[选填]，单位秒；默认3s；
xxl.job.timeout=3
### 调度中心国际化配置 [必填]： 默认为 "zh_CN"/中文简体, 可选范围为 "zh_CN"/中文简体, "zh_TC"/中文繁体 and "en"/英文；
xxl.job.i18n=zh_CN
## 调度线程池最大线程配置【必填】
xxl.job.triggerpool.fast.max=200
xxl.job.triggerpool.slow.max=100
### 调度中心日志表数据保存天数 [必填]：过期日志自动清理；限制大于等于7时生效，否则, 如-1，关闭自动清理功能；
xxl.job.logretentiondays=30

进入 `xxl-job-admin` 模块并执行 Maven 打包：

cd xxl-job-admin
mvn clean package -Dmaven.test.skip=true

在网络和依赖正常的情况下，会自动下载相关依赖并编译打包，最终在 target/ 目录下生成 xxl-job-admin-*.jar（例如 xxl-job-admin-2.4.2.jar）。

启动 XXL-JOB Admin

nohup java -jar xxl-job-admin-2.4.2.jar > xxl-admin.log 2>&1 &

转换成服务，开机自启

打开服务文件编辑器

sudo nano /etc/systemd/system/xxl-job-admin.service

编写服务文件 在文件中添加以下内容：

Description=XXL Job Admin Service
After=network.target

[Service]
User=your_user                # 替换为运行服务的用户（如 root 或普通用户）
Group=your_group              # 替换为用户所属组
WorkingDirectory=/path/to/xxl-job  # 替换为 XXL-JOB 项目的工作目录路径
ExecStart=/usr/bin/java -jar xxl-job-admin-2.4.2.jar
StandardOutput=append:/path/to/output.log   # 替换为实际日志路径
StandardError=append:/path/to/output.log    # 替换为实际日志路径
Restart=always

[Install]
WantedBy=multi-user.target

重新加载 systemd 配置

sudo systemctl daemon-reload

启动服务

sudo systemctl start xxl-job-admin

设置开机自启

sudo systemctl enable xxl-job-admin

八、（可选）部署 XXL-JOB 执行器

参考官方文档分布式任务调度平台XXL-JOB

九、安全组配置（最小开放原则）

1. 腾讯云安全组
在腾讯云控制台 > 云服务器 > 安全组，找到对应实例的安全组，按需开放端口：

只开放必要端口（比如：SSH/22、XXL-JOB Admin/8080、MySQL/3306 是否对外开放视需求、执行器相关端口，如:9997-9999）。

十、验证部署

查看服务进程：

ps -ef | grep xxl-job-admin

确保进程已在后台运行。

访问 XXL-JOB Admin
在浏览器输入：

http://<云服务器公网IP>:8080/

若出现 XXL-JOB 登录页面，即表示成功。输入配置文件里设置的登录账号密码（默认 admin/123456）即可进入调度中心。