中文 | English

一个基于系统 crontab 的脚本任务管理工具。所有任务都会被转换为 bash 脚本并添加到 crontab 中执行，即使管理器停止，任务仍会按计划执行。

• 📝 可视化 crontab 管理 - 通过 Web 界面管理定时任务
• 🐚 纯 Bash 执行 - 所有任务统一转换为 bash 脚本
• 🔄 两种任务类型 - 单次执行任务 和 守护进程任务（自动重启）
• ⏸️ 任务暂停 - 暂停任务而不从 crontab 中移除
• ⏰ 系统级调度 - 使用系统 crontab，管理器停止不影响任务执行
• 📊 执行日志 - 查看任务的执行历史和输出
• 🗑️ 选择性删除 - 删除时可选择保留或删除脚本和日志
• 🔄 实时同步 - 任务修改自动同步到 crontab

• 后端: Python + FastAPI + Pydantic
• 前端: Next.js 14 + React + TypeScript + Tailwind CSS
• 调度: 系统 crontab
• 存储: 以 crontab 为单一数据源（无数据库）

• Ubuntu 22.04 (推荐)
• Python 3.9+
• Node.js 18+
• cron

# 克隆项目 git clone https://github.com/RoadToQuant/CrontabManager.git cd CrontabManager # 部署（安装依赖） ./deploy.sh # 配置环境（可选） cp .env.example .env cp frontend/.env.example frontend/.env.local # 启动服务 ./start.sh # 查看状态 ./status.sh # 停止服务 ./stop.sh

访问 http://localhost:3000 （或你配置的 FRONTEND_PORT）

# 后端 cd backend python3 -m venv venv source venv/bin/activate pip install -r requirements.txt python main.py # 前端（新终端） cd frontend npm install npm run dev

适用于每个调度周期执行一次然后退出的任务。适合定时备份、数据同步、报告等。

步骤：

1. 点击 "新建任务"
2. 选择 "单次执行任务" 类型
3. 填写基本信息：
   • 任务名称：每日备份
   • 描述：每天凌晨2点备份数据
   • Cron 表达式：0 2 * * *（每天凌晨2点）
4. 编写 bash 脚本：

#!/bin/bash echo "========================================" echo "备份开始时间: $(date)" echo "========================================" # 备份数据 tar -czf /backup/data_$(date +%Y%m%d).tar.gz /home/ubuntu/data/ echo "备份完成时间: $(date)" echo "========================================"

5. （可选）设置工作目录和环境变量
6. 勾选 "立即启用"
7. 点击 "创建任务"

用于将现有脚本包装为守护进程。监控进程状态，崩溃后自动重启。适合长期运行的服务。

场景示例：

你有一个 Jupyter Server 启动脚本位于 /home/ubuntu/projects/services/start_jupyterserver.sh，希望确保它持续运行。

步骤：

1. 点击 "新建任务"
2. 选择 "守护进程任务" 类型
3. 填写基本信息：
   • 任务名称：Jupyter Server 守护
   • 描述：监控并自动重启 Jupyter Server
   • Cron 表达式：* * * * *（每分钟检查）
4. 配置守护进程设置：
   • 目标脚本：/home/ubuntu/projects/services/start_jupyterserver.sh
   • 进程名称：jupyter（用于通过 pgrep 识别进程）
   • 自动重启：✓ 启用
   • 重启延迟：5 秒
   • 最大重启次数：3

守护进程工作原理：

1. Cron 每分钟执行包装脚本
2. 脚本检查目标进程是否运行（通过 PID 文件 + 进程名）
3. 如果正常运行，退出等待下次检查
4. 如果进程不存在，执行启动脚本
5. 记录新 PID 到文件
6. 如果启用自动重启，失败时重试最多指定次数

* * * * * │ │ │ │ │ │ │ │ │ └── 星期 (0-6, 0=周日) │ │ │ └──── 月份 (1-12) │ │ └────── 日期 (1-31) │ └──────── 小时 (0-23) └────────── 分钟 (0-59) 

常用示例：

任务状态：

• 已启用 - 任务在 crontab 中激活（未注释）
• 已禁用 - 任务在 crontab 中被注释
• 已暂停 - 任务被暂停，保留在 crontab 中（已注释），可恢复

操作：

