什么是 QingLong?
QingLong(青龙)是一个支持 Python3、JavaScript、Shell、TypeScript 的定时任务管理平台。简单说,就是把各种脚本和环境变量、日志、配置文件一股脑儿揽过来,在线编辑、在线执行、秒级调度、手机端也能管,简直万能。
能帮你做什么?
- • 一站式脚本管理:Python/JS/Shell/TS 脚本全都纳入麾下
- • 环境变量可视化:再也不用折腾
.env 一行行敲了 - • 秒级定时:支持 cron 表达式,更支持秒级执行
- • 日志在线查看:任务一跑完,直接在 Web 界面翻日志,不用 ssh
- • 系统级通知:跑完脚本,还能钉钉/邮件/Telegram 通知你
- • 深色模式 & 手机端:深夜调试不刺眼,手机上随手一滑就能改配置
核心功能大盘点
| |
| Python3、JavaScript、Shell、TypeScript |
| 脚本、环境变量、配置文件,一切都在 Web 界面搞定 |
| |
| |
| |
| |
安装部署超简单
- 1. Docker 一键启动(推荐)
# 如果没装 Docker,可以先:curl -sSL get.docker.com | sh# 拉取镜像docker pull whyour/qinglong:latest# 或者基于 Debian 的镜像(用到不兼容 Alpine 的依赖时):docker pull whyour/qinglong:debian# 启动容器(端口 5700 可按需修改)docker run -dit \-v $PWD/ql/data:/ql/data \-p 5700:5700 \-e QlBaseUrl="/" \-e QlPort="5700" \--name qinglong \--hostname qinglong \--restart unless-stopped \ whyour/qinglong:latest
- 2. NPM 安装(需要预装 Node.js、npm、Python3、pip3)
npm i @whyour/qinglong -g# 然后在项目目录:git clone https://github.com/whyour/qinglong.gitcd qinglongcp.env.example .env# 推荐使用 pnpm 提速:npm install -g pnpm@8.3.1pnpm installpnpm start# 打开浏览器,访问 http://127.0.0.1:5700
怎么玩?日常使用指南
- • 整个仓库:
ql repo <仓库URL><白名单><黑名单><依赖文件><分支><后缀过滤>
- • 查看/删除日志
# 删除超过 7 天的旧日志ql rmlog 7
- • 更新 & 维护
ql update # 更新核心并重启ql check # 环境健康检查并修复ql resetlet # 重置登录错误次数ql resettfa # 关闭两步登录
- • 手动运行任务
task <脚本路径># 正常执行task <脚本路径> now # 立即跑(无延迟)task <脚本路径> conc # 并发执行task -m 300<脚本路径># 超时 300 秒后自动停止task <脚本路径>---u foo # 脚本接收参数
优缺点随手一说
小结总的来说,QingLong 就像一个「定时任务大管家」,让你摆脱各种碎片化脚本、crontab 配置、日志追踪的痛苦,省时省力又省心。无论你是刷项目、自动打卡、批量任务调度,还是科研数据采集、运维巡检,它都能帮你 hold 住。
赶紧动手部署一个,到手机、到公司服务器,随心所欲管理你的脚本世界吧!
项目地址:https://github.com/whyour/qinglong