青龙 v2.18.3

更新说明:

1. 脚本管理和日志管理支持下载脚本和日志
2. 修复 gRPC client 连接超时
3. 脚本管理增加强制打开文件

更新方法:

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像:

正式版: whyour/qinglong:latest
Python3.10 正式版: whyour/qinglong:python3.10
debian 版: whyour/qinglong:debian
Python3.10 debian 版: whyour/qinglong:debian-python3.10
npm 版本: npm i -g @whyour/qinglong

十年旧梦无寻处，几度新春不在家。

机场推荐(已稳定使用一年+，支持IPV6/GPT):
虎云 去注册
熊云 去注册

使用指南|OpenApi|京东线报|美团|9块9包邮
喝杯咖啡|支付宝红包|优惠商城|饿了么

青龙 v2.19.0

更新说明:

1. 缓存 node 和 python 依赖
2. 减少启动服务数，节约启动内存约 50%
3. 邮箱通知支持多个收件人
4. boot 任务改为在依赖安装完成后执行
5. 修复脚本管理查询子目录逻辑
6. 修复脚本管理增加文件夹
7. 修复 QLAPI 修复环境变量 remarks
8. 修复 mjs 依赖查不到
9. 修复无法删除日志文件

其他说明:

1. [非必须] 缓存 linux 依赖需要手动增加映射目录，debian 镜像映射目录 ./data/dep_cache/apt/archives:/var/cache/apt/archives， latest 镜像映射目录 ./data/dep_cache/apk/cache:/var/cache/apk
2. 此版本启动逻辑改动较大，需要删除容器，用最新镜像启动新容器，或者使用更新方法中 宿主机更新 方式更新

更新方法:

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像:

正式版: whyour/qinglong:latest
Python3.10 正式版: whyour/qinglong:python3.10
debian 版: whyour/qinglong:debian
Python3.10 debian 版: whyour/qinglong:debian-python3.10
npm 版本: npm i -g @whyour/qinglong

江涵秋影雁初飞，与客携壶上翠微。

机场推荐(已稳定使用一年+，支持IPV6/GPT):
虎云 去注册
熊云 去注册

使用指南|OpenApi|京东线报|美团|9块9包邮
喝杯咖啡|支付宝红包|优惠商城|饿了么

青龙 v2.19.1

更新说明:

1. 修复依赖是否安装检查逻辑
2. 修复文件下载 path 参数
3. 修复 python 查询逻辑
4. 修复任务视图状态筛选
5. 修复创建脚本可能失败
6. 修复重置用户名失败
7. 修复无法识别 python 依赖安装的命令
8. 其他缺陷修复

更新方法:

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像:

正式版: whyour/qinglong:latest
Python3.10 正式版: whyour/qinglong:python3.10
debian 版: whyour/qinglong:debian
Python3.10 debian 版: whyour/qinglong:debian-python3.10
npm 版本: npm i -g @whyour/qinglong

庭轩寂寞近清明，残花中酒，又是去年病。

机场推荐(已稳定使用一年+，支持IPV6/GPT):
虎云 去注册
熊云 去注册

使用指南|OpenApi|京东线报|美团|9块9包邮
喝杯咖啡|支付宝红包|优惠商城|饿了么

青龙 v2.19.2

更新说明:

1. 备份数据支持选择模块，支持清除依赖缓存
2. QLAPI 和 openapi 的 systemNotify 支持自定义通知类型和参数。 查看
3. ntfy 增加可选的认证与用户动作，感谢 https://github.com/liheji
4. 修复取消安装依赖
5. 修复环境变量过大解析报错
6. 修改服务启动方式

更新方法:

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像:

正式版: whyour/qinglong:latest
Python3.10 正式版: whyour/qinglong:python3.10
debian 版: whyour/qinglong:debian
Python3.10 debian 版: whyour/qinglong:debian-python3.10
npm 版本: npm i -g @whyour/qinglong

单于北望拂云堆，杀马登坛祭几回。

机场推荐(已稳定使用一年+，支持IPV6/GPT):
虎云 去注册
熊云 去注册

使用指南|OpenApi|京东线报|美团|9块9包邮
喝杯咖啡|支付宝红包|优惠商城|饿了么

青龙 v2.20.0

更新说明:

