一、项目速览

入门 · 1 分钟版

Faker2 是一个面向京东（JD）生态的自动化脚本集合库，运行在 青龙面板（QL Panel）上。简单说，它就是一套帮你自动完成京东签到、做任务、领京豆等日常操作的脚本工具箱。

它解决什么问题：每天手动打开京东 App 点签到、做浏览任务、领优惠券——这些重复劳动完全可以交给定时任务。Faker2 把主流脚本聚合到一个仓库，配合青龙面板的定时调度，实现“挂机自动赚京豆”。

一句话判断：如果你是京东 Plus 会员、经常领京豆/红包/优惠券，或者想解放双手做日常任务，这个项目值得花 10 分钟配置。

谁最该用：有 VPS 或 NAS 的京东重度用户、薅羊毛爱好者、青龙面板现有用户。对 JS 零基础也能上手，因为主要工作是“拉库+配置环境变量”。

二、核心功能与架构

进阶 · 推荐细读

Faker2 本质上是一个 青龙面板的脚本订阅源。它不提供面板本身，而是提供“在面板里跑什么脚本”的答案。核心架构可以拆成三层：

脚本层：包含京东签到、店铺任务、浏览任务、领红包、抽奖等几十个独立 JS 文件。每个脚本对应一个京东 App 内的具体活动或功能。脚本由社区贡献者维护（如 @NobyDa、@chavyleung 等），Faker2 做的是聚合和持续更新。

调度层：通过青龙面板的定时任务机制，在指定时间（比如每天早上 6 点）自动执行脚本。你可以控制哪些脚本跑、跑多久、跑完是否通知。

配置层：最关键的部分——京东 Cookie。脚本需要你的京东账号登录态才能执行操作。Faker2 的设计要求 Cookie 在本地环境中计算，不经过第三方服务器，这比一些在线服务更安全。

作者视角：如果你是后端开发者，可能会疑惑“为什么不直接把 Cookie 写死在脚本里”。原因很简单：京东 Cookie 有效期短（通常 1-3 天），且每次登录都会变。Faker2 的做法是让你在青龙面板的环境变量里配置 JD_COOKIE，脚本运行时动态读取——这样换 Cookie 不用改代码，更安全。

核心亮点：Faker2 适配了 Spy 插件，可以实现 24 小时监控某些活动页面，当有新任务出现时自动执行。这在京东的限时活动中非常有用（比如整点抢券）。

三、动手实践

入门

环境准备

你需要一台能装 Docker 的 Linux 服务器（或 NAS）。以下操作假设你已有一台 CentOS 7+ 或 Ubuntu 20+ 的机器。

第一步：安装青龙面板（使用一键脚本）

# 建议在 root 用户下执行
curl -sSL https://thin-hill-428.notion.site/Faker-QL-pannel-Faker-Repository-environment-Setup-45edcbfe90d74d8abb2d71896eab3be7 -o install.sh
# 实际安装命令请以该链接内为准，这里给出标准青龙安装方式：
docker run -dit \
  --name qinglong \
  --hostname qinglong \
  --restart always \
  -p 5700:5700 \
  -v $PWD/ql/config:/ql/config \
  -v $PWD/ql/log:/ql/log \
  -v $PWD/ql/db:/ql/db \
  -v $PWD/ql/repo:/ql/repo \
  -v $PWD/ql/raw:/ql/raw \
  -v $PWD/ql/scripts:/ql/scripts \
  -v $PWD/ql/jbot:/ql/jbot \
  -v $PWD/ql/ninja:/ql/ninja \
  whyour/qinglong:latest

第二步：配置 GitHub 代理（国内服务器必须做）

# 打开青龙面板的配置文件
vi /ql/config/config.sh
# 找到 GithubProxyUrl="" 这一行，去掉双引号中的内容
# 改为：GithubProxyUrl=""
# 如果你有代理，填入代理地址，如：GithubProxyUrl="http://127.0.0.1:1080"

第三步：拉取 Faker2 仓库

登录青龙面板（浏览器访问 http://你的IP:5700），进入 定时任务 → 新建任务：

• 名称：Faker2 拉库
• 命令：ql repo https://git.metauniverse-cn.com/https://github.com/shufflewzc/faker4.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 6 * * *（每天早上 6 点拉一次）
• 任务类型：定时任务

