tpill90/steam-lancache-prefill

镜像概述

steam-lancache-prefill 是一款专为Lancache设计的命令行工具，主要用于自动预填充Lancache缓存系统中的Steam游戏内容。通过该工具，用户可将指定的Steam游戏数据提前缓存到Lancache中，从而在后续局域网内用户下载或更新游戏时，直接从本地Lancache获取数据，大幅提升下载速度并减少外部网络带宽消耗。

核心功能与特性

核心功能

• 自动预填充Steam游戏：支持将指定的Steam游戏数据自动下载并缓存到Lancache中，无需手动触发下载。
• 灵活的游戏选择：可通过游戏ID、名称或列表文件指定需预填充的游戏，支持单游戏或批量操作。
• Lancache兼容：与标准Lancache缓存系统无缝集成，遵循Lancache的缓存规则与网络配置。

主要特性

• 命令行交互：完全通过命令行界面操作，支持脚本化与自动化部署。
• 进度追踪：实时显示预填充进度，包括下载速度、剩余时间及缓存状态。
• 轻量级设计：基于Docker容器化部署，依赖少、配置简单，易于集成到现有Lancache环境。

使用场景与适用范围

典型场景

• 局域网游戏服务器：在网吧、电竞馆等场景中，预填充热门Steam游戏至Lancache，提升多用户同时下载的速度与稳定性。
• 家庭网络环境：家庭网络中存在多个Steam用户时，通过预填充减少重复下载，节省家庭带宽。
• 企业/校园网络：企业或校园内网部署Lancache后，利用该工具批量预填充常用游戏，优化内网资源利用。

适用范围

• 已部署Lancache缓存系统的环境；
• 需要加速Steam游戏下载的局域网场景；
• 具备基本Docker环境的服务器或个人设备。

使用方法与配置说明

前提条件

• 已部署并运行Lancache服务；
• 安装Docker Engine（20.10+版本推荐）；
• 可访问Steam网络（用于获取游戏元数据与内容）。

基本使用命令

快速启动（Docker Run）

bash
docker run -it --rm \
  -v /path/to/your/config:/app/config \  # 挂载配置目录（可选，用于持久化设置）
  -e LANCACHE_IP=192.168.1.100 \        # 指定Lancache服务器IP（必填）
  tpill90/steam-lancache-prefill \      # 镜像名称
  prefill --appids 730,570              # 预填充指定游戏（CS:GO和Dota 2的AppID）

关键参数说明

• prefill --appids <APPID列表>：指定需预填充的Steam游戏AppID（多个ID用逗号分隔，可从SteamDB查询）；
• --list：列出已缓存或可预填充的游戏；
• --update：更新工具至最新版本。

配置文件（可选）

若需持久化配置（如常用游戏列表、Lancache地址等），可通过挂载配置目录（如/path/to/your/config）保存config.json文件，配置示例：

json
{
  "lancacheIp": "192.168.1.100",
  "defaultAppIds": [730, 570, 271590],  # 默认预填充的游戏AppID
  "steamLogin": "your_steam_username"    # 可选，用于访问需登录的游戏内容
}

详细文档参考

• 完整使用指南与高级配置：Docker Setup Guide
• 项目源码与更新日志：https://github.com/tpill90/steam-lancache-prefill

注意事项

• 确保Lancache服务与工具在同一网络环境，且Lancache端口（默认80/443）可访问；
• 预填充过程需消耗外部带宽，建议在非高峰时段执行；
• 部分Steam游戏可能需要登录验证，需通过配置文件提供Steam账号信息（仅用于验证，不存储密码）。