1. 定时任务（cron / task）相关的大量修复 & 增强
• 修复 cron 解析错误（修复 parse cron / 升级 cron-parser）
• 修复集群模式下定时任务可能不执行（race condition）
• 定时任务支持订阅筛选
• 定时任务支持排序调整
• 定时任务支持自定义日志文件或无日志
• 修复任务实例默认值
• 任务支持单实例 / 多实例模式
• 修复 task 命令软链可能失败问题

2. 日志系统相关的大更新
• 修复日志目录逻辑
• 修复 pm2 日志目录
• 优化日志写入（stream pooling）

3. 环境变量（env）系统的改进与修复
• 修复环境变量复制到剪贴板时可能失败
• 添加环境变量“置顶”功能
• 修复 QlPort 与 QlGrpcPort 环境变量在 host network 模式下被忽略
• 增加全局 SSH 私钥配置

4. Docker / 非 root 用户 / Alpine 兼容性增强
• 新增非 root Docker 用户支持，自动初始化命令
• 修复 Alpine 容器 DNS 解析失败（设置 ndots:0）
• 修复 PM2 在 ARM 路由器（Node.js 不兼容）上的启动失败
• 移除 nginx（可能是考虑更轻量的镜像运行）

5. API 安全与校验增强
• Dependencies GET endpoint 增加校验
• Script API routes 增加输入校验
• 修复 JWT 认证问题
• Feishu 机器人通知增加签名校验
• QLAPI 增加 cron task 管理功能
• 修复 URIError（错误 cookie 导致白屏）

6. 系统设置
• 新增多终端/多平台的并发登录会话支持

更新方法:

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像:

正式版: whyour/qinglong:latest
Python3.10 正式版: whyour/qinglong:python3.10
debian 版: whyour/qinglong:debian
Python3.10 debian 版: whyour/qinglong:debian-python3.10
npm 版本: npm i -g @whyour/qinglong

重重蕊叶相怜，似青帔艳妆神仙侣。

机场推荐(已稳定使用一年+，支持IPV6/GPT):
虎云 去注册
熊云 去注册

使用指南|OpenApi|京东线报|美团|9块9包邮
喝杯咖啡|支付宝红包|优惠商城|饿了么

青龙 v2.20.1

更新说明:

1. 修复获取依赖管理列表
2. notify.js 修复 TG_PROXY_AUTH 参数拼接
3. QLAPI.notify larkSecret 参数
4. 修复 cron parser 定时规则校验
5. 修复设置 baseUrl 后无法访问
6. 修复环境变量排序
7. 修复定时任务无法停止

更新方法:

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像:

正式版: whyour/qinglong:latest
Python3.10 正式版: whyour/qinglong:python3.10
debian 版: whyour/qinglong:debian
Python3.10 debian 版: whyour/qinglong:debian-python3.10
npm 版本: npm i -g @whyour/qinglong

不种闲花，池亭畔、几竿修竹。

机场推荐(已稳定使用一年+，支持IPV6/GPT):
虎云 去注册
熊云 去注册

使用指南|OpenApi|京东线报|美团|9块9包邮
喝杯咖啡|支付宝红包|优惠商城|饿了么

青龙 v2.20.2 (❗️重要❗️)

更新说明:

1. 修复 path 和 init 接口安全漏洞（重要）

所有版本都需要更新，要不就不要开外网

更新方法:

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像:

正式版: whyour/qinglong:latest
Python3.10 正式版: whyour/qinglong:python3.10
debian 版: whyour/qinglong:debian
Python3.10 debian 版: whyour/qinglong:debian-python3.10
npm 版本: npm i -g @whyour/qinglong

叹寄与路遥，夜雪初积。

机场推荐(已稳定使用一年+，支持IPV6/GPT):
虎云 去注册
熊云 去注册

使用指南|OpenApi|京东线报|美团|9块9包邮
喝杯咖啡|支付宝红包|优惠商城|饿了么

👍项目推荐👍
Orange Cloud，是一个 Cloudflare 的原生 iOS 客户端。
主要特点：
使用 Cloudflare 官方 OAuth 登录（不需要 API Token）
所有数据本地存储，设备直连 Cloudflare API
支持 DNS / Workers / R2 / D1 / KV / WAF / Tunnel / Analytics 等常用功能
开源项目，目前还在持续迭代
适合经常用 Cloudflare 做网站或自建服务的人，在手机上快速查看和管理状态。
GitHub：https://github.com/chen2he/orange-cloud
（也有 TestFlight 版本可以体验）

青龙 v2.21.0

更新说明:

