基于 Docker 的 Epic Games 免费游戏自动领取工具，支持多账号托管、智能验证码识别、错峰调度。
| 功能 | 说明 |
|---|---|
| 自动驾驶 | 一键启动，自动完成登录、验证码识别、免费游戏领取 |
| Cookie 托管 | 首次登录后保存 Cookie，后续尽量复用登录态 |
| AI 验证码 | 使用 SiliconFlow 视觉模型识别 hCaptcha |
| 错峰调度 | 随机延迟执行，降低多账号同时触发风控概率 |
| 防滥用保护 | IP 限流 + 恶意账号检测 |
| 一键部署 | Docker Compose 本地编译，支持 x86_64 / ARM64 |
适用于云服务器、VPS、Linux 主机：
curl -fsSL https://raw.githubusercontent.com/10000ge10000/epic-kiosk/main/install.sh | bash脚本功能：
- 自动检测系统架构（x86_64 / ARM64）
- 自动安装 Docker 和 Docker Compose
- 交互式引导配置 SiliconFlow API Key
- 自动克隆项目并启动服务
首次部署约需 5-10 分钟。
适用于已有 Docker 环境的 Linux / macOS / Windows 主机。
1. 克隆项目
git clone https://github.com/10000ge10000/epic-kiosk.git
cd epic-kiosk2. 配置 SiliconFlow API Key
推荐使用 .env，不要把真实 key 写进 docker-compose.yml：
cp .env.example .env
nano .env.env 示例：
API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
API_BASE_URL=https://api.siliconflow.cn/v1SiliconFlow key 获取地址：
通过该分享链接注册并完成认证后，邀请双方可获得 16 元代金券。登录 SiliconFlow 后进入 API Key 管理页，创建并复制 sk- 开头的 key。
3. 启动
docker compose up -d --build首次启动约需 5-10 分钟。
- 默认 Web 端口是
18000，访问地址为http://服务器IP:18000。 - 默认 AI 提供商是 SiliconFlow，接口地址为
https://api.siliconflow.cn/v1。 API_KEY必须放在.env，.env已被.gitignore忽略。- 旧版
API_KEY/API_BASE_URL仍可兼容读取，但新部署不要再使用旧变量名。 - WARP 容器负责访问 Epic Games；如果 Epic 风控严重，可能需要更稳定的住宅代理或更换出口。
- 输入 Epic 邮箱和密码。
- 点击「启动引擎」。
- 系统自动处理登录、验证码和免费游戏领取。
- 点击「资产清单」Tab 查看已领取游戏。
- 点击游戏封面跳转 Epic 商店。
- 输入密码后点击红色删除按钮。
- 系统将清除数据库记录和本地 Cookie 数据。
当前默认配置基于 SiliconFlow 实测结果：
| 类型 | 主模型 | 备用模型 | 用途 |
|---|---|---|---|
| 主力文本 | deepseek-ai/DeepSeek-V4-Flash |
deepseek-ai/DeepSeek-V4-Pro |
页面判断、流程决策、结构化文本输出 |
| 验证码视觉 | Qwen/Qwen3-VL-32B-Instruct |
Qwen/Qwen3-VL-30B-A3B-Instruct |
hCaptcha 图像识别 |
相关环境变量：
API_PROVIDER=siliconflow
API_BASE_URL=https://api.siliconflow.cn/v1
PRIMARY_MODEL=deepseek-ai/DeepSeek-V4-Flash
PRIMARY_MODEL_FALLBACK=deepseek-ai/DeepSeek-V4-Pro
CAPTCHA_MODEL=Qwen/Qwen3-VL-32B-Instruct
CAPTCHA_MODEL_FALLBACK=Qwen/Qwen3-VL-30B-A3B-Instruct智能切换机制：
- 验证码连续调用超过阈值后自动切换备用视觉模型。
- API 调用异常时自动使用对应备用模型重试一次。
- 视觉请求和文本请求会按是否包含图片自动选择不同模型。
- 验证码失败会触发 WARP 换 IP，并将账号放入延迟队列，默认 15 分钟后重试，最多 2 次。
- Docker 容器日志和应用文件日志均按 1 MB 自动轮转，避免长期运行撑满磁盘。
SiliconFlow hosted API 的额度和价格以 SiliconFlow 当前账号页面为准。不同账号、地区、模型和活动政策可能不同，部署前应在 SiliconFlow 控制台确认可用额度。
epic-kiosk/
├── app/ # 核心代码
│ ├── main.py # FastAPI 后端
│ ├── deploy.py # 浏览器自动化
│ ├── settings.py # 模型/API 配置与 OpenAI 兼容补丁
│ └── services/ # 业务逻辑
├── templates/ # 前端页面
├── data/ # 持久化数据
│ ├── images/ # 游戏海报
│ ├── user_data/ # 用户 Cookie / 浏览器 profile
│ └── logs/ # 日志文件
├── worker.py # Redis 队列 Worker
├── docker-compose.yml # 容器编排
├── install.sh # 一键部署脚本
├── Dockerfile # Web 镜像
└── Dockerfile.worker # Worker 镜像
- 1 分钟内最多 3 次请求。
- 超限后临时封禁 1 小时。
- 同一 IP 提交超过 5 个不同账号将永久封禁。
- 同一邮箱任务互斥。
- 已存储账号需验证密码。
- 自动清理浏览器缓存。
- 不要把
API_KEY写进 Git 跟踪文件。 - 不要把
sk-key 发到公开聊天、Issue、日志或截图里。 - 如果 key 泄露，应立即在 SiliconFlow 后台删除并重新生成。
已部署用户升级到最新版本：
cd /epic-kiosk
git pull
docker compose up -d --build仅升级 Worker：
docker compose build worker && docker compose up -d workerQ: 日志提示 未配置 API_KEY？
A: 检查 .env 是否存在，且包含 API_KEY=sk-...。修改后执行 docker compose up -d worker。
Q: SiliconFlow API 返回 401 / 403？
A: key 无效、过期、权限不足或账号额度不可用。通过 SiliconFlow 分享链接 登录后进入 API Key 管理页重新生成 key。
Q: SiliconFlow API 返回 404？
A: 通常是模型 ID 不存在或该账号无权使用该模型。先通过 SiliconFlow 分享链接 登录控制台确认模型可用。
Q: 验证码一直失败？
A: 先检查 worker 日志中是否出现 调用 OpenAI 兼容 API、模型名和 API 错误码；如果没有 API 错误，重点排查 WARP 出口 IP、Epic 风控、验证码类型是否变化。
Q: 按钮显示 Requires Base Game？
A: 该游戏需要先拥有基础游戏，属于 DLC，跳过即可。
Q: 日志显示「游戏已在库中」？
A: 该账号已领取过此游戏，正常现象。
# Worker 日志（实时）
docker logs epic-worker --tail 50 -f
# 日志文件（按日期分类）
ls data/logs/
# 查看当天运行时日志
cat data/logs/runtime-$(date +%Y-%m-%d).log | tail -50
# 查看当天错误日志
cat data/logs/error-$(date +%Y-%m-%d).log# 仅重新构建 Worker
docker compose build worker && docker compose up -d worker
# 重新构建所有服务
docker compose build --no-cache && docker compose up -d注意：部分旧文档可能仍保留历史 SiliconFlow 配置说明，当前 README 和
.env.example以 SiliconFlow 配置为准。
- 原项目：QIN2DIM/epic-awesome-gamer
- AI 服务：SiliconFlow 分享链接
本项目仅供学习和技术研究使用。请合理使用，遵守 Epic Games 服务条款。开发者不对因使用本项目导致的任何损失承担责任。
Created by 一万 | 公益站点：epic.910501.xyz