Repolode
fccview

fccview/cronmaster

带可读调度语法、实时日志和执行历史的 cron 任务管理网页界面。

Star
1,393
Fork
38
未关闭 Issue
8
最近提交
15天前

这是什么?

CronMaster 是一个网页界面,用于在宿主机上查看、创建和删除 cron 任务。调度时间可以通过快捷预设设置,每个任务还能添加注释说明用途。cron 任务所用的脚本也可以直接在浏览器中创建和编辑,并提供一组内置代码片段作为起点。

对于开启日志的任务,应用会记录标准输出、标准错误、退出码和时间戳,并自动清理旧记录;长时间运行的任务可通过 SSE 实时推送输出。未开启日志的任务会同步执行,超时时间为五分钟。仪表盘还展示运行时间、内存、CPU、网络和 GPU 等系统信息。

项目支持密码登录和 OIDC 单点登录,提供带可选 API Key 认证的 REST API,并提供 Docker 镜像。在 Docker 中运行需要 root 权限,并挂载 Docker socket 和数据卷;应用直接读写 crontab 文件,因此修改会即时同步到宿主机。

核心功能

  • 01创建、查看和删除 cron 任务,支持添加注释和快捷调度预设。
  • 02为开启日志的任务记录标准输出、标准错误、退出码和时间戳。
  • 03通过 SSE 实时推送长时间运行任务的输出和状态。
  • 04在浏览器中创建和编辑供 cron 任务调用的 bash 脚本。
  • 05支持密码登录和 OIDC 单点登录。
  • 06提供 REST API,可选 API Key 认证。

适用场景

  • 通过网页界面管理家用服务器或 NAS 上的定时维护脚本。
  • 排查失败任务时查看历史执行记录和输出。
  • 通过 REST API 让其他系统对接 cron 任务管理。
  • 在 Keycloak、Authentik 等 SSO 服务之后共享使用 cron 管理面板。

快速上手

  1. 1

    创建包含 README 中最小配置的 docker-compose.yml 文件

  2. 2

    使用 Docker Compose 构建并运行

    docker compose up --build
  3. 3

    在浏览器中打开 http://localhost:40123

使用前须知

  • Docker 部署需要以 root 身份运行容器、开启特权模式并挂载 Docker 套接字。
  • cron 操作需要 root 用户,不适合不愿以 root 运行的环境,除非改为本地运行。
  • 采用 AGPL-3.0 许可证,这是一种 Copyleft 许可证,通过网络提供修改版本时需要公开源代码。

标签

常见问题

cronmaster 是什么?
带可读调度语法、实时日志和执行历史的 cron 任务管理网页界面。 CronMaster 是一个网页界面,用于在宿主机上查看、创建和删除 cron 任务。调度时间可以通过快捷预设设置,每个任务还能添加注释说明用途。cron 任务所用的脚本也可以直接在浏览器中创建和编辑,并提供一组内置代码片段作为起点。
cronmaster 可以免费使用吗?用的什么许可证?
cronmaster 以 AGPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
cronmaster 还在维护吗?
活跃维护中。cronmaster 最近一次提交是在 2026年10月4日。
cronmaster 适合用来做什么?
通过网页界面管理家用服务器或 NAS 上的定时维护脚本。 排查失败任务时查看历史执行记录和输出。 通过 REST API 让其他系统对接 cron 任务管理。 在 Keycloak、Authentik 等 SSO 服务之后共享使用 cron 管理面板。
cronmaster 怎么安装和运行?
创建包含 README 中最小配置的 docker-compose.yml 文件 使用 Docker Compose 构建并运行: docker compose up --build 在浏览器中打开 http://localhost:40123
在哪里获取 cronmaster?
源代码和安装说明在 GitHub 上:https://github.com/fccview/cronmaster

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目