解决epicgames-freegames-node项目中的404错误配置问题

在使用epicgames-freegames-node项目时，用户可能会遇到404错误页面。这种情况通常是由于配置文件中的webPortalConfig.baseUrl设置不正确导致的。本文将详细解释如何正确配置该参数以避免此类问题。

问题现象分析

当用户启动Docker容器后，通过邮件接收到的链接访问时出现404错误页面。这表明容器虽然正常运行，但Web服务无法正确响应请求。核心问题在于配置文件中webPortalConfig.baseUrl的设置。

关键配置参数详解

webPortalConfig.baseUrl参数需要指向容器实际运行的地址和端口。常见错误包括：

1. 使用外部网站地址（如Epic Games商店地址）
2. 未指定端口号
3. 使用了HTTPS协议而非HTTP

正确配置示例

以下是经过验证的正确配置片段：

"webPortalConfig": {
  "baseUrl": "http://[服务器内网IP]:3055"
}

其中：

• [服务器内网IP]应替换为运行容器的主机内网IP地址
• 3055是默认的容器服务端口（根据实际映射端口调整）

完整配置建议

建议用户保留完整的配置文件结构，仅修改必要参数。以下是一个推荐的最小化配置模板：

{
  "cronSchedule": "0 0,6,12,18 * * *",
  "logLevel": "info",
  "webPortalConfig": {
    "baseUrl": "http://192.168.1.100:3055"
  },
  "accounts": [
    {
      "email": "[e-mail]"
    }
  ],
  "notifiers": [
    {
      "type": "email",
      "smtpHost": "smtp.example.com",
      "smtpPort": 587,
      "emailSenderAddress": "[e-mail]",
      "emailRecipientAddress": "[e-mail]",
      "auth": {
        "user": "smtp-user",
        "pass": "smtp-password"
      }
    }
  ]
}

配置验证步骤

1. 确认容器端口映射正确（主机3055端口映射到容器3055端口）
2. 检查防火墙设置，确保端口可访问
3. 使用docker logs [容器名]命令查看容器日志
4. 在服务器本地通过curl测试服务响应

进阶建议

对于高级用户，还可以考虑：

1. 使用反向代理（如Nginx）处理HTTPS
2. 配置域名解析
3. 设置容器自动重启策略
4. 定期检查日志文件监控运行状态

通过以上配置和验证步骤，用户应该能够解决404错误问题，并确保epicgames-freegames-node服务正常运行。