voglerr/free-games-claimer

free-games-claimer 镜像文档

镜像概述

free-games-claimer 是一个基于Docker的自动化工具，旨在帮助用户无需手动操作即可在Epic Games Store和Amazon Prime Gaming平台上检测并领取免费游戏，节省用户跟踪和获取免费游戏资源的时间成本。

核心功能与特性

• 多平台支持：同时兼容Epic Games Store和Amazon Prime Gaming两大平台
• 全流程自动化：自动完成账号登录、免费游戏检测、游戏领取等操作
• 灵活调度：支持通过cron表达式配置定时运行，确保不错过限时免费游戏
• 通知集成：可通过***、***等渠道发送领取结果通知
• 无头运行：基于Playwright框架，支持无头浏览器模式，适合服务器环境部署
• 会话持久化：自动保存登录会话，减少重复验证操作
• 多账号管理：支持配置多个游戏账号，批量领取免费游戏

使用场景与适用范围

• 游戏收藏爱好者：希望自动收集所有平台免费游戏的用户
• 时间紧张用户：无时间定期手动检查和领取免费游戏的玩家
• 多账号持有者：需要管理多个游戏账号并批量领取福利的用户
• 服务器运维者：希望在家庭服务器或云服务器中长期部署自动化任务的用户

使用方法与配置说明

Docker 运行命令

直接通过Docker命令启动容器，需配置必要的账号信息和运行参数：

bash
docker run -d \
  --name free-games-claimer \
  -e EPIC_EMAIL="your-epic-email@example.com" \
  -e EPIC_PASSWORD="your-epic-password" \
  -e PRIME_EMAIL="your-prime-email@example.com" \
  -e PRIME_PASSWORD="your-prime-password" \
  -e SCHEDULE="0 12 * * *" \
  -e NOTIFY_TELEGRAM_CHAT_ID="your-telegram-chat-id" \
  -e NOTIFY_TELEGRAM_BOT_TOKEN="your-telegram-bot-token" \
  -v ./free-games-config:/app/config \
  docker.xuanyuan.run/vogler/free-games-claimer

Docker Compose 配置

创建docker-compose.yml文件实现更便捷的部署和管理：

yaml
version: '3.8'
services:
  free-games-claimer:
    image: docker.xuanyuan.run/vogler/free-games-claimer
    container_name: free-games-claimer
    restart: unless-stopped
    environment:
      # Epic Games Store 配置（可选，仅使用Prime时可不填）
      - EPIC_EMAIL=your-epic-email@example.com
      - EPIC_PASSWORD=your-epic-password
      # Amazon Prime Gaming 配置（可选，仅使用Epic时可不填）
      - PRIME_EMAIL=your-prime-email@example.com
      - PRIME_PASSWORD=your-prime-password
      # 定时运行配置（cron表达式，默认立即运行一次）
      - SCHEDULE=0 12 * * *  # 每天中午12点执行
      # 通知配置（可选）
      - NOTIFY_TELEGRAM_CHAT_ID=your-telegram-chat-id
      - NOTIFY_TELEGRAM_BOT_TOKEN=your-telegram-bot-token
      - NOTIFY_DISCORD_WEBHOOK=https://discord.com/api/webhooks/xxx
      # 运行参数（可选）
      - HEADLESS=true  # 启用无头模式
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    volumes:
      - ./free-games-config:/app/config  # 持久化配置和会话数据

环境变量详细说明

数据持久化与配置管理

通过挂载./free-games-config目录到容器内/app/config路径，可实现：

• 保存账号登录会话，避免每次运行重新验证 | 存储已领取游戏记录，防止重复领取 | 保留运行日志和配置参数

配置目录无需手动修改，工具会自动维护其中的会话文件和状态记录。

运行流程说明

1. 初始化阶段：容器启动后加载配置，检查账号信息和运行参数
2. 登录验证：自动登录配置的Epic和Prime账号（支持两步验证的账号需首次手动完成验证）
3. 游戏检测：扫描平台当前可领取的免费游戏列表（含限时免费和永久免费）
4. 自动领取：对未领取的游戏执行领取操作，记录领取状态
5. 结果通知：通过配置的通知渠道发送本次领取结果（成功/失败/跳过的游戏列表）
6. 定时等待：如配置SCHEDULE，则按设定时间间隔重复执行上述流程

注意事项

• 首次运行含两步验证的账号时，可能需要手动干预完成验证流程
• 建议使用专用的"游戏领取账号"，避免与主账号安全风险关联
• 部分平台可能会调整页面结构导致领取失败，需关注镜像更新以获取兼容性修复
• 运行日志可通过docker logs free-games-claimer命令查看，用于排查问题