1. 增加任务统计功能
2. 增加运行实例功能
3. 增加环境变量标签功能
4. 新增 OpeniLink 通知渠道
5. 支持自定义接收邮箱地址
6. gRPC 服务增加证书校验
7. 定时任务增加 work_dir 设置
8. 修复 CodeMirror 页面切换多实例崩溃
9. 修复 IPv6 网络连接问题
10. 修复 gRPC extra_schedules 为空时序列化报错
11. 修复 HITOKOTO 参数布尔/字符串类型处理
12. 修复 Server酱 返回错误时 undefined 异常
13. 修复环境变量 position 数据类型异常
14. 修复 Docker 健康检查 QlPort 环境变量读取
15. 其他问题修复

更新方法:

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像:

正式版: whyour/qinglong:latest
Python3.10 正式版: whyour/qinglong:python3.10
debian 版: whyour/qinglong:debian
Python3.10 debian 版: whyour/qinglong:debian-python3.10
npm 版本: npm i -g @whyour/qinglong

千淘万漉虽辛苦，吹尽狂沙始到金。

机场推荐(已稳定使用一年+，支持IPV6/GPT):
虎云 去注册
熊云 去注册

使用指南|OpenApi|京东线报|美团|9块9包邮
喝杯咖啡|支付宝红包|优惠商城|饿了么

青龙 v2.22.0

✨ 新增功能：

1. 新增独立远程 CLI，支持命令行管理任务、订阅、环境变量、脚本等，支持 JSON 输出和中英文帮助
2. 仪表盘支持点击「今日成功 / 今日失败」查看任务明细
3. 新增客户端 IP 与代理链诊断、可信代理配置和登录 IP 黑名单
4. 新增历史运行记录清理预览、手动清理、依赖缓存清理和数据库压缩
5. 新增 WPUSH 通知，支持面板、JavaScript、Python 和 gRPC
6. 新增 ql log 命令，方便查看服务日志

🔧 修复与优化：

1. 优化任务调度、排队、停止与恢复，完善停止失败提示
2. 优化大日志分块读取，修复任务结束后日志显示不完整、中文日志名等问题
3. 加固密码存储、登录认证、两步验证和文件访问
4. 修复登录过期后页面反复刷新，完善任务参数校验提示
5. 优化大目录读取、缓存和依赖管理，减少常驻资源开销
6. 启动时保留 .env 配置，完善启动和数据库迁移错误诊断
7. 改进多架构镜像构建，增加构建来源证明和软件物料清单
8. 其他问题修复

🤖 CLI 安装与 Agent 使用：

在运行终端或 AI Agent 的机器上安装，需要 Node.js ≥ 22.12，推荐 Node.js 24：

npm install -g @whyour/qinglong-cli
ql login --url https://你的青龙面板地址


先在面板「系统设置 → 应用设置」创建应用并授予所需权限，再按登录提示输入 Client ID 和 Client Secret。

登录后即可使用：

ql auth status --json
ql task list --json
ql subscription list --json
ql --help


npm 包内附带 qinglong-cli Skill。将以下目录完整复制到所用 Agent 的 skills 目录，保留其中的 SKILL.md 和 references：

$(npm root -g)/@whyour/qinglong-cli/skills/qinglong-cli


让 Agent 加载该 Skill，并确保它能访问 ql 命令及登录配置，即可用自然语言管理面板，例如：

「查看青龙任务列表，找出最近失败的任务并分析日志。」

「创建一个每天早上 8 点执行的任务，执行命令为 task demo.js。」

CLI 支持 JSON 输出，方便 Agent 查询状态、执行操作和核对结果。已有面板的机器请使用独立安装目录，避免覆盖面板内置的 ql 命令。

CLI 使用说明 | Agent Skill

⚠️ 升级提醒：

升级前请停止面板和任务，备份完整持久化数据目录。新版首次成功登录或修改密码后会迁移密码存储格式，回退旧版时不能仅回退镜像，应恢复升级前的完整备份。

自定义 API 客户端请留意旧文件读取接口和日志分页方式的变化。独立远程 CLI 要求 Node.js ≥ 22.12，安装时避免覆盖面板内置的 ql 命令。

更新方法：

-> 面板更新 系统设置 -> 其他设置 -> 检查更新
-> 容器内更新 执行 ql update
-> 宿主机更新 docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower -cR <容器名>
-> debian 版本同步更新

版本镜像：

