阿超 > qinglong

qinglong

2025-09-07

软件及插件

人生不是一场物质的盛宴，而是一次灵魂的修炼，使它在谢幕之时比开幕之初更为高尚。——稻盛和夫

https://github.com/whyour/qinglong

在自动化运维和脚本定时任务领域，青龙（whyour/qinglong）无疑是当前最受欢迎的开源任务管理平台之一。凭借对 Python3、JavaScript、Shell、Typescript 多种语言的全面支持，以及极致简洁的 Web 管理界面，青龙让“定时任务”从此变得高效、优雅又灵活。

项目定位

青龙致力于打造一个跨语言、易部署、易扩展的定时任务管理平台。无论是个人自动化、服务器运维、企业定时脚本调度，还是各种 Web 自动化场景，只需一个容器或 npm 包即可快速搭建属于自己的“定时任务中心”，让各类脚本按需运行、可视化管理。

功能特色

  • 多语言脚本支持：原生支持 Python3、JavaScript、Shell、Typescript 等主流脚本，满足各种自动化需求。
  • 在线管理：通过 Web 界面直接管理脚本、环境变量、配置文件，无需 SSH 或命令行操作。
  • 任务日志查看：所有任务运行日志可在线回溯、实时查看，方便排查和维护。
  • 秒级任务调度：支持高频任务（秒级），满足复杂场景的精细化调度。
  • 系统级通知：任务执行结果可推送通知，第一时间知晓脚本运行情况。
  • 暗黑模式和移动端适配：界面美观，支持暗黑模式、手机端操作，随时随地管理你的自动化任务。
  • 高扩展性：支持自定义脚本仓库、第三方插件接入、API调用等高级功能。
  • Docker/npm双生态：既可用 Docker 一键部署，也支持 npm 包安装，适配多种操作系统。

安装与部署

Docker快速部署：

1
2
docker pull whyour/qinglong:latest      # Alpine版本
docker pull whyour/qinglong:debian      # Debian版本，适合有特殊依赖需求

npm安装（适合 debian/ubuntu/alpine）：

1
npm i @whyour/qinglong

需自行安装 node/npm/python3/pip3/pnpm

本地开发体验：

1
2
3
4
5
6
git clone https://github.com/whyour/qinglong.git
cd qinglong
cp .env.example .env
npm install -g pnpm@8.3.1
pnpm install
pnpm start

浏览器访问 http://127.0.0.1:5700 即可进入管理后台。

更多详细文档：安装指南

技术亮点

  • 前后端分离架构，底层基于 TypeScript/Node.js，界面采用 Ant Design Pro 和 Umijs，性能与体验兼顾。
  • 极简API体系，内置丰富接口，方便二次开发和与其它系统集成。
  • 任务调度引擎，支持多种任务触发方式（定时、手动、API），灵活应对各种自动化场景。
  • 多平台兼容，Docker/NPM可选部署，支持主流 Linux/Windows/Mac 环境。
  • **暗黑模式集成 darkreader，移动端适配优雅，随时随地管控你的自动化世界。

典型应用场景

  • 服务器自动化运维：定时备份、健康检查、自动重启、日志清理等。
  • 个人自动化脚本管理：定时签到、数据采集、信息推送、任务提醒等。
  • 企业级批处理/数据同步：定时爬虫、API调用、数据清洗等。
  • Web自动化/通知推送：结合API实现自动化告警、状态监控、消息推送。
  • 多脚本语言混合任务：同一平台统一管理 Python/Shell/JS/TS 脚本，降低运维复杂度。

代码片段示例

调度一个 Python 脚本：

1
2
# sample.py
print("Hello, Qinglong!")

在青龙平台上传并设置定时，每天凌晨执行，日志自动保存。

通过 API 调用任务：

1
curl -X POST http://127.0.0.1:5700/api/runTask -d '{"task":"sample.py"}'

社区与生态

青龙拥有超1.8万Star的开源社区，支持 Docker Hub 镜像、npm 包分发，文档完善。Telegram 频道、在线演示站点、GitHub Issues 反馈渠道活跃，开发者可随时交流和贡献。

名称典故

“青龙”，源自中国古代星宿与五行文化，寓意为自动化世界中的“守护者”，时刻运转、赋能万物。

总结

青龙平台用极简设计和强大功能重新定义了定时任务管理的体验。无论你是个人开发者、服务器运维工程师，还是企业自动化团队，都能在青龙找到高效、易用、可扩展的自动化管理方案。强烈推荐体验和Star，让你的自动化脚本管理真正“省心又省力”！