Skip to content
使用指南

项目简介

从整体认识 Chet.QuartzNet.UI:它解决什么问题、具备哪些能力,以及适合什么样的项目。

更新于 2026-11-17MIT 开源

项目简介 ​

1. 它是什么 ​

Chet.QuartzNet.UI 是一个基于 .NET 8.0 / .NET 10.0 与 Quartz.Net 的可视化作业调度管理系统。它把 Quartz.Net 的作业、触发器、Cron 表达式、执行日志等概念,封装成一套开箱即用的 Web 管理界面。

你只需要在现有的 ASP.NET Core 项目中安装一个 NuGet 包、注入两个服务,就可以通过浏览器完成定时任务的创建、管理、监控与通知配置,而不必为每个作业编写调度代码。

登录界面

分析页

2. 解决什么问题 ​

直接使用 Quartz.Net 通常需要:

  • 为每个作业编写 IJob 实现与 JobDetail / Trigger 注册代码;
  • 自己维护 Cron 表达式、启停状态和执行历史;
  • 额外开发一套管理界面与权限认证;
  • 处理失败重试、执行通知、日志清理等运维问题。

Chet.QuartzNet.UI 把上述工作收敛到一个组件包中:

传统做法Chet.QuartzNet.UI
手写作业注册代码界面创建,或 [QuartzJob] 特性自动注册
自己实现管理后台内置 VbenAdmin 管理界面
自己记录执行历史内置执行日志与详情
自己实现通知内置 PushPlus 多渠道通知
自己处理存储文件 / 四种数据库,可迁移
自己加认证内置 JWT 认证

3. 核心特性 ​

  • 可视化管理:作业的新增、编辑、复制、暂停、恢复、立即执行、删除全部在界面完成。
  • 实时监控:分析页提供 KPI 卡片、健康象限、时段热力图、耗时排行等可视化图表。
  • ClassJob 模式:用 [QuartzJob] 特性标记 C# 类,启动时自动扫描并注册。
  • API 作业模式:无需编写代码,通过 HTTP 请求触发外部接口。
  • 多种存储:文件存储零依赖;数据库存储支持 MySQL、PostgreSQL、SQL Server、SQLite。
  • 执行日志:完整记录开始时间、耗时、结果、错误信息与「已跳过」「中断」原因,并支持自动清理。
  • 中断恢复:执行开始即落库并持续心跳,进程崩溃后可识别中断并按策略自动补跑,也可手动重新执行。
  • 排水停机:停止接收新触发、等待执行中任务收尾后自动停止,超时标记中断,可随时恢复调度。
  • 失败重试:可配置重试次数与重试间隔,减少偶发失败带来的告警噪音。
  • 作业依赖:前置作业全部成功才执行,否则跳过并记录日志。
  • 通知集成:基于 PushPlus 推送至微信、企业微信、钉钉、邮件等渠道,支持 HTML / Markdown / 纯文本 / JSON 模板。
  • 数据迁移:五种存储任意互转,提供预检、进度、备份与迁移后校验。
  • 国际化与主题:内置中英文切换,跟随 VbenAdmin 的浅色 / 深色主题。
  • 无侵入集成:以 Razor Class Library 打包,安装后按需启用,不改变现有项目结构。

4. 技术栈 ​

层面技术
运行时.NET 8.0 / .NET 10.0
调度内核Quartz.Net 3.15.x
Web 框架ASP.NET Core(Razor Class Library 打包)
数据访问EF Core(数据库存储模式)
前端框架Vue 3 + VbenAdmin(Ant Design Vue)
表格 / 图表vxe-table、ECharts
认证JWT
通知服务PushPlus

5. 功能地图 ​

模块说明文档
分析页作业统计、健康象限、热力图、耗时排行分析页
作业管理作业增删改查、启停、批量操作、依赖配置、排水调度作业管理
日志管理执行历史、状态筛选、中断重跑、日志配置日志管理
通知管理通知配置、策略、历史、测试通知通知管理
系统配置服务标识、停机与恢复策略、数据迁移入口系统配置
多语言 / 主题中英文切换、浅色深色主题多语言与主题

6. 适用场景 ​

适合:

  • 已有 ASP.NET Core 项目,想快速补一套定时任务管理界面;
  • 中小型系统,希望用文件存储快速起步,后续再平滑切换到数据库;
  • 需要给运维 / 业务人员提供可视化配置入口,而不是改代码发版;
  • 需要执行历史、失败重试、失败通知等基础运维能力;
  • 希望以较低成本把多个零散定时任务集中管理。

不适合:

  • 需要审批流、RBAC 细粒度权限、操作审计等重型后台能力;
  • 需要复杂 DAG 编排、跨系统分布式调度的大规模场景。

Chet.QuartzNet.UI 的定位是轻量的定时任务可视化管理工具:配置能少就少,打开就能用。v2.7.0 起仍坚持不做 RBAC、审批流等重型功能。

7. 项目结构 ​

text
Chet.QuartzNet.UI/
├── src/
│   ├── Chet.QuartzNet.UI/                   # UI 组件、控制器、中间件(RCL)
│   ├── Chet.QuartzNet.Models/               # 实体与 DTO
│   ├── Chet.QuartzNet.EFCore/               # EF Core 数据访问核心
│   ├── Chet.QuartzNet.EFCore.MySql/         # MySQL 支持
│   ├── Chet.QuartzNet.EFCore.PostgreSql/    # PostgreSQL 支持
│   ├── Chet.QuartzNet.EFCore.SQLite/        # SQLite 支持
│   ├── Chet.QuartzNet.EFCore.SqlServer/     # SQL Server 支持
│   └── Chet.QuartzNet.Web/                  # 前端工程与示例
├── examples/
│   ├── Chet.QuartzNet.Database.Example/     # 数据库存储示例
│   └── Chet.QuartzNet.File.Example/         # 文件存储示例
└── docs/                                    # 文档与截图

8. 下一步 ​

让 Quartz.Net 调度,从未如此简单