功能一览¶
主要页面速览。所有截图均使用默认的深色主题。
仪表板¶

仪表板——节省的带宽、命中率、服务分析和热门客户端,一屏尽览
下载¶

下载——每个已缓存游戏的封面图、大小和按客户端的历史记录
四种视图模式:紧凑、卡片、标准和复古。命中和未命中筛选以及按客户端筛选可以缩小列表范围。
客户端¶

客户端——哪些设备在使用缓存,以及缓存为每个设备服务得如何
想知道哪些设备下载量最大、它们的安装是否真正命中了缓存时,打开这个页面。
用户¶

用户——会话、账户与访客访问
访客访问和登录账户都在这里管理:一个包含会话和账户的列表及详情窗格、创建账户,以及访客访问条目,它可以发出限时的访客会话,并按平台授予预填充。登录条目设置用户如何登录。主要账户及其会话仅对该账户自己可见。
事件¶

事件——在日历上查看下载活动和 LAN 聚会
把 LAN 聚会添加到日历上,即可按日期查看下载活动。
状态检查¶

状态检查——验证 DNS、缓存可达性和近期下载的路由情况
状态检查标签页(管理 → 状态检查)无需打开终端,即可检查你的 LANCache 是否正常工作。它会检查游戏域名是否解析到你的缓存、缓存是否响应、以及近期下载是否真的经过了缓存——按域名逐一给出,语言通俗易懂。
"来自此设备"为什么无法确认缓存,以及如何解决
这一个探测由你的浏览器发起,而不是服务器,因此它反映的是你的客户端所看到的情况。它会请求 http://lancache.steamcontent.com/lancache-heartbeat,真正的缓存节点会返回 204,并带上标明自身名称的 X-LanCache-Processed-By 响应头。
除非缓存主动开放,否则浏览器不允许页面跨源读取该响应头。当前的 lancachenet/monolithic 镜像多年来一直自带这项开放设置,所以得到明确结果才是常态。如果用的是较旧的镜像或自定义的 nginx 配置,探测会退回为一次只能证明有东西响应、却无法得知是什么响应的请求,卡片显示该结果,并在浏览器控制台记录一条 CORS 错误。这并没有出现故障。状态检查的其他所有结果都来自服务端,不受影响。
要修复较旧或自定义的缓存,在其 nginx 配置中向 heartbeat 的 location 添加以下几行:
location /lancache-heartbeat {
add_header X-LanCache-Processed-By $hostname always;
add_header Access-Control-Allow-Origin "*" always;
add_header Access-Control-Expose-Headers "X-LanCache-Processed-By" always;
return 204;
}
Access-Control-Expose-Headers 是最容易被遗漏的一行。缺少它时请求虽然成功,响应头依然无法读取,卡片仍会停在该结果。这里使用 * 是安全的:该探测不发送 Cookie 或凭据,响应中也只包含节点名称。
有两点需要注意:
- 如果你通过 https 提供本管理器,浏览器会阻止这个明文 http 探测,无论 CORS 如何配置,该卡片都无法工作。
- 任何不是带缓存响应头的
204的响应(例如403),都会得到同样的"无法确认"结果。
日志与缓存¶

管理 → 日志与缓存——处理日志、管理磁盘缓存,并检测损坏或已失效的文件
损坏扫描。 两种扫描,对应两类不同的问题:
| 扫描 | 检查内容 |
|---|---|
| 重复未命中 | 读取日志,找出磁盘上存在却反复未命中的文件。这通常意味着缓存副本已损坏。 |
| 结构性 | 打开缓存文件,检查 nginx 响应头、载荷偏移和记录的长度。只标记确凿的失败项。 |
结构性扫描有两种模式:
- 全面扫描检查所有符合条件的文件,并重建基线。
- 增量扫描只检查新增、变更或此前未解决的文件。
要移除扫描发现的文件,/cache 挂载不能带 :ro。
以上是日常会用到的部分。管理页面背后还有更多标签——展开下方查看全部内容。
查看全部管理页面
设置¶

设置——认证、演示模式和显示偏好设置。
演示模式会用模拟数据填充界面,让你在还没有任何真实缓存历史时就能先试用 UI。
集成¶

集成——Steam、Epic 和 Xbox 的登录,无需账号的 Battle.net 和 Riot,以及 Prometheus 端点。
数据¶

数据——数据导入和数据库管理。
计划任务¶

计划任务——每个后台服务都有自己的运行间隔。映射行使用立即运行。页面底部的计划预填充卡片使用全部运行。
主题¶

主题——在已安装的主题间切换、导入社区主题,或上传你自己的主题。
客户端(昵称与规则)¶

客户端——从列表中选择一个客户端,为它设置昵称和规则(计入、仅统计或隐藏)。预填充流量和主机名查询两行会打开各自的窗格。
一个昵称可以覆盖多个 IP 地址——当一台机器双系统启动,或在有线与无线之间切换、否则会被识别为多个客户端时,这很有用。
预填充会话¶

预填充会话——查看实时和持久预填充容器,并回顾历史运行记录。