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

◆ 简介

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                                              
# 添加单个仓库的指定脚本
ql repo        
# 删除旧日志
ql rmlog                                               
# 启动tg-bot
ql bot                                                       
# 检测青龙环境并修复
ql check                                                     
# 重置登录错误次数
ql resetlet                                                  
# 禁用两步登录
ql resettfa                                                  

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

命令的参数包括：

• file_url: 脚本地址

• repo_url: 仓库地址

• whitelist: 拉取仓库时的白名单，即就是需要拉取的脚本的路径包含的字符串

• blacklist: 拉取仓库时的黑名单，即就是需要拉取的脚本的路径不包含的字符串

• dependence: 拉取仓库需要的依赖文件，会直接从仓库拷贝到scripts下的仓库目录，不受黑名单影响

• branch: 拉取仓库的分支

• days: 需要保留的日志的天数

• file_path: 任务执行时的文件路径

• env_name: 任务执行时需要并发或者指定时的环境变量名称

• account_number: 任务执行时指定某个环境变量需要执行的账号序号

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

◆ 总结

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