ghcr.io/whyour/qinglong:2.22.0-debian

青龙

简体中文 | English

支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台

---

功能

• 支持多种脚本语言（python3、javaScript、shell、typescript）
• 支持在线管理脚本、环境变量、配置文件
• 支持在线查看任务日志
• 支持秒级任务设置
• 支持系统级通知
• 支持暗黑模式
• 支持手机端操作
• 支持通过 远程 CLI 与 Agent Skill 管理面板

版本

Docker

latest 镜像是基于 alpine 构建，debian 镜像是基于 debian-slim 构建。如果需要使用 alpine 不支持的依赖，建议使用 debian 镜像。

[!IMPORTANT] 如果您需要以非 root 用户运行 Docker，请使用 debian 镜像。Alpine 的 crond 需要 root 权限。

拉取镜像命令：

docker pull whyour/qinglong:latest
docker pull whyour/qinglong:debian

使用 debian 镜像以非 root 用户运行时，需指定 --user qinglong 参数：

docker run -d \
-v /path/to/ql/data:/ql/data \
-p 5700:5700 \
--user qinglong \
--name qinglong \
whyour/qinglong:debian

npm

npm 版本支持 debian/ubuntu/alpine 系统，需要自行安装 node/npm/python3/pip3/pnpm：

npm i @whyour/qinglong

部署

查看文档

内置 API

查看文档

内置命令

查看文档

远程 CLI 与 Agent Skill

使用独立 npm 包 https://www.npmjs.com/package/@whyour/qinglong-cli，可以从本机终端或自动化流程管理远程青龙面板。支持任务与订阅的创建、修改、运行和日志查看，以及应用、环境变量、脚本、配置、依赖等 OpenAPI 资源；输出内容为 JSON 格式，便于脚本和 AI Agent 调用。

运行要求 Node.js >=22.12，推荐使用 Node.js 24。安装后可使用 ql 命令：

npm install -g @whyour/qinglong-cli
ql login --url https://ql.example.com
ql auth status --json
ql task list --json
ql subscription list --json
ql --help

请在面板「系统设置 → 应用设置」页面创建应用并授予所需权限，登录时按提示输入 Client ID/Secret；也支持通过 QL_URL 和 QL_ACCESS_TOKEN 环境变量使用已有令牌。各命令均支持 --help 参数查询说明，设置环境变量 QL_LANG=en 可切换为英文帮助内容。

[!NOTE] 该 npm CLI 用于远程管理。青龙面板内置的工具同样使用 ql 作为命令名，已部署青龙面板的机器请使用独立目录安装该 CLI，避免覆盖面板内置命令。关于本机脚本执行和运维相关内容请参考 面板内部工具。

相关文档链接：

• CLI 中文说明
• English guide
• 完整命令参考

该 npm 包内附带 远程管理 Skill，涵盖认证、命令选择和操作结果检查全流程，可供 AI Agent 直接调用。本机执行与运维相关的能力请参考 内部 Skill。

开发

git clone https://github.com/whyour/qinglong.git
cd qinglong
cp .env.example .env
# 推荐使用 pnpm https://pnpm.io/zh/installation
npm install -g pnpm@8.3.1
pnpm install
pnpm start

执行完成后打开浏览器访问对应地址即可进入界面。

相关链接

• https://gitee.com/evine
• https://github.com/alseambusher/crontab-ui
• Ant Design
• Ant Design Pro
• Umijs
• https://github.com/darkreader/darkreader
• https://github.com/sunpu007/admin-server

名称来源

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

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

在中国二十八宿信仰体系中，青龙是东方七宿（角、亢、氐、房、心、尾、箕）的总称。在早期星宿信仰中，祂是地位最尊贵的天神。后被道教信仰吸纳入其神系后，神格有所调整，道教将其尊称为“孟章”，在不同的道经中有“帝君”、“圣将”、“神将”和“捕鬼将”等称呼，与白虎监兵神君一同作为道教的护卫天神。