小黑盒青龙自动签到完整指南：从拉取脚本到日志排查全解析

方案一：使用 AutoSign 项目（推荐）#

第一步：拉取小黑盒签到脚本#

1. 登录青龙面板

2. 点击左侧「订阅管理」

3. 点击右上角「新建订阅」按钮

4. 填写以下信息：

表格

1. 点击「确定」保存

2. 点击运行按钮执行一次订阅

第二步：获取小黑盒 Cookie（关键步骤）#

重要说明： 小黑盒需要从移动端抓包获取 Cookie，网页版可能无法获取完整参数。

方法：使用手机抓包工具

1. 在手机上安装抓包工具（推荐：Packet Capture、HttpCanary 或 Charles）

2. 打开抓包工具，开始抓包

3. 打开小黑盒 APP，登录账号

4. 在小黑盒中进行任意操作（如浏览帖子、签到页面）

5. 停止抓包，在抓包记录中搜索关键词 xiaoheihe 或 heybox

6. 找到包含登录信息的请求，复制完整的 Cookie

Cookie 中需要包含的关键参数：

• heybox_id：用户唯一标识（必填）

• imei：设备标识（建议填写，降低封号风险）

• 完整的 Cookie 字符串

Cookie 格式示例：

1
heybox_id=123456789; imei=865432109876543; device_id=abc123; session_id=xyz789; ...

第三步：配置小黑盒环境变量#

1. 回到青龙面板

2. 点击左侧「环境变量」

3. 点击「新建变量」

4. 填写以下信息：

表格

1. 点击「确定」保存

多账号配置：

如果有多个小黑盒账号，可以创建多个 XIAOHEIHE_COOKIE 变量，或者在一个变量中用换行符分隔（具体格式需参考脚本说明）。

第四步：查找并运行签到脚本#

1. 点击左侧「定时任务」

2. 刷新页面，查找与小黑盒相关的脚本

3. 通常脚本名称包含 xiaoheihe 或 小黑盒 字样

4. 点击脚本右侧的「运行」按钮测试

第五步：查看运行日志#

1. 点击脚本右侧的「日志」按钮

2. 查看执行结果

3. 成功的日志会显示类似以下内容：

   • ✅ 签到成功，获得 XX 盒币

   • ✅ 今日已签到

4. 如果失败，查看错误信息并根据提示调整

方案二：手动配置 AutoSign 项目（更灵活）#

如果你的青龙面板已经拉取了 AutoSign 项目，但脚本没有自动出现在定时任务中，可以手动配置：

第一步：进入项目目录#

SSH 连接到服务器，执行以下命令：

1
# 进入青龙容器
2
docker exec -it qinglong bash
3

4
# 查看项目是否已拉取
5
ls /ql/data/repo/ | grep AutoSign
6

7
# 如果存在，进入目录
8
cd /ql/data/repo/clover1314_AutoSign
9

10
# 查看文件
11
ls

第二步：创建配置文件#

1
# 复制示例配置文件
2
cp default.config.yaml config.yaml
3

4
# 编辑配置文件
5
vi config.yaml

在配置文件中填写小黑盒信息：

1
xiaoheihe:
2
  cookie: "你的完整Cookie字符串"
3
  heybox_id: "你的heybox_id（从Cookie中提取）"
4
  imei: "设备标识（可选，但建议填写）"

保存并退出编辑器。

第三步：安装 Python 依赖#

1
# 在容器内执行
2
pip3 install requests
3
pip3 install pyyaml

第四步：手动测试运行#

1
# 测试小黑盒签到
2
python3 xiaoheihe_checkin.py

第五步：在青龙面板中创建定时任务#

1. 回到青龙面板 Web 界面

2. 点击「定时任务」→「新建任务」

3. 填写以下信息：

表格

1. 点击「确定」保存

方案三：使用通用签到工具（check 项目）#

如果你已经在青龙面板中部署了之前提到的 check 项目，可以直接用它来管理小黑盒签到。

第一步：拉取 check 项目（如果还没有）#

订阅配置：

• 链接： https://gitcode.com/gh\_mirrors/check5/check.git

• 白名单： ck_|oc_

• 黑名单： checksend|utils

• 定时规则： 0 0 7 * * *

第二步：初始化配置#

SSH 连接到服务器，执行：

1
# 青龙 v2.12+ 版本
2
cd /ql/data/repo/yuxian158_check && python3 utils.py
3

