玩转青龙面板

青龙面板是支持 Python3、JavaScript、Shell、Typescript 的定时任务管理平台。

1、容器创建
部署参考的compose文件，修改主机端口、主机目录即可。如果不知道什么是主机端口和主机目录，可以看我关于compose的教程:compose文件说明。

1. services:
   
2.   qinglong:
   
3.     image: 'whyour/qinglong:latest'
   
4.     container_name: qinglong
   
5.     restart: always
   
6.     network_mode: bridge
   
7.     ports:
   
8.       - "5700:5700"
   
9.     volumes:
   
10.       - ./data:/ql/data
    
11.     environment:
    
12.       QlBaseUrl: '/' # 部署路径非必须，以斜杠开头和结尾，比如 /test/

复制代码

2、初始化

1、在本地浏览器输入 ip:主机端口进行访问，点击开始安装


2、设置完管理员账号密码后可以点击提交


3、通知设置可以先跳过


4、点击去登录



5、输入账户密码点击登录



6、登录成功界面




3、使用

1、通知
1、 系统设置
可以点击系统设置下的通知设置，选择配置消息通知方式。这个一般是推送系统级的消息比如账号活动等，由面板自身主动触发推送。


2、 配置文件
点击配置文件菜单，配置config.sh文件里通知方式的参数。可以供 notify.py/sendNotify.js 调用推送单个脚本运行结果。


如果通知里不想带上每日一言，可以在notify.py/sendNotify.js 脚本里把HITOKOTO的值改成字符串false，即'false'。


2、依赖安装
点击依赖管理页面选择语言类别，比如python3，然后点击右上角的创建依赖按钮，在名称处填写依赖名称如requests来安装脚本所需的依赖。

比如py常用的依赖：beautifulsoup4和requests。


如果依赖拉取不下来，可以在设置里填写软件包镜像源或者设置代理。

1. # Node 软件包镜像源
   
2. https://registry.npmmirror.com
   
3. # Python 软件包镜像源
   
4. https://pypi.tuna.tsinghua.edu.cn/simple
   
5. # Linux 软件包镜像源
   
6. https://mirrors.aliyun.com/

复制代码

3、创建定时任务
点击定时任务菜单，点击右上角的创建任务。
- 名称：自定义
- 脚本：task后接脚本地址，比如：`task 1000qm.py`，如果脚本不在主目录，比如是在login文件夹下，则是`task login/1000qm.py`
- 定时规则：5/6位cron表达式。比如每天8点：`0 8 * * *`



其他task命令，其中：file_path是脚本地址：

1. # 依次执行，如果设置了随机延迟，将随机延迟一定秒数
   
2. task <file_path>                                             
   
3. # 依次执行，无论是否设置了随机延迟，均立即运行，前台会输出日，同时记录在日志文件中
   
4. task <file_path> now                                         
   
5. # 并发执行，无论是否设置了随机延迟，均立即运行，前台不产生日，直接记录在日志文件中，且可指定账号执行
   
6. task <file_path> conc <env_name> <account_number>(可选的)
   
7. # 指定账号执行，无论是否设置了随机延迟，均立即运行
   
8. task <file_path> desi <env_name> <account_number>      
   
9. # 设置任务超时时间   
   
10. task -m <max_time> <file_path>
    
11. # 使用 -- 分割，-- 后面的参数会传给脚本，下面的例子，脚本就可接收到参数 -u whyour -p password
    
12. task <file_path> -- -u whyour -p password

复制代码

4、随机延迟
对于一些签到定时任务一直在一个时间点运行会很容易被发现，因此可以对任务设置个随机的延迟时间。
点击配置文件，找到RandomDelay项，把值（单位秒）改成想延迟的时间即可，比如1h内随机：`RandomDelay="3600"`.


5、自定义通知通知内容包含\n
以py文件为例，打开notify.py，找到以下内容进行更改

1. # 原始内容
   
2. lambda v: v.replace("$title", title.replace("\n", "\\n")).replace(
   
3.   "$content", content.replace("\n", "\\n")
   
4. ),
   
5. 
   
6. 
   
7. # 更改后的内容
   
8. # 取消 \n 转义
   
9. lambda v: v.replace("$title", title).replace( "$content", content),

复制代码

6、环境变量
青龙可以在环境变量菜单点击右上角的创建变量按钮填写名称和值后创建环境变量。



在脚本里可以读取设置的环境变量。

以py为例获取环境变量的几种方法：

1. import os
   
2. <div>
   
3. # 获取含关键词的环境变量列表
   
4. oleEnv = QLAPI.getEnvs({ "searchValue": "TEST" })
   
5. print(oleEnv)
   
6. 
   
7. # 获取指定环境变量值
   
8. oleEnv2 = os.getenv('TEST')
   
9. print(oleEnv2)
   
10. 
    
11. # 通过 ID 获取环境变量
    
12. oleEnv3 = QLAPI.getEnvById({ "id": 5 })
    
13. print(oleEnv3)
    
14. 
    
15. 
    
16. # 更新现有环境变量
    
17. newEnv = oleEnv3["data"]
    
18. newEnv['value'] = '55'
    
19. print(newEnv)
    
20. QLAPI.updateEnv({ "env": newEnv })
    
21. 
    
22. 
    
23. print(QLAPI.getEnvs({ "searchValue": "TEST" }))</div>

复制代码

nodejs：

1. // 获取环境列表
   
2. QLAPI.getEnvs({ searchValue: 'dddd' }).then((x) => {
   
3.   console.log('getEnvs', x);
   
4. });

复制代码

全局变量 QLAPI 是内置 API 的入口，官方文档：https://qinglong.online/guide/user-guide/built-in-api。其中其他环境变量相关的方法有：
- getEnvs: 获取环境变量列表
- createEnv: 创建新环境变量
- updateEnv: 更新现有环境变量
- deleteEnvs: 删除指定环境变量
- moveEnv: 移动环境变量位置
- disableEnvs: 禁用指定环境变量
- enableEnvs: 启用指定环境变量
- updateEnvNames: 更新指定环境变量的名称
- getEnvById: 通过 ID 获取环境变量
- systemNotify: 发送系统通知

牛蛙牛蛙

交出你的脚本

Rabbit 发表于 2025-11-6 15:28
交出你的脚本

网上搜一下，一大堆脚本

夏夏子 发表于 2025-11-6 15:36
网上搜一下，一大堆脚本

好脚本都是私藏的

当一个定时执行的工具还是不错的

可以定时钉钉打卡不？

上车
www.foree.cn:8082/

爪爪 发表于 2025-11-6 18:55
可以定时钉钉打卡不？

网上貌似有相关脚本，但是我没试过，你可以去看看

Rabbit 发表于 2025-11-6 15:59
好脚本都是私藏的

哈哈 常用的网上还是都有的 我也就两个签到的