CrontabManager/ ├── backend/ # FastAPI 后端 │ ├── api/ # API 路由 │ ├── services/ # 业务逻辑 │ │ ├── crontab_manager.py # crontab 操作 │ │ ├── task_runner.py # 手动执行 │ │ ├── file_storage.py # 脚本文件管理 │ │ ├── log_manager.py # 日志文件管理 │ │ └── task_templates.py # 脚本模板生成器 │ ├── data/ # 数据目录 │ │ └── scripts/ # 任务脚本 │ │ └── task_{id}/ │ │ ├── run.sh # 生成的脚本 │ │ └── cron.log # 执行日志 │ ├── main.py # 入口文件 │ ├── models.py # Pydantic 模型 │ ├── config.py # 配置 │ └── requirements.txt ├── frontend/ # Next.js 前端 │ ├── app/ # 页面路由 │ ├── components/ # 组件 │ ├── lib/ │ │ └── api.ts # API 客户端 │ ├── next.config.js # Next.js 配置 │ └── .env.example # 前端环境变量示例 ├── .github/ │ └── workflows/ │ └── release.yml # 自动发布工作流 ├── .env.example # 后端环境变量示例 ├── deploy.sh # 部署脚本 ├── start.sh # 启动脚本 ├── stop.sh # 停止脚本 ├── status.sh # 状态检查脚本 ├── VERSION # 版本文件 └── README.md 

复制 .env.example 到 .env 并配置：

cp .env.example .env

核心设置：

示例 .env：

# 后端配置 BACKEND_HOST=0.0.0.0 BACKEND_PORT=8000 # 数据目录 DATA_DIR=./data SCRIPTS_DIR=./data/scripts # crontab 配置 CRONTAB_USER= CRON_TASK_PREFIX=# script-monitor-task: # 高级配置 LOG_LEVEL=INFO

复制 frontend/.env.example 到 frontend/.env.local：

cp frontend/.env.example frontend/.env.local

使用不同后端地址：

# 如果后端在另一台机器 NEXT_PUBLIC_API_URL=http://192.168.1.100:8000 # 或不同端口 NEXT_PUBLIC_API_URL=http://localhost:8080

要运行在不同端口，编辑两个 .env 文件：

.env（后端）：

BACKEND_PORT=8080

frontend/.env.local：

PORT=8081 NEXT_PUBLIC_API_URL=http://localhost:8080

然后重启服务：

./stop.sh ./start.sh

部署后，项目根目录提供以下脚本：

所有脚本从 .env 文件读取端口配置。

适用于开发调试，支持代码热重载：

./start_dev.sh

特性：

• 后端热重载：Python 代码修改后自动重启
• 前端热重载：React 组件修改后自动刷新浏览器
• 实时日志：日志直接输出到终端
• Ctrl+C 停止：一键停止所有服务

适用于生产部署，高性能运行：

# 首次启动 ./start_prod.sh # 重启（先停止现有服务） ./start_prod.sh --restart

特性：

• 多进程后端：使用多个 worker 进程处理请求（默认 4 个）
• 前端构建：自动执行 npm run build 生成优化版本
• 后台运行：服务在后台运行，不占用终端
• 日志文件：日志写入 logs/ 目录
• 端口检查：自动检测端口占用并提示

生产环境环境变量：

# .env BACKEND_WORKERS=4 # 根据 CPU 核心数调整

make dev # 启动开发服务器 make build # 构建生产版本 make test # 运行测试 make format # 格式化代码 make clean # 清理缓存

1. 更新 VERSION 文件：

   echo "0.2.0" > VERSION

2. 提交并推送到 master：

   git add VERSION git commit -m "chore: bump version to 0.2.0" git push origin master

3. 合并到 release 分支（触发自动发布）：

   git checkout release git merge master git push origin release

GitHub Actions 将自动：

• 从 VERSION 文件读取版本
• 创建 git 标签（如 v0.2.0）
• 创建 GitHub Release

与传统使用数据库的任务管理器不同，Crontab Manager 使用系统 crontab 作为单一数据源。

任务数据以 JSON 格式存储在 crontab 注释中：

# script-monitor:{"id":1,"name":"每日备份","status":"enabled",...} 0 2 * * * /opt/crontab-manager/backend/data/scripts/task_1/run.sh >> /opt/crontab-manager/backend/data/scripts/task_1/cron.log 2>&1

优势：

• 无需数据库
• 任务在管理器重启/崩溃后仍然保留
• 原生 crontab 可靠性
• 易于检查和调试

1. 单次任务：直接执行脚本，完成后退出
2. 守护进程任务：包装脚本检查进程状态，需要时启动

• 执行输出重定向到 cron.log
• 通过 Web UI 查看日志
• 可选：自定义日志路径
• 清空日志不影响任务

查看 CHANGELOG.md

欢迎提交 Issue 和 Pull Request！

查看 CONTRIBUTING.md

MIT