正式版：whyour/qinglong:2.22.0
Python3.10 正式版：whyour/qinglong:2.22.0-python3.10
debian 版：whyour/qinglong:2.22.0-debian
Python3.10 debian 版：whyour/qinglong:2.22.0-debian-python3.10
npm 版本：npm i -g @whyour/qinglong@2.22.0

完整更新说明

删繁就简三秋树，领异标新二月花。

机场推荐(已稳定使用一年+，支持IPV6/GPT)：
虎云 去注册
熊云 去注册

青龙官网

推荐一个朋友做的小工具 usAge：把 Codex、Claude、Cursor 等 AI 服务的用量、剩余额度和重置时间放在一起，还能放到桌面小组件上，省得来回打开各家后台。
支持 Apple、Android 和 HarmonyOS，用量请求由设备直连服务商。

👉 https://usage.o-c.do/zh-Hans

青龙 v2.23.0

✨ 新增功能：

1. 新增脚本历史版本查看、对比与恢复，每个脚本最多保留 20 个版本。恢复前检查内容哈希，避免覆盖同时发生的修改。
2. 远程 CLI 更新至 0.1.2，增加脚本历史命令，完善冲突和认证错误提示。

🔧 修复与优化：

1. 普通任务与订阅调度迁移到 node-cron，保留旧规则兼容，补充宏与夏令时行为说明。
2. 修复禁用、删除或修改后旧排队任务仍执行的问题，完善超时、停止和 Shell before/after 环境传递。
3. 修复长期运行后的系统令牌失效和认证缓存并发更新；Shell API 遇到 401 会刷新令牌并重试一次。
4. 降低任务启动开销，JS/Python 通知依赖改为首次调用时加载。
5. 加固环境变量、订阅参数、路径与 SSH 配置，保留合法中文和分支别名。
6. 修复页面升级、ql update 和静态资源同步，完善升级校验、完整备份与恢复；修复 Debian 依赖、通知和调度问题，补齐中英文翻译。
7. 最小修补 HTTP 压缩、上传、gRPC、代理 IP、WebSocket 与 JSON 查询路径的依赖漏洞。其余依赖治理和运行时迁移后续处理。

🤖 CLI 安装与 Agent 使用：

远程 CLI 要求 Node.js ≥ 22.12：

npm install -g @whyour/qinglong-cli@0.1.2
ql login --url https://你的青龙面板地址
ql auth status --json
ql task list --json
ql subscription list --json

在面板「系统设置 → 应用设置」创建应用、授予所需权限，再按提示输入 Client ID 和 Client Secret。

将 npm 包中的整个 Skill 目录复制到所用 Agent 的 skills 目录，保留 SKILL.md 和 references；加载后确保 Agent 可访问 ql 及登录配置：

$(npm root -g)/@whyour/qinglong-cli/skills/qinglong-cli

例如：「查看青龙最近失败的任务，分析日志。」已有面板的机器使用独立安装目录，避免覆盖面板内置 ql。

CLI 使用说明 | Agent Skill

⚠️ 升级提醒：

升级前停止面板和任务，备份完整持久化数据目录，包含数据库、脚本、配置、日志、依赖缓存和 script-history。回退时恢复升级前的完整备份。

默认 Debian 镜像仍为 Debian 12 / Node.js 20，默认 Python 为 3.11。Node.js 20 已结束上游维护，运行时迁移将在后续版本处理；本次仅完成已选定的最小依赖修补。

2.23.0 是两个 Python 3.10 兼容镜像的最后一个版本，发布后停止维护。请验证脚本与依赖后迁移到默认 Python 3.11 镜像。

更新方法：

→ 面板更新：系统设置 → 其他设置 → 检查更新
→ 容器内更新：执行 ql update
→ 宿主机更新：拉取对应新镜像，按原启动配置重建容器并沿用完整数据挂载
→ Debian 版本同步更新

版本镜像：

正式版：whyour/qinglong:2.23.0
Python3.10 正式版：whyour/qinglong:2.23.0-python3.10（最后维护版本）
Debian 版：whyour/qinglong:2.23.0-debian
Python3.10 Debian 版：whyour/qinglong:2.23.0-debian-python3.10（最后维护版本）
npm 版本：npm i -g @whyour/qinglong@2.23.0

完整更新说明

潮平两岸阔，风正一帆悬。

机场推荐（已稳定使用一年+，支持 IPV6/GPT）：
虎云 去注册
熊云 去注册

青龙官网