源码系统概览
文章正文
青龙（qinglong）是一个支持 Python3、JavaScript、Shell、TypeScript 的可视化定时任务管理平台。通过 Web 界面集中管理多语言脚本任务，支持秒级调度、环境变量在线编辑、任务日志查看及系统通知。项目含 250 个文件，GitHub 已获 19804 星，提供 Docker 与 npm 两种安装方式，是运维自动化场景中广受欢迎的开源方案。
源码简介
青龙定位为运维与自动化场景的定时任务控制台。
源码仓库目录结构包含 back（后端服务）、src（前端界面）、shell（Shell 脚本）、sample（示例配置）、docker（容器化部署）以及 deploy（部署脚本）。
系统核心能力涵盖多语言脚本任务管理、Cron 表达式秒级调度、环境变量与配置文件 Web 在线编辑、任务执行日志实时查看、系统级通知推送，以及暗黑模式与移动端响应式操作界面。
支持 Docker（Alpine 与 Debian）容器化部署，默认端口 5700，数据卷持久化路径为 /ql/data。
许可证 Apache-2.0。
适用场景
分散定时脚本的集中托管与统一运维、自动化签到与数据采集任务调度、CI 与 CD 流水线辅助脚本管理、多语言（Python/Node/Shell）混合任务编排、团队协作场景下的任务分配与日志审计、服务器运维中的定时备份与监控脚本调度、物联网设备的数据采集与定时上报任务管理。
技术栈与运行环境
后端 Node.js 与 TypeScript，前端 React，数据库 SQLite 或 PostgreSQL。
版本号 v2.19.0，许可证 Apache-2.0，GitHub 星标 19804。
对比传统 Crontab 方式，青龙提供可视化界面与多语言支持，管理效率更高。
推荐 Docker 部署，默认端口 5700，数据卷 /ql/data。
支持 Alpine 与 Debian 两种基础镜像，适配不同运维环境需求。
功能亮点
- 支持 Python3、JavaScript、Shell、TypeScript 四种脚本语言
- 可视化 Web 界面，秒级 Cron 调度
- 环境变量与配置文件在线编辑
- 任务日志实时查看与历史回溯
- 系统级通知推送，支持多种渠道
- 暗黑模式与移动端响应式适配
- Docker 一键部署，Alpine 与 Debian 双镜像
技术架构与部署指南
安装与部署提示
最后更新 2026 年 8 月。
更新日志显示 v2.19.0 优化了任务调度稳定性与移动端体验。
推荐使用 Docker Compose 部署：拉取官方镜像，映射端口 5700，挂载数据卷 /ql/data 持久化配置与日志。
首次访问需在 Web 界面完成初始化设置，包括管理员账号创建与通知渠道配置。
截图与演示说明
封面图展示了青龙的管理界面，可见任务列表、Cron 表达式配置、运行状态与日志面板。
界面采用响应式设计，支持暗黑模式，移动端操作流畅。
图中直观呈现了多语言脚本统一管理的控制台布局，各功能模块分区清晰。
同类工具对比
以下是Qinglong与其他定时任务工具的主要区别和对比：
| 项目 | 类型 | 许可证 | 主要特点 |
|---|---|---|---|
| Qinglong | 开源 | Apache-2.0 | 定时任务，社区活跃 |
| Cronus | 同类 | 各异 | 功能相似 |
| Airflow | 同类 | 各异 | 侧重不同 |
| Jenkins | 同类 | 各异 | 各有优势 |
Qinglong和Cronus的区别在于部署方式不同，Qinglong和Airflow对比各有侧重，Qinglong可作为Jenkins的替代方案。
常见问题
问：青龙支持哪些脚本语言？
支持 Python3、JavaScript、Shell、TypeScript 四种语言，可在同一平台混合管理不同语言的定时任务。
问：如何通过 Docker 部署？
使用官方 Docker 镜像，映射端口 5700 并挂载 /ql/data 数据卷即可。
推荐使用 Docker Compose 进行编排管理，部署后首次访问完成初始化。
问：任务调度精度如何？
青龙支持秒级 Cron 表达式调度，可满足高精度定时需求，同时提供任务依赖与重试机制。
问：是否支持通知推送？
支持多种通知渠道，包括 Telegram、Bark、Webhook 等，可在系统设置中按需配置通知规则。
问：数据持久化如何保证？
通过挂载 /ql/data 数据卷实现配置、任务脚本与日志的持久化，Docker 容器重建后数据不丢失。
安全风险提示
青龙管理界面默认无认证限制，部署到公网时务必启用访问控制或置于反向代理之后。
脚本中可能包含敏感凭证，建议通过环境变量管理而非硬编码到脚本文件中。
容器内文件权限应遵循最小权限原则，避免以 root 用户运行任务脚本。
下载说明
本源码已打包整理，可通过下方链接获取完整项目文件。
下载后建议优先参考 docker 目录中的 Compose 配置进行容器化部署。
GitHub项目开源地址：https://github.com/whyour/qinglong。