EPIC 免费人

🍷 Gracefully claim weekly free games from Epic Store.

Introduction 👋

Epic 免费人 帮助玩家优雅地领取免费游戏。内置 hcaptcha-challenger AI 模块，直面人机挑战。

Features

Component	Support
hCaptcha Solver	✅
Docker Compose	✅
Persistent context @multi-user	✅
Epicgames DLC	🚧
2FA OTP support	🚧

Documentation

🚀 快速开始

我们推荐使用 Docker Compose 进行一键部署，这是最简单、最稳定的运行方式。

1. 克隆代码仓库

首先，将本仓库克隆至你的本地环境，并进入 docker 工作目录：

git clone https://github.com/QIN2DIM/epic-awesome-gamer.git
cd epic-awesome-gamer/docker

2. 配置环境变量

接下来，配置你的专属环境变量。我们提供了一份 .env.example 模板，请以它为蓝本创建 .env 文件：

cp .env.example .env

随后，使用你偏爱的编辑器（如 vim 或 nano）调整 .env 文件中的配置项。各项配置的详细说明，请参考下文的 ⚙️ 环境变量 部分。

3. 启动服务

一切就绪，启动容器！我们提供了一个便捷的启动脚本：

# 赋予脚本执行权限
chmod +x ./start.sh

# 启动服务
./start.sh

当然，你也可以直接使用 docker compose 命令进行部署，这能让你更好地控制服务生命周期。项目的编排文件位于 docker-compose.yaml。

# 后台启动服务
docker compose up -d

☁️ 其他部署方式（CI/CD）

如果你希望将 epic-awesome-gamer 集成到 GitHub Actions 或 GitLab CI 等自动化工作流中，完全没问题！

本项目核心逻辑清晰，稍作调整即可轻松适配各类云端定时任务。欢迎动手能力强的朋友们探索与分享！

⚙️ 环境变量

以下是项目运行所必需的环境变量，请确保每一项都已正确配置，否则程序将无法启动。

环境变量	required	说明
EPIC_EMAIL	YES	你的 Epic 游戏账号。 ⚠️ 注意：请预先禁用该账户的二步验证（2FA）。
EPIC_PASSWORD	YES	你的 Epic 游戏密码。 ⚠️ 注意：同上，请确保已禁用二步验证。
GEMINI_API_KEY	YES	用于接入 Google Gemini Pro Vision 多模态大模型，以应对登录过程中可能出现的人机验证（hCaptcha）。 你可以从 Google AI Studio 免费获取，其提供的免费额度足以支撑日常使用。

Tip

其他环境变量主要用于微调 hCaptcha Challenger 的内部行为，通常情况下，你无需关心或修改它们，保持默认即可。

🖼️ 项目展示 (Gallery)

这里展示了一些项目在早期开发阶段的运行截图，记录了它曾经的“全盛时期”。

由于目前维护重心已转向核心逻辑的稳定与优化，此处的展示内容可能略显陈旧。我们热烈欢迎社区伙伴通过 Pull Request 提交更棒的截图或 GIF 动图，共同完善这一部分！

👉 点击查看项目演示 (Notion)