Epic Games Store免费游戏自动领取工具深度解析与实战指南

Epic Games Store免费游戏自动领取工具是一个功能强大的开源项目，能够自动登录Epic Games Store平台，发现并获取每周免费提供的游戏。该项目通过发送预填好的结账链接，让用户在登录后即可完成购买流程，支持多账户管理、登录会话保持和计划任务运行。

【免费下载链接】epicgames-freegames-nodeAutomatically login and find available free games the Epic Games Store. Sends you a prepopulated checkout link so you can complete the checkout after logging in. Supports multiple accounts, login sessions, and scheduled runs.项目地址: 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等多种通知服务，满足不同用户的需求偏好。

常见问题解决方案

依赖安装问题

问题现象: 首次运行提示依赖库缺失

解决方案:

1. 确保Node.js 22或更高版本已安装
2. 在项目根目录执行npm install命令
3. 验证安装结果并启动项目

配置文件加载异常

排查要点: 配置文件路径与格式验证

解决步骤:

• 确认config.json位于/usr/app/config目录
• 使用JSON验证工具检查语法正确性
• 环境变量配置双重确认
• 重启服务并监控日志输出

通知发送失败

配置检查清单:

• 邮件通知: 验证SMTP参数配置
• Discord通知: 确认Webhook URL有效性
• 网络连通性测试

高级使用技巧

Cookie导入优化

对于设备码认证存在问题的用户，可以通过Cookie导入方式实现快速登录：

1. 在浏览器中登录Epic Games Store并勾选"记住我"
2. 使用EditThisCookie浏览器扩展导出Cookie
3. 在配置目录创建对应邮箱的Cookie文件
4. 容器启动后自动转换Cookie格式

性能调优建议

• 设置内存限制为2GB，防止Chromium进程内存泄漏
• 合理配置定时任务频率，避免频繁请求
• 使用Debian镜像解决Chromium启动问题

版本迁移注意事项

从v4版本升级到v5版本时需要注意以下变更：

• cronSchedule: 默认值改为每6小时运行一次
• 移除功能: 密码登录、TOTP验证、自动化购买等
• 配置项更新: 使用新的配置结构替换已弃用的选项

安全与隐私保护

项目在设计时充分考虑了用户隐私和安全：

• 所有配置信息本地存储
• 支持加密通信协议
• 会话信息定期刷新

通过本指南，用户可以全面掌握Epic Games Store免费游戏自动领取工具的使用方法，轻松实现自动化游戏获取，享受便捷的游戏收藏体验。

【免费下载链接】epicgames-freegames-nodeAutomatically login and find available free games the Epic Games Store. Sends you a prepopulated checkout link so you can complete the checkout after logging in. Supports multiple accounts, login sessions, and scheduled runs.项目地址: https://gitcode.com/gh_mirrors/ep/epicgames-freegames-node