青龙面板把散落的定时任务收进一个面板的开源方案【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong凌晨三点一条 cron 任务悄悄失败了而你是早上九点打开日志才注意到。没有通知、没有记录、没有重试问题只能靠猜。青龙面板要解决的正是这类定时任务管理中的失控脚本、调度、变量、日志、通知放在同一个 Web 面板里管。项目定位青龙面板是一个免费开源的定时任务管理平台支持 Python3、JavaScript、Shell、TypeScript 四种脚本语言。它把脚本放哪、几点跑、失败谁管这三件事收拢到一个后台里数据存在本地 SQLite部署在自己机器上不依赖外部服务。 五分钟跑起来前置条件Docker 方式只需要装好 Docker源码方式需要 Node.js 14内存 1GB 以上够用。拉取代码源码方式需要先拿到项目。git clone https://gitcode.com/GitHub_Trending/qi/qinglong cd qinglong启动先装依赖并编译前后端再一次性拉起服务。npm install npm run build:front npm run build:back npm start验证浏览器打开http://localhost:5700按引导设置用户名密码能看到任务列表就算跑通了。部署方式选一句就好生产环境建议用 Docker 容器环境隔离、升级方便把data/目录挂出来脚本和日志都跟着宿主机走本地开发调试就直接装源码玩客云、树莓派这类低功耗设备跑 Docker 方案最省心仓库docker/目录里已备好 compose 文件和镜像构建脚本。⚙️ 功能拆解一条操作链路走下来写脚本。脚本管理页面支持在线新建和编辑带语法高亮文件落在data/scripts/目录认.js、.py、.ts、.sh等后缀。改完直接点运行试一次不用出浏览器。配调度。给脚本配一条 cron 表达式最小粒度到秒也可以只选每天 9 点这种预设。失败重试和任务依赖都在任务表单里配注意同时段任务太多会抢资源错峰安排。管变量。环境变量页面集中放 API key、Cookie 这类敏感信息脚本里用process.env或os.getenv读取别把密钥硬编码进脚本。变量支持按脚本分配避免一份配置到处抄。看日志。每次运行都留一份完整输出任务详情里看历史记录也支持实时查看日志支持关键字过滤长任务重点盯退出码和执行时长。收通知。任务失败或资源告警时通过通知脚本推送到钉钉、企业微信、Bark 等渠道配置示例见sample/notify.js配一次所有任务共用。 两个实战场景场景一竞品价格监控目标每天定时抓竞品页的价格和库存有变动就推送到手机。 脚本逻辑Python 脚本用 requests 拉页面解析价格字段与上一次记录比对后写入本地文件抓取部分包 try/except 失败重试 3 次。 调度配置0 9,15 * * *早午各一次错开整点任务里开启失败重试并挂上 notify 脚本。 异常处理接口超时直接抛错让任务失败由面板触发通知CommandTimeoutTime限制单次执行上限防止脚本卡死占着资源。场景二数据定时同步目标每 6 小时从业务接口拉一批数据去重后追加到数据文件。 脚本逻辑脚本记录上次拉取的水位线只取增量按主键去重后落盘再更新水位。 调度配置0 */6 * * *避开业务高峰。 异常处理网络请求脚本内自重试一次两次都失败再调 notify 报警面板侧开启任务失败自动执行通知。个人备份、邮件分类这类场景思路完全一样区别只在脚本语言和通知渠道。 踩坑与排障现象任务点了运行日志是空的。原因脚本不在面板识别的位置或后缀不对只认data/scripts/下的.js、.py、.ts、.sh等文件。 解法把脚本挪进该目录、确认后缀再在定时任务里重新绑定这个文件。现象页面打不开或登录后一直转圈。原因5700 端口没放行或反向代理下的部署路径没配。 解法compose 里用QlBaseUrl指定路径以斜杠开头结尾服务器安全组放行 5700代理指向容器内 5700。现象长任务跑一半被杀掉。原因执行时间超过默认超时或面板升级重启时进程被清理。 解法在data/config/config.sh里调大CommandTimeoutTime关键脚本自己加断点续跑升级安排在低峰期。进阶与生态想了解内部机制直接读 docs/PROJECT_ARCHITECTURE.md调度、worker、日志流的协作方式都写在里面。社区参与最实际的方式是在 issue 区反馈问题、提交自己沉淀的脚本后续方向集中在更多语言支持和更细的调度粒度上。现在就做一件事把第一个脚本传上去配上 cron 和通知先让它替你跑一周。【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考