定时任务，是在日常开发需求中总会遇到的，我们往往会有一些简单的脚本工作，希望能够每小时或每天执行一次。当这类需求变得多起来后，这些零散的任务脚本就会变得难以管理，尤其是它们可能由不同的脚本语言编写而成。这时，我们就需要一个集中化的定时任务管理平台，来进行统一管理。

简介

QingLong（青龙），是 whyour 在 Github 上开源的定时任务管理面板，仓库位于
https://github.com/whyour/qinglong，目前版本为 v2.11.2。

QingLong提供了强大的定时任务管理功能，支持 Python3，JAVAScript，Shell，TypeScript 等多语言。QingLong的功能包括：

• 支持多种脚本语言（Python3，JavaScript，Shell，TypeScript）
• 支持在线管理脚本、环境变量、配置文件
• 支持在线查看任务日志
• 支持秒级任务设置
• 支持系统级通知
• 支持暗黑模式
• 支持手机端操作

使用

QingLong 推荐使用 Docker 或 Docker-Compose 部署。使用Docker部署：

docker run -dit 
  -v $PWD/ql/config:/ql/config 
  -v $PWD/ql/log:/ql/log 
  -v $PWD/ql/db:/ql/db 
  -v $PWD/ql/repo:/ql/repo 
  -v $PWD/ql/raw:/ql/raw 
  -v $PWD/ql/scripts:/ql/scripts 
  -p 5700:5700 
  --name qinglong 
  --hostname qinglong 
  --restart unless-stopped 
  whyour/qinglong:latest

使用Docker-Compose部署：

mkdir qinglong
wget https://raw.githubusercontent.com/whyour/qinglong/master/docker-compose.yml

# 启动
docker-compose up -d
# 停止
docker-compose down

QingLong提供了丰富的命令进行控制，包括：

# 更新并重启青龙
ql update                                                    
# 运行自定义脚本extra.sh
ql extra                                                     
# 添加单个脚本文件
ql raw <file_url>                                             
# 添加单个仓库的指定脚本
ql repo <repo_url> <whitelist> <blacklist> <dependence> <branch>   
# 删除旧日志
ql rmlog <days>                                              
# 启动tg-bot
ql bot                                                       
# 检测青龙环境并修复
ql check                                                     
# 重置登录错误次数
ql resetlet                                                  
# 禁用两步登录
ql resettfa                                                  

# 依次执行，如果设置了随机延迟，将随机延迟一定秒数
task <file_path>                                             
# 依次执行，无论是否设置了随机延迟，均立即运行，前台会输出日，同时记录在日志文件中
task <file_path> now                                         
# 并发执行，无论是否设置了随机延迟，均立即运行，前台不产生日，直接记录在日志文件中，且可指定账号执行
task <file_path> conc <env_name> <account_number>(可选的) 
# 指定账号执行，无论是否设置了随机延迟，均立即运行 
task <file_path> desi <env_name> <account_number>         

命令的参数包括：

• file_url: 脚本地址
• repo_url: 仓库地址
• whitelist: 拉取仓库时的白名单，即就是需要拉取的脚本的路径包含的字符串
• blacklist: 拉取仓库时的黑名单，即就是需要拉取的脚本的路径不包含的字符串
• dependence: 拉取仓库需要的依赖文件，会直接从仓库拷贝到scripts下的仓库目录，不受黑名单影响
• branch: 拉取仓库的分支
• days: 需要保留的日志的天数
• file_path: 任务执行时的文件路径
• env_name: 任务执行时需要并发或者指定时的环境变量名称
• account_number: 任务执行时指定某个环境变量需要执行的账号序号

QingLong提供了GUI后台界面，能够十分方便可视化地管理任务的执行。

总结

QingLong提供了强大的定时任务管理功能，支持 Python3，JavaScript，Shell，TypeScript 等多语言，支持在线管理脚本和日志等。其功能丰富，能够满足大部分需求场景，值得一试。