3.1 核心特性#

• 🚀 不需要真的看直播 —— 通过发送 Twitch 官方 GraphQL 观看事件来获取掉宝进度，完全不播放视频流，不消耗带宽
• 🔍 自动发现活动 —— 自动扫描并检测新上线的掉宝活动，不用你去翻活动页面
• ⚙️ 智能切换频道 —— 当前频道挂完了或者下线了，自动切换到最优的替代频道
• 💾 持久登录 —— OAuth Token 保存在本地，重启容器不需要重新登录
• 🖥️ Web 控制台 —— 在浏览器里查看挂机状态、选择游戏、管理活动，一目了然
• 🐳 Docker 一键部署 —— 官方提供现成镜像，一条命令启动

3.2 部署步骤#

前提条件：

• 一台能长期运行的设备（NAS、树莓派、云服务器、家里闲置电脑都行）
• 安装好 Docker
• 一个 Twitch 账号（记得在 Twitch Drops 设置页 关联你的游戏账号）

第一步：拉镜像并启动容器

1
docker pull rangermix/twitch-drops-miner:latest
2
docker run -d \
3
  --name twitch-drops \
4
  -p 8080:8080 \
5
  -v $(pwd)/data:/app/data \
6
  --restart unless-stopped \
7
  rangermix/twitch-drops-miner:latest

也可以用 Docker Compose（推荐，方便管理）：

1
services:
2
  twitch-drops-miner:
3
    image: rangermix/twitch-drops-miner:latest
4
    ports:
5
      - "8080:8080"
6
    volumes:
7
      - ./data:/app/data
8
    environment:
9
      - TZ=Asia/Shanghai
10
    restart: unless-stopped

第二步：登录 Twitch 账号

打开浏览器访问 http://你的IP:8080，点击登录按钮，按页面提示完成 Twitch OAuth 授权流程。授权成功后 Token 会自动保存，后续重启不需要重复登录。

第三步：选择要挖的游戏

Web 面板会自动列出当前正在进行的所有掉宝活动。你可以勾选感兴趣的游戏，也可以手动输入游戏名称添加。点击开始后，工具就自动进入挂机状态了。

第四步：关掉浏览器，该干嘛干嘛

之后的一切都是全自动的——挂机、切换频道、领取奖励。你只需要偶尔打开面板看看进度就行。

3.3 重要提醒#

• ⚠️ 挂机期间不要用同一个 Twitch 账号看直播 —— 同时在线可能导致观看进度不同步或冲突。想看直播的话，请用另一个账号。
• ⚠️ 务必在 drops/campaigns 页面确认你的 Twitch 账号已经关联了对应游戏的账号（比如 Steam、Epic 等），否则奖励发不到游戏里。
• 🌍 项目内置多语言支持，包括简体中文。

4.1 核心特性#

• 🧠 智能优先级调度 —— 不是随便挂一个直播间，而是根据掉宝类型、截止时间、观看进度等多维度自动排序，确保效率最大化
• 🎁 自动领取奖励 —— 检测到掉宝完成后自动 Claim，不会错过
• 🖥️ Web 控制面板 —— 可视化管理优先级列表，查看实时日志，手动启停
• 🍪 Cookie 登录 —— 无需输入账号密码，直接导入浏览器 Cookie 即可，安全方便
• 🐳 Docker 一键部署 —— 同时支持 x86 和 ARM 架构（树莓派也能跑）
• 👥 多账户支持 —— 同一台机器跑多个实例，每个实例独立互不干扰

4.2 部署步骤#

前提条件：

• Docker 已安装
• 一个 Kick 账号（必须已绑定 Steam，这是 Kick 掉宝的要求）
• 浏览器安装插件：Get cookies.txt LOCALLY（Chrome/Edge/Brave 均可安装）

第一步：获取 Kick 登录 Cookie

1. 在浏览器扩展商店搜索并安装 Get cookies.txt LOCALLY 插件
2. 用浏览器登录 kick.com，确保账号已经绑定了 Steam
3. 在 kick.com 的任意页面上，点击插件图标，选择”导出全部 Cookie”，保存为 cookies.txt 文件

💡 Cookie 仅保存在本地，不会上传到任何外部服务器，安全有保障。

第二步：启动容器

1
docker run -d \
2
  --name kick-miner \
3
  -p 3200:8080 \
4
  -v /你的数据路径/data:/app/data \
5
  -e TZ=Asia/Shanghai \
6
  --restart unless-stopped \
7
  hugoabu/kick-miner:1.0.1

Docker Compose 版本：

1
services:
2
  kick-miner:
3
    image: hugoabu/kick-miner:1.0.1
4
    ports:
5
      - "3200:8080"
6
    volumes:
7
      - ./data:/app/data
8
    environment:
9
      - TZ=Asia/Shanghai
10
    restart: unless-stopped

第三步：导入 Cookie 并开始运行

打开 http://你的IP:3200，在 Web 面板中粘贴你刚才导出的 cookies.txt 内容，点击导入。导入成功后，工具就自动开始挂机了。

在面板里你可以：

• 查看当前正在挂的频道和掉宝进度
• 设置优先关注的主播
• 查看实时运行日志
• 手动暂停或切换

4.3 多账户运行方案#

如果你有多个 Kick 账号，每个账号用独立的容器和端口即可：

1
# 账户 A —— 端口 3200
2
docker run -d --name kick_acc_a -p 3200:8080 \
3
  -v /data/kick_a:/app/data -e TZ=Asia/Shanghai \
4
  --restart unless-stopped hugoabu/kick-miner:1.0.1
5

6
# 账户 B —— 端口 3201
7
docker run -d --name kick_acc_b -p 3201:8080 \
8
  -v /data/kick_b:/app/data -e TZ=Asia/Shanghai \
9
  --restart unless-stopped hugoabu/kick-miner:1.0.1

4.4 智能优先级逻辑#

Kick Miner Pro 最大的亮点就是它的调度算法，不是傻瓜式随机挂机：

1. 你手动指定的优先主播 → 最高优先级，永远先挂
2. Team 掉宝 → 即将到期的优先 > 观看剩余时间最短的优先 > 普通 Team 掉宝
3. General 掉宝 → 自动发现并跟进
4. 随机主播兜底 → 以上都没有就随便挂一个，保持在线状态

这套逻辑确保你不会因为忘了切频道而错过即将到期的掉宝。

5.1 网络代理配置#

Twitch 和 Kick 在国内无法直连，需要通过代理访问。Docker 容器支持通过环境变量配置代理：

1
docker run -d \
2
  -e HTTP_PROXY=http://你的代理地址:端口 \
3
  -e HTTPS_PROXY=http://你的代理地址:端口 \
4
  ...  # 其他参数同上

5.2 硬件资源占用#

两个工具都非常轻量——不需要 GPU，不播放视频流，内存占用通常在 100MB 以内。一台闲置的旧笔记本、树莓派、NAS 或者最便宜的云服务器都能轻松跑起来。

5.3 推荐部署方案#