Epic Games Store免费游戏自动领取工具是一个功能强大的开源项目，能够自动登录Epic Games Store平台，发现并获取每周免费提供的游戏。该项目通过发送预填好的结账链接，让用户在登录后即可完成购买流程，支持多账户管理、登录会话保持和计划任务运行。
项目地址: https://gitcode.com/gh_mirrors/ep/epicgames-freegames-node 项目架构与技术栈
该项目基于Node.js环境构建，使用TypeScript作为主要开发语言。核心依赖包括：
- Puppeteer: 用于自动化浏览器操作，模拟用户登录和游戏领取行为
- Express: 提供Web服务器功能，支持验证码解决页面
- Axios: 处理HTTP请求，与Epic Games API进行交互
- 多种通知服务: 支持邮件、Discord、即时通讯应用等多种通知方式
项目采用模块化设计，主要代码结构位于src目录下，包含通用组件、接口定义、通知服务、自动化操作等多个模块。
核心功能详解
自动化登录系统
该工具支持两种登录方式：设备码认证和Cookie导入。设备码认证通过Epic Games的官方设备认证流程，而Cookie导入则允许用户直接从浏览器导出会话Cookie，实现快速登录。
智能游戏发现机制
工具能够自动扫描Epic Games Store平台，识别当前可免费领取的游戏。通过分析API响应数据，准确判断游戏状态和领取条件。
多账户管理
支持同时配置多个Epic Games账户，每个账户可以独立设置通知偏好和运行计划。这一功能特别适合游戏收藏家或家庭用户使用。
配置与部署实战
JSON配置文件详解
配置文件支持JSON5语法，允许使用注释和尾随逗号。主要配置项包括：
- runOnStartup: 容器启动时是否立即运行
- cronSchedule: 定时任务调度，默认每6小时运行一次
- logLevel: 日志级别设置
- accounts: 账户配置列表
- notifiers: 通知服务配置
Docker部署方案
项目提供完整的Docker支持，可通过以下命令快速部署：
docker run -d -v /my/host/dir/:/usr/app/config:rw -p 3000:3000 -m 2g ghcr.io/claabs/epicgames-freegames-node:latest
环境变量配置
除了JSON配置外，项目还支持通过环境变量进行配置。关键环境变量包括：
- EMAIL: 账户邮箱地址
- RUN_ON_STARTUP: 启动时运行
- BASE_URL: Web服务器基础URL
- SMTP_HOST: 邮件服务器地址
通知系统配置指南
邮件通知配置
邮件通知需要配置SMTP服务器信息，包括主机地址、端口、发件人信息等。支持TLS加密连接，确保通信安全。
Discord集成
通过配置Webhook URL，可以将游戏领取状态实时推送到Discord频道。支持用户和角色提及功能，确保重要通知能够及时送达。
其他通知方式
项目还支持即时通讯应用、Pushover、Gotify、Home Assistant等多种通知服务，满足不同用户的需求偏好。
常见问题解决方案
依赖安装问题
问题现象: 首次运行提示依赖库缺失
解决方案:
- 确保Node.js 22或更高版本已安装
- 在项目根目录执行
npm install命令 - 验证安装结果并启动项目
配置文件加载异常
排查要点: 配置文件路径与格式验证
解决步骤:
- 确认config.json位于/usr/app/config目录
- 使用JSON验证工具检查语法正确性
- 环境变量配置双重确认
- 重启服务并监控日志输出
通知发送失败
配置检查清单:
- 邮件通知: 验证SMTP参数配置
- Discord通知: 确认Webhook URL有效性
- 网络连通性测试
高级使用技巧
Cookie导入优化
对于设备码认证存在问题的用户，可以通过Cookie导入方式实现快速登录：
- 在浏览器中登录Epic Games Store并勾选"记住我"
- 使用EditThisCookie浏览器扩展导出Cookie
- 在配置目录创建对应邮箱的Cookie文件
- 容器启动后自动转换Cookie格式
性能调优建议
- 设置内存限制为2GB，防止Chromium进程内存泄漏
- 合理配置定时任务频率，避免频繁请求
- 使用Debian镜像解决Chromium启动问题
版本迁移注意事项
从v4版本升级到v5版本时需要注意以下变更：
- cronSchedule: 默认值改为每6小时运行一次
- 移除功能: 密码登录、TOTP验证、自动化购买等
- 配置项更新: 使用新的配置结构替换已弃用的选项
安全与隐私保护
项目在设计时充分考虑了用户隐私和安全：
- 所有配置信息本地存储
- 支持加密通信协议
- 会话信息定期刷新
通过本指南，用户可以全面掌握Epic Games Store免费游戏自动领取工具的使用方法，轻松实现自动化游戏获取，享受便捷的游戏收藏体验。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