4
# 青龙 v2.12- 版本
5
cd /ql/repo/yuxian158_check && python3 utils.py

执行后会自动生成 check.toml 配置文件。

第三步：配置小黑盒账号#

找到生成的配置文件（通常在 /ql/data/config/ 目录下），编辑 check.toml：

1
[[XIAOHEIHE]]
2
cookie = "你的完整Cookie字符串"
3
heybox_id = "你的heybox_id"
4
imei = "设备标识（可选）"

多账号配置示例：

1
[[XIAOHEIHE]]
2
cookie = "账号1的Cookie"
3
heybox_id = "账号1的heybox_id"
4
imei = "账号1的imei"
5

6
[[XIAOHEIHE]]
7
cookie = "账号2的Cookie"
8
heybox_id = "账号2的heybox_id"
9
imei = "账号2的imei"

第四步：运行签到#

手动测试：

1
cd /ql/data/repo/yuxian158_check && python3 main.py

设置定时任务：

在青龙面板中创建任务：

• 名称：小黑盒统一签到

• 命令： cd /ql/data/repo/yuxian158_check && python3 main.py

• 定时规则： 0 0 8 * * *

常见问题排查#

问题1：脚本提示”Cookie格式错误”#

可能原因：

• Cookie 复制不完整

• 缺少必要参数（heybox_id）

• Cookie 已过期

解决方案：

1. 重新抓包获取完整 Cookie

2. 确保 Cookie 包含 heybox_id 参数

3. 检查 Cookie 是否在有效期内

问题2：提示”heybox_id不能为空”#

可能原因：

• Cookie 中没有包含 heybox_id

• 配置文件中未单独配置 heybox_id

解决方案：

1. 从 Cookie 字符串中提取 heybox_id 的值

2. 在环境变量或配置文件中单独添加 heybox_id

问题3：签到成功但未获得盒币#

可能原因：

• 今日已签到过

• 账号被限制

• 签到规则变更

解决方案：

1. 查看 API 返回的具体信息

2. 尝试在 APP 中手动签到验证

3. 等待第二天再次测试

问题4：找不到小黑盒脚本#

可能原因：

• 订阅未成功拉取

• 脚本名称不是 xiaoheihe

• 需要手动创建脚本

解决方案：

1. 查看订阅日志，确认是否拉取成功

2. 在脚本管理中搜索关键词

3. 使用手动配置方案

小黑盒 Cookie 获取详细教程#

使用 HttpCanary 抓包（安卓）#

1. 从应用商店下载安装 HttpCanary

2. 打开应用，授予相关权限

3. 点击右上角”+“图标开始抓包

4. 打开小黑盒 APP，完成登录

5. 在小黑盒中进行操作（浏览帖子、点击签到按钮）

6. 返回 HttpCanary，停止抓包

7. 在列表中查找 xiaoheihe.cn 或 heybox 相关请求

8. 点击请求，查看「Headers」

9. 找到「Cookie」字段，复制完整内容

使用 Charles 抓包（跨平台）#

1. 电脑和手机连接同一 Wi-Fi

2. 电脑安装 Charles 并开启代理

3. 手机设置 Wi-Fi 代理，指向电脑 IP 和 Charles 端口（默认 8888）

4. 在 Charles 中安装 SSL 证书

5. 手机访问 chls.pro/ssl 安装证书

6. 打开小黑盒 APP，进行操作

7. 在 Charles 中找到小黑盒的请求

8. 查看请求头中的 Cookie 信息

定时规则建议#

小黑盒签到的最佳时间建议：

• 推荐时间： 每天早上 8:00（ 0 0 8 * * *）

• 备选时间： 每天早上 7:00 或 9:00

• 避免时间： 深夜或凌晨（可能触发风控）

多个签到任务的时间安排示例：

• 6:00 - Bilibili 签到

• 7:00 - 多平台统一签到（含小黑盒）

• 8:00 - 京东签到

• 9:00 - 微博签到

安全建议#

1. 不要分享 Cookie： Cookie 相当于你的账号密码，请妥善保管

2. 定期更换： 建议每月重新获取一次 Cookie

3. 避免过度频繁： 不要频繁手动运行签到脚本

4. 监控账号状态： 定期查看小黑盒账号是否有异常

5. 使用子账号： 如果有条件，使用小号进行测试