青龙面板 + QLScriptPublic 指南:如何 5 分钟部署一套 100+ 的自动化签到脚本
早上九点的电梯里、通勤地铁上、午休的工位前——你大概也有过这样的时刻:手机里躺着一二十个 App 和小程序,每个都藏着"每日签到""积分任务""浏览赚金币",手动点一遍少说十几分钟,隔天再点又是一遍,漏一天还断了连续签到。QLScriptPublic 配合青龙面板做的,就是把这类重复劳动交给脚本定时执行:你只负责把账号信息填一次,剩下的交给 cron。这个仓库目前收拢了 100 多个可用脚本,覆盖签到、积分任务、权益领取等日常场景,JS 和 Python 两种语言都有,装进青龙面板即可调度。
先搞清楚它是什么,以及谁适合用
一句话:QLScriptPublic 是一个面向青龙面板的自动化脚本公共仓库,把各平台"签到、做任务、领奖励"的请求封装成可定时执行的脚本,解决的核心问题是"重复性轻任务没人想天天手动做"。
适合的人群:
- 手里有一台 24 小时开机的设备(树莓派、NAS、云主机、家里的旧电脑),愿意用 Docker 或面板跑定时任务;
- 会员号、积分号、小程序账号攒得比较多,想批量管理的;
- 对脚本本身不要求精通,但愿意看懂"环境变量填什么、定时怎么配"的新手。
如果完全没有服务器、也不想折腾 Docker,那这套东西暂时帮不上你。
5 分钟部署路径:从空面板到第一个任务
最短路径是:装好青龙面板 → 拉库 → 建任务。三步走。
第一步:准备面板环境
按青龙面板官方的方式用 Docker 起一个容器即可,核心是挂载数据目录和面板端口:
docker run -dit \
-v $PWD/ql:/ql/data \
-p 5600:5700 \
-e TZ=Asia/Shanghai \
--name qinglong \
--hostname qinglong \
--restart always \
whyour/qinglong
端口、镜像名按你实际环境调整。关键是 TZ=Asia/Shanghai,时区错了,cron 时间全会错位。
第二步:一条命令拉库
在面板命令行里执行:
ql repo https://gitcode.com/GitHub_Trending/ql/QLScriptPublic backup main
这条命令会把整个仓库拉到面板的数据目录下。之后每次想更新脚本,再执行一次同样的 ql repo 命令即可覆盖刷新。
第三步:建任务
进面板的"任务"页面,脚本路径选到仓库里对应的文件,填上脚本要求的 cron 表达式,保存后手动点一次"执行"验证。仓库里大多数脚本的头部注释都写好了建议的 cron,比如 daily/erke.py 头部标的是 cron: 1 10 * * *(每天 10 点零 1 分),直接抄过来就能用。
到这里,第一个自动化任务就上线了。
能力全景:按"你要解决的问题"来找脚本
仓库按目录分了四块,但更实用的理解方式是按任务类型对号入座:
1. 纯签到类:输入一个 token,产出一次签到
backup/ 和 daily/ 下的多数脚本属于这一类。逻辑简单:环境变量里放抓包得到的 token(或 cookie 片段),脚本按固定请求发出去,日志里回显结果。例如 backup/fenxiang.js(粉象生活)要求变量值形如 did#finger#token#oaid,四个值用 # 分隔,脚本自动按位拆解。
2. 签到 + 任务链类:一次运行完成一串动作
这类脚本不止签到。比如 backup/fenxiang.js 会依次执行签到领奖励、完成特殊活动、遍历任务列表逐个打卡,任务之间还刻意 wait(5000) 间隔几秒,避免请求太密集。daily/chery.js(奇瑞汽车)则是签到 + 拉文章列表 + 逐篇阅读计数。适合"每天有一整套固定动作"的平台。
3. 微信小程序类:需要先打通 code 登录
wxapp/ 目录是仓库里最大的一块,50 多个脚本几乎都依赖同一套机制:通过 wx_server_url 和 wx_auth 两个环境变量向一个 wx server 换取微信登录的 code,再完成小程序的登录和签到。目录说明里写得很直白:wxapp/README.md——"首次使用一般需要先在对应微信小程序内完成注册、授权或绑定手机号"。这类脚本的门槛不在脚本本身,而在你得多跑一个 wx server 服务(后面"避坑"部分会讲)。
4. 京东生态类:自成体系的一整套
jd/ 目录不是单个签到脚本,而是一套完整的京东请求基础设施:cookie 管理(jd/jdCookie.js)、h5st 签名、token 获取、奖品领取,以及一堆 dylan*.js、Rebels*.js 这类签名/验证模块。如果你主要玩京东系任务,这个目录的复用价值很高——写新脚本时直接 require 里面的公共模块,不用自己从头造轮子。
关键配置详解:三个变量决定脚本能不能跑
账号信息:环境变量名和格式要精确匹配
每个脚本头部注释都会注明"变量名 + 变量值格式"。例如 daily/erke.py(鸿星尔克)要求:
- 环境变量名:
ERKE_CONF - 值格式:
member_id#enterprise_id#unionid#openid#wx_openid#备注 - 多账号:换行或用
&连接
仓库的公共环境类 tools/env.js 里的 checkEnv 会自动按 & 或换行拆分账号,并打印"共找到 N 个账号"——执行日志里没看到账号数,基本就是变量名或分隔符写错了。
定时任务:cron 表达式与脚本建议值对齐
仓库脚本基本都自带建议 cron,散落在头部注释里。常见写法参考:
30 8 * * *:每天 8:30,单次固定执行(多数签到脚本用这种)10 6,18 * * *:每天 6 点和 18 点各一次,适合有"上午/下午各刷一次"需求的任务9 9 * * *:错开整点,避免和别人的默认时间撞车
实践上建议别所有任务都定在同一分钟,错开几分钟,既降低瞬间并发,也让日志好读。
微信类脚本的额外依赖:wx_server_url / wx_auth
这是新手最容易卡住的地方。wxapp/aima.js 头部的注释说得很清楚:
CODE登录依赖:wx_server_url、wx_auth
wx_server_url:你的 wx server 地址,代码里给了内网示例值(如http://192.168.31.196:8787),必须换成你自己的部署地址;wx_auth:必填,wx server 的鉴权值,不填会直接抛"未配置 wx_server_url 或 wx_auth"。
两个变量都填上、服务可达,wxapp 目录的脚本才能开始工作。
实战案例:三个典型场景怎么配
案例一:鸿星尔克每日签到(最简单的一档)
- 输入:抓包拿到
member_id、enterprise_id、unionid、openid、wx_openid,拼成a#b#c#d#e#备注写进环境变量ERKE_CONF; - 操作:任务里指定 daily/erke.py,cron 填
1 10 * * *; - 结果:每天 10 点脚本自行完成签名计算和签到请求,日志输出签到结果;多账号就换行加几行,脚本循环处理。
案例二:爱玛会员俱乐部(微信 code 登录的代表)
- 输入:全局配
wx_server_url+wx_auth,脚本变量aima填账号 openid,多个用&分隔;首次要在爱玛小程序里完成注册/授权; - 操作:指定 wxapp/aima.js 并配 cron;
- 结果:脚本向 wx server 取 code → 换取 token(本地会缓存到
aima_token_cache.json)→ 调签到接口。注意它用了本地缓存文件存 token,面板数据目录要有可写权限。
案例三:奇瑞汽车(token + 阅读任务的组合)
- 输入:抓包登录接口
uaa2c.chery.cn返回的access_token,多账号换行或用&分隔,写入脚本指定的环境变量(变量名chery); - 操作:指定 daily/chery.js,cron 抄头部的
30 8 * * *; - 结果:每天自动签到并逐篇阅读内容累计任务数。脚本头注释里还附了一个自助获取 token 的小工具地址,不想抓包可以走那条路。
避坑与排错:现象 → 排查 → 解决
现象:执行日志显示"共找到 0 个账号"或压根没输出
排查:变量名是否和脚本头部注释一字不差(大小写敏感);多账号分隔符是否用的 & 或换行;面板环境变量页面里是否真的保存了。 解决:对照脚本头部"变量名/变量值格式"逐字段重写一遍,保存后手动执行一次。
现象:wxapp 脚本报"缺少 wx_auth"或连接超时
排查:确认 wx_server_url 指向的是你自己部署的服务而不是示例地址;确认 wx_auth 已填写;在面板命令行 curl 一下该地址看是否可达。 解决:把 URL 换成实际地址,补齐鉴权值;如果服务部署在面板容器之外,注意内网/宿主机地址的可达性。
现象:脚本昨天还好,今天突然失败
排查:平台接口更新、token 过期、字段格式变更是三大常见原因。先看日志里具体哪个接口返回异常,再对照仓库里该脚本的"最后一次更新时间"——README 里维护了 脚本功能列表,更新过说明作者已跟进,重新 ql repo 拉一次库。 解决:优先拉库更新脚本;确认 token 类变量是否需要重新抓包;仍不行则暂时停用该任务,避免报错噪音淹没其他任务。
现象:cron 时间到了任务却没跑
排查:容器时区是否为 Asia/Shanghai;cron 表达式是否多写/漏写字段;任务是否被手动暂停。 解决:TZ 环境变量在容器启动参数里改好后重启容器;用 date 命令在面板命令行确认当前时间。
进阶玩法:从"用别人的"到"改自己的"
复用公共模块写新脚本
仓库的 tools/ 目录提供了通用环境类 tools/env.js,封装了多账号拆分(checkEnv)、本地状态存取(get/set 配合 bucket 文件)、随机延时(wait)、日志和统一通知(sendMsg)。写自己的脚本时 new Env("脚本名") 起手,账号解析和通知推送都是现成的。backup/ 里的老脚本是最好的模板——挑一个结构相似的,把接口和参数换掉即可。
多账号批量管理
两套约定全仓库通用:单账号内多个值用 # 分隔,多个账号之间用 & 或换行分隔。想加账号就加一行,想区分归属就在行尾加备注(如"大号""备用"),日志和通知里能直接认出来。
结果推送
仓库根目录的 sendNotify.js(以及 daily/notify.py)承担执行结果推送。tools/env.js 的 done() 会自动调用 sendNotify 汇总本次运行信息,所以只要你在通知配置文件里接好推送渠道,每个任务的执行结果都会自动推给你——不用逐条翻面板日志。
合规与安全提醒
简短几条,但建议真的执行:
- 脚本仅用于学习和技术研究,涉及各平台用户协议,商用或批量刷量前请自行评估风险;
- token、cookie 属于账号凭证,面板数据目录要做权限收敛,不要把含凭证的目录同步到公开网盘;
- wx server、通知渠道等服务的鉴权值(
wx_auth等)同样按敏感信息管理; - 控制单任务频率、保留随机延时(仓库脚本普遍有
wait),对平台也更友好。
小结
QLScriptPublic 的价值不在单个脚本有多精巧,而在于"拉库即得"的规模:100 多个经过持续维护的脚本、统一的变量约定、现成的公共环境和通知体系,配合青龙面板的一条 ql repo 命令,就能把零散的手动任务收敛成一张定时任务表。先从一两个你最烦的平台入手,跑通"变量 → cron → 日志"的闭环,再逐步把其他任务搬上来——这是最省力也最稳的路线。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考



