使用Docker Compose部署free-games-claimer项目的完整指南

free-games-claimer是一个自动化工具，可以帮助用户自动领取Epic Games和GOG平台上的免费游戏。本文将详细介绍如何使用Docker Compose来部署和运行这个项目。

项目概述

free-games-claimer项目通过容器化技术实现了一个自动化解决方案，主要功能包括：

• 自动登录Epic Games和GOG平台
• 自动检测并领取免费游戏
• 提供Web界面方便用户操作和监控

Docker Compose配置详解

基础服务配置

services:
  free-games-claimer:
    container_name: fgc
    image: ghcr.io/vogler/free-games-claimer
    build: .

这部分定义了核心服务：

• container_name: fgc：为容器指定一个简短的名称，方便管理
• image：指定了容器镜像的来源
• build: .：表示如果本地没有镜像，可以从当前目录构建

端口映射配置

ports:
  - "6080:6080" # noVNC (browser-based VNC client)

项目提供了两种访问方式：

1. VNC服务器端口5900（默认注释）
2. noVNC端口6080（浏览器直接访问）

建议使用6080端口，因为它提供了基于浏览器的VNC客户端，无需额外安装VNC查看器。

数据持久化

volumes:
  - fgc:/fgc/data

使用Docker卷fgc将容器内的/fgc/data目录持久化，确保：

• 配置信息不会丢失
• 登录状态可以保持
• 运行日志可以长期保存

环境变量配置

environment:
  # - EMAIL=foo@bar.org
  # - NOTIFY='message://...'

这些是可选的配置项：

• EMAIL：设置通知接收邮箱
• NOTIFY：配置消息通知（需要消息机器人token）

部署步骤

1. 准备环境：

   • 确保已安装Docker和Docker Compose
   • 克隆项目到本地

2. 配置修改：

   • 取消注释并填写必要的环境变量
   • 根据需要调整端口映射

3. 启动服务：

   docker compose up
   

   或使用后台模式：

   docker compose up -d
   

4. 访问服务：

   • 打开浏览器访问http://localhost:6080
   • 通过Web界面进行初始设置

使用建议

1. 安全性：

   • 不建议将6080端口直接暴露在公网
   • 如需远程访问，建议配置专用网络或SSH隧道

2. 维护：

   • 定期检查容器日志：docker logs fgc
   • 更新镜像：docker compose pull

3. 自定义：

   • 可以通过修改command参数来指定只运行特定平台的任务
   • 例如：command: bash -c "node epic-games"

常见问题

1. 端口冲突：

   • 如果6080端口被占用，可以修改为其他端口，如8080:6080

2. 登录问题：

   • 确保在第一次运行时通过Web界面完成平台登录
   • 登录状态会保存在持久化卷中

3. 性能考虑：

   • 项目需要浏览器环境运行，建议分配足够内存
   • 可在docker-compose.yml中添加资源限制

通过本文的指导，您应该能够顺利部署和使用free-games-claimer项目来自动领取免费游戏。这种容器化的解决方案既方便又可靠，适合长期运行。