ASFclaim

DockerHub 仓库 | Fork自 C4illin/ASFclaim | 感谢 @Mega349 提供原始***集成代码。

ASFclaim是一款设计用于在Steam上自动领取新的免费套餐的工具，需与启用IPC的***（ASF）配合使用。

工作原理

1. GitHub Gist集成：工具从指定的GitHub Gist（通过GIST_ID环境变量设置）获取免费Steam套餐列表。
   • 为避免GitHub API速率限制，可选择提供GITHUB_TOKEN环境变量，包含具有gist范围的GitHub个人访问令牌。
2. 已处理许可证：跟踪已处理的代码，避免重复领取同一套餐。
3. 领取流程：通过向ASF（***）发送命令来领取免费Steam套餐。
4. 间隔处理：工具每间隔（由ASF_CLAIM_INTERVAL定义，单位为小时）最多处理40个代码。确保工具以稳定速度领取可用套餐，避免触发Steam API限制。

重要：首次使用时，工具将从Gist列表底部开始处理，每间隔（由ASF_CLAIM_INTERVAL定义）最多领取40个代码。这使工具能够优先处理新添加的套餐，确保新添加的套餐尽快被处理，即使工具尚未遍历整个列表。这种方法有助于避免领取新套餐的延迟，并避免重复处理相同代码，尤其是扫描整个列表可能需要几天时间才能完成，之后才开始只处理新添加的套餐。

可选：*** Webhook集成

使用可选的Webhook集成在***上接收领取通知。

通知类型

成功领取游戏

!Success

领取包含DLC的套餐（显示或不显示状态）

!DLC Status !DLC No Status

领取包含多个结果且显示机器人名称的游戏套餐

!Multiple Results

当WEBHOOK_SHOWACCOUNTSTATUS设置为false时，机器人名称和状态将隐藏——适用于公共频道。

安装

baremetal 前提条件

1. 在ASF中启用IPC（如果密码非空，添加到.env）。
2. 安装Node.js（v18或更高版本）。

手动安装

bash
# 克隆仓库
git clone [***]

# 进入目录
cd ASFclaim

# 安装依赖
npm install

# 启动应用
node .

Docker安装

可使用预构建的Docker镜像运行ASFclaim：

拉取Docker镜像：

可从两个Docker镜像仓库中选择：

• Docker Hub：

  sh
  journeyover/asfclaim:latest
  

• GitHub Container Registry：

  sh
  ghcr.io/journeydocker/asfclaim:latest
  

Docker镜像标签

ASFclaim Docker镜像有三种主要标签格式，适用于不同场景：

• main（持续开发版）

  • 说明：main标签会自动更新以反映GitHub主分支上的最新提交。

  • 使用注意：不建议用于生产环境，因为它频繁更改，可能包含未测试或不稳定的更新。仅在贡献开发或需要最新功能和修复时使用main。

  • 更新频率：主分支每次有新提交时更新，是快速迭代的镜像。

  注意：拉取main标签可能引入破坏性更改或不稳定性，因为它代表正在进行的开发工作。

• latest（最新稳定版）

  • 说明：此标签指向ASFclaim的最新稳定版本。与main不同，latest标签仅使用稳定、经过全面测试的版本更新。
  • 使用建议：如果需要最新的稳定构建而无需指定特定版本，使用latest标签。适用于稳定性至关重要的生产环境。

• A.B.C.D（版本化发布）

  • 说明：版本化标签（如A.B.C.D）在特定发布版本冻结，发布后不会更新。
  • 使用建议：需要一致性并希望避免可能改变功能的更新时，使用版本化标签。这些标签适用于需要固定版本的生产环境。

Docker快速启动

sh
docker run -d \
  --name asfclaim \
  -e TZ=America/Chicago \
  -e ASF_PROTOCOL=http \
  -e ASF_HOST=localhost \
  -e ASF_PORT=1242 \
  -e ASF_COMMAND_PREFIX="!" \
  -e ASF_BOTS=asf \
  -e ASF_CLAIM_INTERVAL=3 \
  -e WEBHOOK_URL=none \
  -e WEBHOOK_ENABLEDTYPES="error;warn;success" \
  -e WEBHOOK_SHOWACCOUNTSTATUS=true \
  -v ./storage:/app/storage/ \
  journeyover/asfclaim:latest

Docker Compose

创建docker-compose.yml：

yaml
services:
    asfclaim:
        image: journeyover/asfclaim:latest
        environment:
            - TZ=America/Chicago
            - ASF_PROTOCOL=http
            - ASF_HOST=localhost
            - ASF_PORT=1242
            - ASF_COMMAND_PREFIX="!"
            - ASF_BOTS=asf
            - ASF_CLAIM_INTERVAL=3
            - WEBHOOK_URL=none  # 替换为你的*** Webhook URL
            - WEBHOOK_ENABLEDTYPES=error;warn;success  # 'info'可能过于冗长
            - WEBHOOK_SHOWACCOUNTSTATUS=true  # 设置为'false'在***中隐藏机器人名称
        volumes:
            - ./storage:/app/storage/

环境变量

外部资源

• Webhook机器人图标：ASF GitHub
• Webhook占位符图片：placehold.co
• 可领取套餐列表：GitHub: C4illin's Gist | Github: JourneyOver's Gist
• Steam API