cookiesnob/qinglong

青龙

青龙是一个支持TypeScript、JavaScript、Python3和Shell的定时任务管理面板。

!docker version !docker pulls !docker stars !docker image size

概述和主要用途

青龙是一款功能强大的定时任务管理工具，旨在提供便捷的脚本管理和定时执行能力。通过直观的Web界面，用户可以轻松管理各类脚本任务，支持多种编程语言，满足不同场景下的自动化需求。

核心功能和特性

• 多语言支持：兼容Python3、JavaScript、Shell、TypeScript脚本
• 在线管理：支持在线编辑脚本、配置环境变量及管理配置文件
• 日志查看：提供在线任务日志查看功能，方便调试和监控
• 精准定时：支持秒级任务设置，满足高精度定时需求
• 系统通知：支持系统级通知，及时反馈任务执行状态
• 界面优化：内置暗黑模式，适配不同使用环境
• 跨端支持：兼容手机端操作，实现随时随地管理任务

使用场景和适用范围

• 服务器定时任务管理
• 自动化脚本执行与监控
• 多语言脚本统一管理平台
• 个人或企业级自动化运维需求
• 需要精准定时执行的业务场景

部署方法

Docker部署

1. 安装Docker

bash
sudo curl -sSL get.docker.com | sh

2. 启动容器

bash
docker run -dit \
  -v $PWD/ql:/ql/data \
  -p 5700:5700 \
  --name qinglong \
  --hostname qinglong \
  --restart unless-stopped \
  whyour/qinglong:latest

Docker Compose部署

1. 安装Docker Compose

bash
sudo curl -L https://github.com/docker/compose/releases/download/1.16.1/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

2. 启动容器

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

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

使用方法

内置命令

bash
# 更新并重启青龙
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: 拉取仓库所需依赖文件（不受黑名单影响）
• branch: 拉取仓库的分支
• days: 需要保留的日志天数
• file_path: 任务执行的文件路径
• env_name: 并发或指定执行时的环境变量名称
• account_number: 指定执行的账号序号（可选）

相关链接

• nevinee
• https://github.com/alseambusher/crontab-ui
• Ant Design
• Ant Design Pro
• Umijs3.0
• https://github.com/darkreader/darkreader
• https://github.com/sunpu007/admin-server

开发指南

bash
$ git clone git@github.com:whyour/qinglong.git
$ cd qinglong
$ cp .env.example .env
$ yarn install
$ yarn start

打开浏览器访问 [***]

交流渠道

***频道

名称来源

青龙，又名苍龙，是中国传统文化中的四象之一、天之四灵之一。根据五行学说，它是代表东方的灵兽，为青色的龙，五行属木，代表春季，八卦主震。苍龙身具羽翼，《张果星宗》称“又有辅翼，方为真龙”。

《后汉书·律历志下》记载：日周于天，一寒一暑，四时备成，万物毕改，摄提迁次，青龙移辰，谓之岁。

在中国二十八宿中，青龙是东方七宿（角、亢、氐、房、心、尾、箕）的总称。早期星宿信仰中，它是最尊贵的天神；被道教吸纳入神系后称为“孟章”，与白虎监兵神君共同作为道教的护卫天神。