青龙面板定时任务管理平台快速上手完整指南【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong凌晨两点服务器上的脚本挂了你是第二天上班翻 /var/log 才知道的。更常见的是定时任务散在三台机器的 crontab 里脚本丢在网盘环境变量写在代码里——想查一次谁在跑什么得逐台登录敲 crontab -l。青龙面板qinglong做的事情就是把这种局面收拢到一个网页里写脚本、配定时、管变量、看日志、发通知全在一个面板上完成支持 Python3、JavaScript、Shell、TypeScript 四种脚本语言。它适合谁一句话青龙面板是一个跑在 Linux 上的定时任务管理平台用来替代crontab 手动维护脚本的工作方式。适合两类人一是脚本攒到十几个、开始管不过来的个人用户二是需要把脚本、配置、日志集中交付给同事看的小团队。它不是集群调度系统定位是单机管理面板这点先说清楚免得有落差。部署Docker 一条命令或者源码安装环境要求压缩成一条准备一台 Linux 机器能访问端口 5700磁盘留够脚本和日志的空间数据都存在 data 目录里后面要备份。方式 ADocker 部署推荐git clone https://gitcode.com/GitHub_Trending/qi/qinglong cd qinglong/docker docker-compose up -d第二条命令启动容器仓库自带的 docker/docker-compose.yml 已经把端口映射和 ./data:/ql/data 数据卷都配好了你不用改。方式 B源码/全局安装npm i whyour/qinglong这条命令装好面板本体。npm 方式需要你手动设置两个环境变量再启动QL_DIR面板安装目录和QL_DATA_DIR数据目录必须以/data结尾例如/ql/data然后执行qinglong命令。面板启动后会自动装好运行任务所需的 git、curl、jq 等基础依赖不用你逐个装。两种方式都完成后浏览器访问http://服务器IP:5700首次进入按提示设置登录账号即可。功能走查按你要做的事讲 让脚本按点跑起来场景你有一批脚本希望每天固定时间执行。在面板里新建定时任务指向data/scripts目录下的脚本文件填 cron 表达式比如0 9 * * *就是每天 9 点。表达式写错了不用去翻手册——面板自带校验写错会在界面上直接提示。任务怎么执行看脚本后缀这一点写得很直白逻辑在 shell/task.sh脚本后缀用什么跑.js / .mjsnode.pypython3.shshell.tsts-node两个实用配置任务支持秒级精度的 cron比系统 crontab 粒度更细如果多个任务同一时间触发导致限流可以配随机延迟RandomDelay在data/config/config.sh里设例如RandomDelay300表示 1~300 秒内随机推迟。2.21 版还新增了指定任务work_dir的能力脚本在哪个目录下执行可以单独控制。 不改命令行就能调试场景改了脚本想验证以前是 ssh 上去手动跑一遍。面板里任务列表每行都有运行按钮点完不用等下次定时——日志页直接流式显示这次输出的每一行等于是把 tail -f 搬进了网页。历史日志也都在按文件、按日期检索。排查昨天那次到底输出了什么不用再登服务器。 敏感配置别硬编码场景脚本里要填 API key、Cookie。别写进代码——用面板的环境变量页集中管理每个任务单独勾选要用哪些变量运行时自动注入仓库里拉下来的脚本不会带出你的密钥。2.21 版还加了变量标签tag给几十个变量分组找起来不费劲。配套的订阅功能填一个脚本仓库地址面板会把仓库 clone 到data/repo按配置自动同步其中的脚本和定时规则。新脚本从团队共享仓库来而不是每个人复制一份。 任务挂了要有人知道场景半夜任务失败第二天才发现。配一次通知渠道之后任务异常、面板宕机CPU/内存/磁盘超过阈值都会主动推给你。渠道在 sample/config.sample.sh 里列得很全Server酱、Bark、Telegram、钉钉、企业微信、PushPlus、SMTP 邮件、Ntfy、飞书、自定义 Webhook 等二十几种挑一个填 token 就行。资源告警阈值默认 CPU 80%、内存 80%、磁盘 90%在config.sh的CpuWarn/MemoryWarn/DiskWarn里改。 进阶技巧清单备份只认一个目录脚本、环境变量、日志、SQLite 数据库全在data/Docker 里就是挂载出来的./data。定期把这个目录拷走恢复时原样放回来即可。用依赖管理页装 npm/pip 包任务里require不到的库别手动进容器装——面板的依赖管理页装到data/dep_cache重启容器后依然在。日志膨胀要有对策data/log会一直长面板的日志页支持手动删除历史配合系统自带的日志清理任务shell/rmlog.sh别让日志把磁盘撑满。升级前看一眼版本号version.yaml里记录了当前版本和 changelog当前为 2.21.0含任务统计、运行实例、环境变量标签等新增项升级后用设置页的系统检查跑一遍 shell/check.sh确认运行环境完整。问题排解现象容器起来了5700 打不开面板。原因多半是端口被占或数据卷权限不对Docker 的 entrypoint 会检查/ql和/ql/data是否可写非 root 运行时 alpine 镜像要求更高。做法docker logs看启动输出确认端口冲突就换映射端口换用whyour/qinglong:debian镜像可以规避 alpine 的 crond 权限限制。现象任务设置了时间但到点不执行。原因cron 表达式不合法但没被拦住或任务被手动暂停了。做法在任务编辑弹窗里先校验表达式再回列表确认状态是启动而不是暂停。现象脚本里引用了环境变量运行却是空的。原因变量建了但这个任务没勾选该变量。做法环境变量列表里给变量打勾对应到具体任务再手动运行一次验证注入是否生效。现象通知配置好了失败时没收到推送。原因token 填错、渠道服务限流或config.sh里的变量没保存。做法面板通知设置页有发送测试先测通再等真实告警测试不通过就核对data/config/config.sh里对应渠道的 token。写在最后青龙面板解决的是一个很具体的问题让分散的定时脚本有统一入口、统一日志、统一告警且全部操作不离开浏览器。如果你现在就有一台闲置 Linux 机器最直接的下一步就是按上面的 Docker 方式跑起来先搬一个现有 crontab 任务进去——跑通一次你就知道该不该全量迁移了。更多架构细节可以读仓库内文档docs/PROJECT_ARCHITECTURE.md完整源码见仓库 https://gitcode.com/GitHub_Trending/qi/qinglong 。【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 青龙面板定时任务管理平台快速上手完整指南
青龙面板定时任务管理平台快速上手完整指南【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong凌晨两点服务器上的脚本挂了你是第二天上班翻 /var/log 才知道的。更常见的是定时任务散在三台机器的 crontab 里脚本丢在网盘环境变量写在代码里——想查一次谁在跑什么得逐台登录敲 crontab -l。青龙面板qinglong做的事情就是把这种局面收拢到一个网页里写脚本、配定时、管变量、看日志、发通知全在一个面板上完成支持 Python3、JavaScript、Shell、TypeScript 四种脚本语言。它适合谁一句话青龙面板是一个跑在 Linux 上的定时任务管理平台用来替代crontab 手动维护脚本的工作方式。适合两类人一是脚本攒到十几个、开始管不过来的个人用户二是需要把脚本、配置、日志集中交付给同事看的小团队。它不是集群调度系统定位是单机管理面板这点先说清楚免得有落差。部署Docker 一条命令或者源码安装环境要求压缩成一条准备一台 Linux 机器能访问端口 5700磁盘留够脚本和日志的空间数据都存在 data 目录里后面要备份。方式 ADocker 部署推荐git clone https://gitcode.com/GitHub_Trending/qi/qinglong cd qinglong/docker docker-compose up -d第二条命令启动容器仓库自带的 docker/docker-compose.yml 已经把端口映射和 ./data:/ql/data 数据卷都配好了你不用改。方式 B源码/全局安装npm i whyour/qinglong这条命令装好面板本体。npm 方式需要你手动设置两个环境变量再启动QL_DIR面板安装目录和QL_DATA_DIR数据目录必须以/data结尾例如/ql/data然后执行qinglong命令。面板启动后会自动装好运行任务所需的 git、curl、jq 等基础依赖不用你逐个装。两种方式都完成后浏览器访问http://服务器IP:5700首次进入按提示设置登录账号即可。功能走查按你要做的事讲 让脚本按点跑起来场景你有一批脚本希望每天固定时间执行。在面板里新建定时任务指向data/scripts目录下的脚本文件填 cron 表达式比如0 9 * * *就是每天 9 点。表达式写错了不用去翻手册——面板自带校验写错会在界面上直接提示。任务怎么执行看脚本后缀这一点写得很直白逻辑在 shell/task.sh脚本后缀用什么跑.js / .mjsnode.pypython3.shshell.tsts-node两个实用配置任务支持秒级精度的 cron比系统 crontab 粒度更细如果多个任务同一时间触发导致限流可以配随机延迟RandomDelay在data/config/config.sh里设例如RandomDelay300表示 1~300 秒内随机推迟。2.21 版还新增了指定任务work_dir的能力脚本在哪个目录下执行可以单独控制。 不改命令行就能调试场景改了脚本想验证以前是 ssh 上去手动跑一遍。面板里任务列表每行都有运行按钮点完不用等下次定时——日志页直接流式显示这次输出的每一行等于是把 tail -f 搬进了网页。历史日志也都在按文件、按日期检索。排查昨天那次到底输出了什么不用再登服务器。 敏感配置别硬编码场景脚本里要填 API key、Cookie。别写进代码——用面板的环境变量页集中管理每个任务单独勾选要用哪些变量运行时自动注入仓库里拉下来的脚本不会带出你的密钥。2.21 版还加了变量标签tag给几十个变量分组找起来不费劲。配套的订阅功能填一个脚本仓库地址面板会把仓库 clone 到data/repo按配置自动同步其中的脚本和定时规则。新脚本从团队共享仓库来而不是每个人复制一份。 任务挂了要有人知道场景半夜任务失败第二天才发现。配一次通知渠道之后任务异常、面板宕机CPU/内存/磁盘超过阈值都会主动推给你。渠道在 sample/config.sample.sh 里列得很全Server酱、Bark、Telegram、钉钉、企业微信、PushPlus、SMTP 邮件、Ntfy、飞书、自定义 Webhook 等二十几种挑一个填 token 就行。资源告警阈值默认 CPU 80%、内存 80%、磁盘 90%在config.sh的CpuWarn/MemoryWarn/DiskWarn里改。 进阶技巧清单备份只认一个目录脚本、环境变量、日志、SQLite 数据库全在data/Docker 里就是挂载出来的./data。定期把这个目录拷走恢复时原样放回来即可。用依赖管理页装 npm/pip 包任务里require不到的库别手动进容器装——面板的依赖管理页装到data/dep_cache重启容器后依然在。日志膨胀要有对策data/log会一直长面板的日志页支持手动删除历史配合系统自带的日志清理任务shell/rmlog.sh别让日志把磁盘撑满。升级前看一眼版本号version.yaml里记录了当前版本和 changelog当前为 2.21.0含任务统计、运行实例、环境变量标签等新增项升级后用设置页的系统检查跑一遍 shell/check.sh确认运行环境完整。问题排解现象容器起来了5700 打不开面板。原因多半是端口被占或数据卷权限不对Docker 的 entrypoint 会检查/ql和/ql/data是否可写非 root 运行时 alpine 镜像要求更高。做法docker logs看启动输出确认端口冲突就换映射端口换用whyour/qinglong:debian镜像可以规避 alpine 的 crond 权限限制。现象任务设置了时间但到点不执行。原因cron 表达式不合法但没被拦住或任务被手动暂停了。做法在任务编辑弹窗里先校验表达式再回列表确认状态是启动而不是暂停。现象脚本里引用了环境变量运行却是空的。原因变量建了但这个任务没勾选该变量。做法环境变量列表里给变量打勾对应到具体任务再手动运行一次验证注入是否生效。现象通知配置好了失败时没收到推送。原因token 填错、渠道服务限流或config.sh里的变量没保存。做法面板通知设置页有发送测试先测通再等真实告警测试不通过就核对data/config/config.sh里对应渠道的 token。写在最后青龙面板解决的是一个很具体的问题让分散的定时脚本有统一入口、统一日志、统一告警且全部操作不离开浏览器。如果你现在就有一台闲置 Linux 机器最直接的下一步就是按上面的 Docker 方式跑起来先搬一个现有 crontab 任务进去——跑通一次你就知道该不该全量迁移了。更多架构细节可以读仓库内文档docs/PROJECT_ARCHITECTURE.md完整源码见仓库 https://gitcode.com/GitHub_Trending/qi/qinglong 。【免费下载链接】qinglong支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台Timed task management platform supporting Python3, JavaScript, Shell, Typescript项目地址: https://gitcode.com/GitHub_Trending/qi/qinglong创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考