利用Docker搭建青龙面板：一站式京东自动签到与脚本管理指南

1. 为什么你需要青龙面板从手动签到到自动化管理的蜕变不知道你有没有这样的经历每天醒来第一件事不是刷牙洗脸而是摸出手机打开好几个购物APP挨个点开签到页面只为领那几毛钱的红包或者几个积分。坚持一两天还行时间一长这事儿就变得特别枯燥还特别容易忘。忘了又觉得亏得慌毕竟蚊子腿也是肉。我之前就是这么过来的直到我发现了青龙面板这个神器才彻底从这种重复劳动里解放出来。简单来说青龙面板就是一个基于Docker的定时任务管理平台。你可以把它想象成一个超级智能、全年无休的“机器人助理”。你只需要告诉它“每天几点几分去帮我执行某个任务”它就会准时、准确地替你完成完事儿了还能通过微信、钉钉或者Telegram给你发个通知告诉你任务执行成功了还是失败了。它的能力远不止签到凡是能写成脚本的重复性操作比如自动备份数据、定时爬取信息、检查网站状态等等它都能胜任。对于我们普通用户来说用它来管理京东自动签到脚本是目前最主流、最实用的玩法。你不用再关心脚本放在哪里、怎么运行、会不会出错。所有脚本都在青龙面板的Web界面上统一管理一目了然。今天这篇文章我就手把手带你从零开始用Docker把青龙面板搭起来并配置好京东自动签到任务。整个过程我保证小白友好哪怕你之前没怎么接触过服务器和命令行跟着我的步骤走也能轻松搞定。咱们的目标是一次部署长期受益让科技真正为我们服务而不是我们被琐事捆绑。2. 部署前的准备给你的服务器“打好地基”在开始搭建青龙面板之前我们得先把它的“房子”——也就是运行环境给准备好。这里最核心的工具就是Docker。你可以把Docker理解成一个超级轻量级的虚拟机管理器但它比传统虚拟机更高效。我们不用在服务器上复杂地安装各种软件和解决依赖冲突直接用Docker拉取一个现成的、打包好的青龙面板“镜像”就能一键运行起来。这就像你下载了一个绿色版的软件压缩包解压就能用非常干净方便。2.1 安装Docker与Docker Compose首先你需要一台服务器。可以是家里的旧电脑装个Linux系统也可以是云服务商提供的云服务器比如阿里云、腾讯云的轻量应用服务器入门款就行。我这里以最常见的Ubuntu系统为例进行演示。第一步安装Docker。打开你的服务器终端SSH连接工具执行下面这条命令。这是一条官方的一键安装脚本非常省心。curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh命令执行完成后运行sudo docker version看看有没有版本信息输出有就说明安装成功了。为了让当前用户不用每次都加sudo来执行docker命令避免权限麻烦我们可以把用户加入docker组sudo usermod -aG docker $USER注意执行完上面这行后你需要完全退出当前的SSH会话然后重新登录一次这个分组生效。接下来安装Docker Compose。它是一个用来定义和运行多容器Docker应用的工具虽然我们青龙面板只用一个容器但用Compose来管理配置会更清晰。同样我们用官方推荐的方式安装最新版sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose sudo chmod x /usr/local/bin/docker-compose检查是否安装成功docker-compose --version看到版本号输出准备工作就完成一大半了。2.2 规划与创建青龙面板的数据目录在使用Docker时有一个非常重要的概念叫“数据持久化”。容器内部的数据是临时的如果容器被删除里面的配置和日志就全没了。所以我们必须把重要的数据目录“映射”到宿主机也就是你的服务器的硬盘上。我习惯在/opt目录下创建所有应用的数据文件夹。我们来为青龙面板创建一个专属目录结构sudo mkdir -p /opt/qinglong cd /opt/qinglong mkdir -p config db log scripts repo raw jbot我来解释一下这几个文件夹是干嘛用的config存放青龙面板的核心配置文件比如通知设置、主题设置等。db存放数据库文件你的任务列表、环境变量都保存在这里。log所有任务运行的日志都会放在这里排查问题就靠它。scripts你后期自己添加的JavaScript或Python脚本可以放在这里。repo从Git仓库拉取的脚本库会存放在这里。raw存放一些原始的脚本文件。jbot存放一些机器人相关的文件如果你用到电报机器人等。创建好这些目录就相当于给青龙面板准备好了“房间”和“储物柜”接下来就可以请它“入住”了。3. 两种方法启动青龙面板单命令与Compose编排现在环境齐备我们可以启动青龙面板容器了。我提供两种最常用的方法你可以任选其一。我个人更推荐第二种因为管理起来更规范。3.1 方法一直接使用Docker Run命令这是最直接快速的方法一条命令搞定。在/opt/qinglong目录下执行docker run -dit \ -v $PWD/config:/ql/config \ -v $PWD/log:/ql/log \ -v $PWD/db:/ql/db \ -v $PWD/repo:/ql/repo \ -v $PWD/raw:/ql/raw \ -v $PWD/scripts:/ql/scripts \ -v $PWD/jbot:/ql/jbot \ -p 5700:5700 \ --name qinglong \ --hostname qinglong \ --restart unless-stopped \ whyour/qinglong:latest我来拆解一下这条命令-v $PWD/config:/ql/config这就是“目录映射”把宿主机的./config映射到容器内的/ql/config。-p 5700:5700端口映射将容器内的5700端口映射到宿主机的5700端口这样我们才能通过浏览器访问。--name qinglong给容器起个名字方便管理。--restart unless-stopped设置重启策略除非手动停止否则如果容器异常退出Docker会自动重启它非常省心。whyour/qinglong:latest指定使用的镜像whyour/qinglong是官方维护的镜像。执行后用docker ps命令查看如果能看到一个名为qinglong的容器在运行就说明启动成功了。3.2 方法二使用Docker Compose文件推荐我更推荐这个方法因为所有配置都写在一个文件里一目了然以后迁移、修改都特别方便。在/opt/qinglong目录下创建一个名为docker-compose.yml的文件version: 3 services: qinglong: image: whyour/qinglong:latest container_name: qinglong restart: unless-stopped ports: - 5700:5700 volumes: - ./config:/ql/config - ./log:/ql/log - ./db:/ql/db - ./repo:/ql/repo - ./raw:/ql/raw - ./scripts:/ql/scripts - ./jbot:/ql/jbot environment: - TZAsia/Shanghai hostname: qinglong这个文件定义了和上面那条docker run命令完全一样的功能而且还多设置了一个环境变量TZ来指定容器时区为上海时间避免任务执行时间错乱。保存文件后在同一个目录下执行一条命令即可启动docker-compose up -d-d参数代表后台运行。停止服务则用docker-compose down重启用docker-compose restart非常优雅。无论用哪种方法启动成功后打开你的浏览器访问http://你的服务器IP地址:5700就能看到青龙面板的登录界面了。首次进入会有一个初始化过程需要你设置管理员账号和密码请务必牢记。4. 青龙面板初体验界面熟悉与核心概念成功登录后你会看到一个非常清晰的后台界面。左侧是导航栏中间是主要内容区。我们先花几分钟熟悉一下几个最重要的概念和页面这对后续操作至关重要。仪表盘首页这里会显示系统的基本信息比如任务总数、运行中的任务、成功的任务次数等一目了然。定时任务这是青龙面板的核心功能页面。所有你添加的自动签到、脚本运行任务都会在这里列表展示。你可以看到每个任务的名称、状态运行中/已停止、上次运行时间、下次运行时间以及日志。环境变量这是另一个极其关键的页面。很多脚本尤其是京东脚本需要读取一些敏感的配置信息比如你的账号Cookie、各种推送服务的密钥等。这些信息绝对不能直接写在脚本里而是以“环境变量”的形式存储在青龙面板中。脚本运行时会从环境变量里读取这些值。这样做既安全又方便管理多个账号。脚本管理这里可以查看和管理从仓库拉取下来的所有脚本文件。你可以在这里阅读脚本源码、手动运行某个脚本或者添加自己编写的脚本。依赖管理有些脚本是Python写的可能需要额外的第三方库比如requests库来发送网络请求。如果脚本运行报错说缺少某个模块你就需要来这里根据脚本要求安装对应的依赖。配置文件这里可以修改青龙面板本身的一些设置比如通知方式钉钉、微信、Telegram等。我强烈建议你在配置好任务后回来把通知功能打开这样任务成功或失败你都能第一时间知道不用每天去登录面板查看。熟悉了这些界面我们就可以进入最激动人心的环节添加你的第一个京东自动签到任务了。这个过程分为三步拉取脚本仓库、设置环境变量、创建定时任务。5. 配置京东自动签到从获取Cookie到任务生效这是整个流程中最需要细心的一步一步错可能导致任务无法执行。别担心跟着我的步骤走绝对没问题。5.1 获取你的京东CookieJD_COOKIECookie是网站用来识别你登录状态的一串字符。青龙面板里的京东脚本需要用它来“冒充”你登录京东从而完成签到等操作。所以我们首先要拿到自己账号的Cookie。安全提示Cookie相当于你账号的“临时密码”绝对不能泄露给任何人只在你自己的服务器和青龙面板中使用。获取步骤如下在电脑上用Chrome或Edge浏览器打开京东官网 (jd.com)并登录你的账号。登录成功后在当前页面按下键盘的F12键打开“开发者工具”。在开发者工具顶部找到并点击“Application”应用程序选项卡。如果找不到可能在“”更多菜单里。在左侧栏找到“Storage”存储-“Cookies”-“https://www.jd.com”。这时右侧会列出很多Cookie条目。我们需要找到其中两条pt_key和pt_pin。分别点击pt_key和pt_pin这两行在下面的信息栏里复制它们的“Value”值。最终你需要把它们拼接成如下格式注意分号和空格pt_keyxxxxxxxxxxxxxx; pt_pinjd_xxxxxxx;请注意pt_pin的值看起来可能是你的账号昵称编码直接复制即可不要修改。5.2 在青龙面板中添加环境变量拿到拼接好的Cookie字符串后我们回到青龙面板。点击左侧“环境变量”- 点击右上角“新建变量”。名称这里必须、一定、务必填写JD_COOKIE全部大写下划线。这是脚本约定好的变量名写错了脚本就找不到。值将你刚才拼接好的pt_key...; pt_pin...;整个字符串粘贴进去。备注可以写个备注比如“我的主账号”方便管理。如果你有多个京东账号可以重复此步骤创建多个JD_COOKIE变量青龙面板支持多账号同时运行。点击“确定”保存。重要提醒京东Cookie的有效期通常为一个月左右。过期后任务会失败。届时你需要按上述步骤重新获取并更新这个环境变量的值。这也是为什么开启任务失败通知很重要。5.3 拉取京东签到脚本仓库青龙面板的强大之处在于它可以直接从GitHub等代码仓库拉取整个脚本库。我们不需要自己一个个去找脚本。这里我以目前比较流行且维护活跃的仓库为例。请注意由于网络环境差异直接从GitHub拉取可能会很慢或失败。因此我们通常使用国内镜像地址或代理地址此处指代的是为加速GitHub访问而提供的公共服务非违规内容。在青龙面板的“定时任务”页面点击右上角“新建任务”。任务名称可以起名为“拉取京东脚本库”。命令填入以下命令之一选择一个即可不要同时添加多个拉库任务可能导致冲突。# 使用一个常见的镜像地址拉取 faker2 仓库 ql repo https://ghproxy.com/https://github.com/shufflewzc/faker2.git jd_|jx_|gua_|jddj_|jdCookie activity|backUp ^jd[^_]|USER|function|utils|sendNotify|ZooFaker_Necklace.js|JDJRValidator_|sign_graphics_validate|ql|JDSignValidator|magic|depend|h5sts main定时规则对于拉库任务可以设置为每天自动更新一次比如0 0 * * *代表每天零点运行。点击确定。这个命令的意思是从指定的Git仓库地址拉取所有文件名匹配jd_|jx_|gua_|jddj_|jdCookie的脚本文件同时排除包含activity|backUp关键词的目录并且筛选掉一些非任务脚本。任务运行成功后你会在左侧“脚本管理”页面看到拉取下来的大量以jd_开头的脚本文件比如jd_bean_sign.js京豆签到、jd_fruit.js东东农场等等。5.4 创建你的第一个自动签到任务脚本库拉取下来了环境变量也设置好了现在可以创建具体的签到任务了。再次点击“新建任务”。任务名称起个易懂的名字如“京豆签到”。命令输入task jd_bean_sign.js。这个命令就是告诉青龙面板去执行jd_bean_sign.js这个脚本。定时规则这是核心青龙面板使用Cron表达式来设定时间。京东签到通常每天一次即可。你可以设置为5 0 * * *这代表每天凌晨0点5分运行。如果你对Cron表达式不熟可以点击输入框旁边的“定时规则”按钮图形化选择时间非常方便。点击确定。创建完成后这个任务会出现在任务列表里。你可以点击右侧的“运行”按钮手动执行一次测试是否成功。然后点击任务名称查看“日志”就能看到详细的执行过程。如果一切正常日志最后会显示签到成功的提示。6. 进阶管理与避坑指南让自动化更稳定可靠基础功能搭建完成后要想用得顺手、用得长久还需要一些进阶配置和注意事项。这些都是我踩过坑后总结出来的经验。6.1 管理多个账号与脚本如果你有多个京东账号很简单在“环境变量”页面再新建几个JD_COOKIE变量即可。脚本会自动遍历所有名为JD_COOKIE的变量为每个账号执行任务。你甚至可以为不同账号备注不同的pt_pin值以便区分。对于脚本不建议一次性把所有拉取下来的脚本都定时运行。很多脚本功能类似或者需要不同的环境比如某些脚本需要特定的商品ID。初期建议只开启最核心的几个jd_bean_sign.js京豆签到jd_joy.js宠汪汪jd_fruit.js东东农场jd_pet.js东东萌宠先让这几个稳定跑起来再根据日志和通知慢慢添加其他你感兴趣的活动脚本。6.2 配置消息通知强烈推荐没有通知的自动化是没有灵魂的。你不可能天天登录面板去看日志。青龙面板支持多种通知方式我以最常用的“钉钉机器人”为例。在钉钉群里添加一个自定义机器人获取它的Webhook地址。在青龙面板点击左侧“配置文件”。找到qinglong/config目录下的extra.sh或notify.sh文件不同版本可能不同。在文件里找到钉钉相关的配置项填入你的机器人Webhook地址和密钥。保存配置并在“依赖管理”中安装requests库如果还没安装的话。之后任何任务的成功或失败你都会在钉钉群里收到通知了。Telegram和微信的通知配置类似可以参考脚本库中的文档。6.3 常见问题与排查思路任务日志显示“找不到Cookie”或“未登录”99%的原因是环境变量JD_COOKIE的名字没写对或者Cookie值过期了。请严格按照步骤5.1和5.2检查。任务运行一下就结束没有效果打开脚本的详细日志看看。可能是网络问题也可能是脚本依赖没安装。去“依赖管理”页面根据脚本文件开头注释的说明通常会有## 依赖的第三方模块requests这样的提示安装对应的Python模块。拉取脚本库失败通常是网络问题。可以尝试更换命令中的仓库镜像地址将https://github.com/...换成https://ghproxy.com/https://github.com/...或其他可用的镜像。也可以在服务器上测试一下curl -I https://github.com看是否能通。服务器时间不对导致任务不按时运行确保在Docker Compose文件里设置了TZAsia/Shanghai环境变量并且在服务器系统里也使用sudo timedatectl set-timezone Asia/Shanghai命令校准了时区。最后也是最重要的提醒使用自动化脚本请务必遵守平台规则不要添加过于频繁、贪婪的任务比如秒杀脚本。将心比心设置合理的运行间隔只用于解放双手完成日常的签到、领水滴等基础任务这样才能长久、稳定地使用下去。我的这套环境已经稳定运行超过一年每天帮我处理几十个定时任务真正做到了“设置好就忘掉”。希望这份详细的指南也能帮你顺利搭建起来享受自动化带来的便利。如果在搭建过程中遇到任何具体问题多看看任务日志那里面包含了所有线索。