预填充¶
预填充会在用户连接之前把游戏下载进你的缓存。等客人到场时,每次安装都从你的缓存读取,而不是走公共互联网——满速 LAN,没有带宽瓶颈。
Steam、Epic、Battle.net、Riot 和 Xbox 各自在独立的容器中运行,因此你可以同时预填充所有平台而互不干扰。进度会实时推送到 UI。

选择一个平台,开始一次预填充会话
要求¶
- 已挂载 Docker 套接字(
/var/run/docker.sock) - 以主要或账户登录 LANCache Manager(访客模式只能预填充在用户页面的访客访问中,或在该访客自己的会话中授权的平台)
- 预填充容器可以访问到你的缓存服务器(参见下方的网络设置)
运行一次预填充¶
每个平台的流程都一样:
- 打开预填充标签页,在 Steam、Epic Games、Battle.net、Riot Games 或 Xbox 上点击开始会话
-
如果平台需要账号,请登录:
平台 登录方式 Steam 用户名、密码和 Steam 令牌 Epic Games 点击打开 Epic 登录页面,粘贴授权码,然后点击提交代码 Xbox 点击打开 Microsoft 页面,并在那里输入你的代码 Battle.net、Riot Games 无需账号 -
点击选择应用
- 点击预填充已选,然后点击开始下载
保持会话运行。客人到达时,游戏已经缓存好了。
Note
预填充构建在社区守护进程之上:
- Steam:steam-prefill-daemon,steam-lancache-prefill 的分支,原作者 @tpill90
- Epic:epic-prefill-daemon——在 Epic 页面登录,然后粘贴授权码
- Battle.net:battlenet-prefill-daemon——完全匿名,无需账号
- Riot:riot-prefill-daemon,基于 @tpill90 的 lancache-prefill 系列工具构建——完全匿名;覆盖英雄联盟、云顶之弈和无畏契约
- Xbox:xbox-prefill-daemon——使用 Microsoft 设备代码登录(与 Epic 一样需要账号)
导入 Steam App ID¶
要预填充来自 steam-lancache-prefill 或其他来源的 App ID 列表,可以直接导入,而不使用库浏览器:
- 点击选择应用
- 点击导入应用 ID
- 以下列任一格式粘贴你的 ID:
- 逗号分隔:
730, 570, 440 - JSON 数组:
[730, 570, 440] - 每行一个
- 点击导入
对话框会告诉你添加了多少个游戏、有多少已经在选中列表中、以及有多少 ID 不在你的 Steam 游戏库中(这些不会被加入你的选择)。
Tip
从 steam-lancache-prefill 迁移: 打开 selectedAppsToPrefill.json,把内容粘贴到导入框中。JSON 数组会按原样读取。
计划预填充¶
配置一次,从此不必在每场活动前手动预填充。打开管理 → 计划任务,找到计划预填充卡片。
设置步骤¶
- 在某个服务上点击启动,启动它的容器。
- Steam、Epic 或 Xbox 需要点击管理并登录。Battle.net 和 Riot 无需账号。
- 点击添加计划,选择游戏或预设,然后点击保存。
计划会在保存后一个间隔时运行。要立即运行,点击该行的运行计划。
各按钮的作用¶
| 按钮 | 作用 |
|---|---|
| 全部运行 | 启动所有已启用的计划 |
| 运行计划(行内) | 只启动这一条计划 |
| 编辑计划 | 打开该计划。运行总是使用已保存的版本,所以请先保存再运行。 |
| 添加计划、复制 | 打开一份草稿。点击保存之前不会创建任何内容。 |
| 操作 → 查看活动 | 显示所有服务的当前下载和运行历史,并可取消下载 |
| 操作 → 容器设置 | 设置所有服务容器的默认值,包括登录。某个服务已保存的重启后覆盖仍然优先。 |
| 清除已保存的登录 | 注销正在运行的容器,并删除已保存的 Steam、Epic 和 Xbox 登录 |
服务被跳过的情况¶
每个服务只有一个由其所有计划共享的容器。计划运行只会使用已经在运行的容器;Steam、Epic 和 Xbox 还必须已登录。否则:
- 该服务会被跳过,通知会提示需要登录。其他服务仍会运行。
- 如果什么都没有运行,本次运行会报告为未成功,并写明原因。
- 无论哪种情况,计划都会保持其间隔。
Steam、Epic 或 Xbox 的登录只能由保存它的 LANCache 账号再次使用。
删除¶
- 删除计划不会停止其容器,也不会删除已缓存的游戏。
- 要删除已缓存的游戏,请使用管理 → 日志与缓存里的游戏缓存检测与移除。
其他计划设置¶
- 间隔和状态。 每条已保存计划都有自己的“运行频率”间隔。你可以暂停计划,也可以将其设置为仅在启动时运行。首次自动运行会在保存后的一个间隔之后触发;保存本身不会开始运行。
- 预设或手动选择游戏。 预设有全部、最近和前 N 项三种。Epic 没有“最近”,因为它的 API 不提供最近游玩数据。Battle.net 和 Riot 只支持“全部”。为某条计划选择的游戏会覆盖其预设。
- 新计划历史。 新的已保存计划会一直显示“上次运行:从未运行”,直到该计划首次运行完成。下次运行时间按其间隔推算。
- 目标平台。 只有 Steam 支持 Windows、Linux 和 macOS depot 筛选,默认值为 Windows。
- 下载控制。 强制重新下载默认关闭。连接数可以是自动,也可以固定为 1 到 128。自动从总共 30 个连接开始,测得的下载速度持续上升时增加连接,不再上升时减少,并把这个总数分给同时运行的各个自动预填充,每当其中一个开始或结束时重新分配。设为固定数量的预填充保持该数量,自动会为它让路:自动测量所有正在运行的预填充的速度,因此当固定数量的预填充已占满带宽时,自动降到每个自动预填充 4 个连接,带宽有空余时再增加。运行通知可以是所有运行、仅手动、静默或隐藏。
默认值和限制:
| 设置项 | 默认值 |
|---|---|
| 运行频率(每计划) | 24 小时 |
| 预设 | 全部("前 N 项"预设使用排名前 50 的游戏) |
| 持久登录有效期 | 90 天 |
| 无进展超时(每次计划运行) | 30 分钟 |
| 强制下载 | 关闭 |
| 最大并发数 | 自动(固定范围:1-128) |
| 单服务最长运行时间 | 12 小时 |
计划任务页面的其余部分,对每个后台服务都采用相同的方式工作——日志轮转、失效扫描、游戏检测、缓存快照等等。每个服务都是一行,各有自己的间隔,行尾带一个运行控件。这里也有一行 Xbox 游戏映射,让 Xbox 游戏目录能按自己的计划刷新。
网络设置¶
大多数安装无需任何配置。 如果你运行的是标准的 lancache + lancache-dns 容器,lancache-manager 会自动检测它们,预填充无需额外设置即可工作。
如果你的 DNS 不是标准的 lancache-dns(比如使用 AdGuard Home、Pi-hole、公共 DNS 等)或者路由方式比较特殊,设置一个环境变量就能解决:
| 你的环境 | 需要设置什么 |
|---|---|
标准 lancache + lancache-dns 容器 |
无需设置 |
| 单机安装(lancache 与 lancache-manager 在同一主机) | 无需设置 |
| AdGuard Home、Pi-hole 或任何 DNS 替代方案 | Prefill__LancacheIp=<你的缓存 IP> |
| 主机网络模式,且主机 DNS 未将 CDN 路由到你的缓存 | 通常无需设置——缓存会通过网桥网关自动检测并经心跳验证;如果网络面板仍然警告,再设置 Prefill__LancacheIp=<你的缓存 IP> |
Caddy/Squid 等按 Host: 头路由的非 nginx 缓存 |
Prefill__LancacheIp=<你的缓存 IP> |
| 希望无论环境如何都有可预测的行为 | 始终设置 Prefill__LancacheIp |
Tip
Prefill__LancacheIp 是通用覆盖项。 设置后,预填充会直接通过 IP 与你的缓存通信,完全不再询问 DNS 缓存在哪里。网络模式和 DNS 服务器设置对 CDN 流量不再有影响。
Prefill__LancacheIp、Prefill__LancacheDnsIp 和 Prefill__NetworkMode 的完整说明与默认值位于配置 → 预填充参考表中。
Important
LancacheIp 和 LancacheDnsIp 是两个不同的服务,即使在同一台机器上也是如此。
| 是什么 | 端口 | 作用 | |
|---|---|---|---|
LancacheIp |
缓存服务器(lancachenet/monolithic,或任何 HTTP 缓存) |
HTTP / 80 | 保存实际的缓存游戏文件 |
LancacheDnsIp |
DNS 服务器(lancachenet/lancache-dns、AdGuard Home、Pi-hole 等) |
DNS / 53 | 把 lancache.steamcontent.com 转换成缓存的 IP |
两者可以共用一个 IP、使用不同端口,但做的是不同的工作。设置 LancacheIp 会让缓存流量直接发往缓存服务器,因此 DNS 不再影响这部分流量。
Important
LANCACHE_IP 只重定向 CDN 分块流量,而这本来就是 lancache 唯一会缓存的内容。Steam(api.steampowered.com)和 Epic(*.epicgames.com)的认证与清单端点仍然使用正常 DNS,不受影响。
示例¶
最可靠——LancacheIp 让 CDN 路由不再依赖 DNS:
Bridge 模式配合非标准 DNS(例如用 AdGuard Home 替代 lancache-dns):
environment:
- Prefill__NetworkMode=bridge
- Prefill__LancacheIp=192.168.1.10 # 缓存服务器
- Prefill__LancacheDnsIp=192.168.1.20 # DNS 服务器
Bridge 模式,标准 lancache-dns,无 IP 覆盖(传统的 DNS 驱动路径):
Tip
预填充容器没有互联网? 试试 Prefill__NetworkMode=bridge。
网络诊断¶
每次预填充会话启动时都会运行一次连通性测试,并把结果写入日志:
═══════════════════════════════════════════════════════════════════════
PREFILL CONTAINER NETWORK DIAGNOSTICS - prefill-daemon-abc123
═══════════════════════════════════════════════════════════════════════
Internet connectivity: OK (reached api.steampowered.com)
lancache.steamcontent.com resolved to 192.168.1.10
DNS looks correct (private IP - likely your lancache server)
═══════════════════════════════════════════════════════════════════════
如果解析出的 IP 是公网地址(Steam 真实 CDN 的 IP 形如 162.254.x.x),说明流量绕过了你的缓存。设置 Prefill__LancacheIp 并重启会话。
路由工作原理(高级)——请求究竟走哪条路径
---
config:
flowchart:
curve: basis
padding: 12
---
flowchart TD
Start([需要从 CDN 主机名<br/>获取一个游戏分块])
HasIp{LANCACHE_IP 可用?<br/>Prefill__LancacheIp 或<br/>自动检测并已验证}
Start --> HasIp
HasIp -->|是| Direct[直接连接该 IP<br/>Host 头 = CDN 主机名]
Direct --> Hit([由你的缓存提供服务])
HasIp -->|否| AskDns[向 DNS 询问<br/>CDN 主机名指向哪里]
AskDns --> Mode{NetworkMode?}
Mode -->|host| HostDns[使用主机自己的 DNS<br/>Prefill__LancacheDnsIp 被忽略]
Mode -->|bridge| Bridge{设置了 Prefill__LancacheDnsIp?}
Bridge -->|是| Forced[查询该 DNS 服务器]
Bridge -->|否| Probe[守护进程探测 CDN 名、<br/>localhost,然后是网关]
HostDns --> Resolved{DNS 返回了<br/>你的缓存 IP?}
Forced --> Resolved
Probe --> Resolved
Resolved -->|是| Hit
Resolved -->|否| Miss([公网 CDN IP<br/>流量绕开你的缓存])
所有组合:
NetworkMode |
LancacheIp |
LancacheDnsIp |
结果 |
|---|---|---|---|
host |
已设置 | (任意) | 可靠。已注入 LANCACHE_IP;DNS 无关紧要。 |
host |
未设置 | (任意) | 通常没问题。自动检测 + 心跳会注入 LANCACHE_IP;否则使用主机 DNS。host 模式下 DnsIp 会被丢弃。 |
bridge |
已设置 | 未设置 | 可靠。已注入 LANCACHE_IP;DNS 无关紧要。 |
bridge |
已设置 | 已设置 | 可靠。LANCACHE_IP 用于 CDN,DnsIp 用于认证/清单。 |
bridge |
未设置 | 已设置 | 如果 DnsIp 能把 CDN 解析到你的缓存则有效。 |
bridge |
未设置 | 未设置 | 通常没问题。自动检测会注入 LANCACHE_IP;否则守护进程探测 localhost/网关。 |
为什么 LancacheIp 总是有效: 设置后,守护进程会请求 GET http://192.168.1.10/depot/...,并带上 Host: lancache.steamcontent.com。你的缓存按 Host: 路由并从缓存提供服务。DNS 不会被问及 CDN 域名。