青龙面板 + QLScriptPublic 指南:如何 5 分钟部署一套 100+ 的自动化签到脚本

青龙面板 + QLScriptPublic 指南:如何 5 分钟部署一套 100+ 的自动化签到脚本

【免费下载链接】QLScriptPublic 青龙面板脚本公共仓库 企鹅交流1021185005 【免费下载链接】QLScriptPublic 项目地址: https://gitcode.com/GitHub_Trending/ql/QLScriptPublic

早上九点的电梯里、通勤地铁上、午休的工位前——你大概也有过这样的时刻:手机里躺着一二十个 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 → 日志"的闭环,再逐步把其他任务搬上来——这是最省力也最稳的路线。

【免费下载链接】QLScriptPublic 青龙面板脚本公共仓库 企鹅交流1021185005 【免费下载链接】QLScriptPublic 项目地址: https://gitcode.com/GitHub_Trending/ql/QLScriptPublic

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值