保存后，手动运行一次。等待 1-3 分钟，你会看到脚本列表里多出几十个 jd_ 开头的任务。

最小可运行示例：配置京东 Cookie

第一步：获取 Cookie。在浏览器打开京东网页版（m.jd.com），登录后按 F12 打开开发者工具 → 找到 Network 标签 → 刷新页面 → 找到任意请求 → 在请求头里找到 Cookie 字段，复制整段内容。

第二步：在青龙面板中配置环境变量：

• 进入 环境变量 → 新建
• 名称：JD_COOKIE
• 值：粘贴你复制的 Cookie 内容
• 备注：京东主账号
• 保存

第三步：运行一次签到脚本。找到名为 jd_bean_sign.js 的任务，点击运行。等待几秒，查看日志，应该能看到“签到成功”或“今日已签到”的提示。

常见踩坑 1：Cookie 格式不对。正确的 Cookie 应该包含 pt_key=xxx; pt_pin=xxx; 这样的键值对。如果你只复制了部分内容，脚本会报“获取不到 Cookie”错误。解决方案：用浏览器插件“京东 Cookie 提取器”一键获取。

常见踩坑 2：国内服务器拉库超时。如果你在执行 ql repo 时看到 Failed to connect to github.com，说明需要配置代理。检查青龙面板的 config.sh 中 GithubProxyUrl 是否设置正确，或者改用 https://ghproxy.com/ 等镜像前缀。

四、进阶玩法

深入 · 老手可选

多账号配置

如果你有多个京东账号，只需在 JD_COOKIE 环境变量中填入多个 Cookie，用 换行 或 & 分隔：

pt_key=xxx1; pt_pin=user1;
pt_key=xxx2; pt_pin=user2;

Faker2 的脚本会自动遍历所有 Cookie，每个账号独立执行。日志里会显示 账号1、账号2 的区分。

作者视角：多账号时注意京东的封号风险。同一 IP 登录多个账号，短时间内大量操作容易被风控。建议每个账号之间留 5-10 秒间隔，部分脚本支持 RANDOM_DELAY 环境变量来控制随机延迟。

自定义通知

青龙面板支持多种通知渠道（企业微信、钉钉、Telegram、PushPlus 等）。在 环境变量 中配置对应的 KEY，脚本执行完成后会自动推送结果：

# 示例：配置 PushPlus 通知
# 名称: PUSH_PLUS_TOKEN
# 值: 你的 PushPlus Token

# 脚本运行后，日志末尾会显示 "发送通知成功"

屏蔽不需要的脚本

Faker2 默认拉取全部脚本，但你可能只想跑签到任务。在拉库命令的第三个参数（排除规则）中加规则即可：

# 只保留签到类脚本，排除其他活动
ql repo https://... "jd_bean_sign|jd_joy" "activity|backUp" "^jd[^_]|..."

更简单的做法：在青龙面板的 定时任务 列表中，手动禁用不需要的任务（右键菜单 → 禁用）。

五、判断与建议

进阶 · 推荐细读

应该选 Faker2 的场景

• 你已经在用青龙面板，想找一个更新频率高、脚本全的京东脚本源
• 你需要多账号管理，且希望每个账号独立执行
• 你关注限时活动，需要 Spy 插件 24 小时监控
• 你希望脚本安全可控（本地计算 Cookie，不经过第三方）

不该选 Faker2 的场景

• 你只有 1-2 个京东账号，且只想要签到——可以用更轻量的 jd_bean_sign.js 单文件，没必要拉整个仓库
• 你没有 VPS/NAS，只有 Windows 电脑——建议用 Windows 版青龙（Docker Desktop），但性能消耗较大
• 你完全不想接触代码——Faker2 需要至少一次命令行操作，零基础用户建议找整合好的 Docker 镜像
• 你担心封号风险——任何自动化脚本都有被封的可能，Faker2 不提供“防封”保证

一句话结论：Faker2 是京东自动化脚本的“全家桶”，适合有青龙面板基础、想一站式搞定京东日常任务的用户。如果你只需要签到，找单文件就够了。

最后提醒：所有脚本仅供学习研究，请勿用于商业用途。定期更新 Cookie，避免失效后任务空跑。

项目信息

参考链接

• GitHub 仓库