配置参考¶
本节是一份查询表。浏览标题,按需深入。真正涉及决策的两项设置各有专门的说明:数据库模式和预填充网络。
如果是常规安装,从代码仓库中的 docker-compose.yml 开始即可。想一次看到全部支持的变量,跳转到本节末尾的完整带注释 Compose 示例。
数据卷¶
| 数据卷 | 用途 | 说明 |
|---|---|---|
/data |
PostgreSQL 数据库、安全信息、状态与配置、主题、已缓存的图片 | 必需 |
/logs |
LANCache 访问日志 | 添加 :ro 可设为只读 |
/cache |
LANCache 缓存文件 | 添加 :ro 可只监控而不修改文件 |
/var/run/docker.sock |
Docker API 访问 | 可选。nginx 日志轮转以及 Steam/Epic/Battle.net/Riot/Xbox 预填充需要它 |
必需设置¶
| 变量 | 默认值 | 描述 |
|---|---|---|
PUID |
33(随附的 Compose 文件) |
应用运行所用的用户 ID。应与你的缓存和日志文件的所有者一致。 |
PGID |
33(随附的 Compose 文件) |
应用运行所用的组 ID。 |
TZ |
UTC |
日志时间戳所用的时区(例如 America/Chicago)。也接受 TimeZone 作为后备写法。 |
LanCache__LogPath |
- | 容器内 LANCache 访问日志的路径。 |
LanCache__CachePath |
- | 容器内 LANCache 缓存目录的路径。 |
该用哪个 PUID/PGID? 与你的缓存和日志文件所有者保持一致——用 ls -n /path/to/cache 就能看到。随附的 Compose 文件使用 33:33(www-data),适合大多数标准的 lancache 安装。Unraid 使用 99:100。如果运行原始镜像时没有设置 PUID 或 PGID,入口脚本会把缺少的那一个回退为 1000。请把它当作兜底值,而不是推荐值。
PostgreSQL¶
模式选择和完整的 Compose 示例见选择镜像与数据库模式。变量如下:
| 变量 | 默认值 | 描述 |
|---|---|---|
POSTGRES_MODE |
embedded |
embedded 或 external。 |
POSTGRES_USER |
lancache |
PostgreSQL 用户名。两种模式均适用。外部模式下,该角色必须是数据库属主或对数据库拥有 CREATE 权限,因为表结构会安装 citext 扩展,详见选择镜像与数据库模式。 |
POSTGRES_PASSWORD |
- | PostgreSQL 密码。内嵌模式下若未设置,UI 会显示设置页面。从配置错误页重置该密码需要至少 12 个字符,并使用三种字符类别。外部模式下必须设置(或在应用连接前通过 UI 后备表单输入);该路径接受服务器上已有的密码。 |
POSTGRES_HOST |
- | 仅外部模式。 Postgres 服务器的主机名或 IP。 |
POSTGRES_PORT |
5432 |
仅外部模式。 |
POSTGRES_DB |
lancache |
数据库名称。两种模式均适用。 |
安全¶
| 变量 | 默认值 | 描述 |
|---|---|---|
Security__EnableAuthentication |
true |
只在尚未保存登录模式时生效。true 选择API 密钥、用户名和密码。false 选择无需身份验证。已保存的模式不会被这个变量替换。 |
Security__GuestSessionDurationHours |
6 |
默认访客会话时长(也可在 UI 中配置)。 |
Security__RequireAuthForMetrics |
false |
/metrics 端点是否需要 API 密钥。管理 → 集成中的端点访问,或用户 → 登录中的 Prometheus 指标,在设置后会覆盖此值。 |
Security__AllowedOrigins |
(空) | 逗号分隔的 CORS 允许列表。为空表示仅允许同源访问(安全的默认值)。* 允许任意来源但不携带凭据;显式列表则允许所列来源并携带凭据。 |
Security__ApiKeyPath |
/data/security/api_key.txt |
覆盖实例 API 密钥的读写文件路径。当你从 /data 之外绑定挂载密钥时很有用。 |
Security__KnownProxyNetworks |
(空) | 用于 X-Forwarded-For 的可信代理网络 CIDR 列表,逗号分隔(例如 172.16.0.0/12,10.0.0.0/8)。当 nginx、Traefik 或其他反向代理位于管理器前面时设置此项,客户端 IP 才能被正确报告。回环地址始终受信任。如果代理位于另一台主机或另一个容器上而此项留空,登录限流会把所有客户端都算在代理的地址上,此时一个人反复输错密码就会把其他所有人锁在门外一分钟。 |
Security__TrustAllProxies |
false |
无条件信任每一个上游代理。方便本地开发使用。切勿在暴露于公网的主机上启用——任何人都能伪造客户端 IP。 |
Security__ForceSecureCookies |
false |
告知管理器 TLS 在你的反向代理处终止。启用后,应用设置的每个 Cookie 都会带上 Secure 标志,并且应用会将该连接视为 HTTPS,这样 CSRF 防护的 Cookie 策略就不会再拒绝那些在它看来是通过纯 HTTP 到达的请求。请仅在应用前面的 HTTPS 确实可用之后再开启:若前面没有 TLS,浏览器将不再回传会话 Cookie,任何人都无法登录。同时设置 Security__KnownProxyNetworks 仍然值得,这样客户端 IP 和登录速率限制才会准确。 |
并非每项 /metrics 设置都有对应的环境变量。指标更新间隔、示例配置中使用的 Prometheus 抓取间隔,以及按游戏统计序列导出的游戏数量,都在管理 → 集成中设置。参见 Prometheus 指标。
访问级别¶
| 级别 | 可执行的操作 | 示例 |
|---|---|---|
| 主要 | 拥有此安装。唯一可以清空全部账户或重新生成 API 密钥的账户。对其他所有账户隐藏,包括其会话。 | 清空账户、重新生成密钥 |
| 账户 | 登录后使用应用。可以看到其他普通账户,但只能更改自己的设置。不能看到主要账户及其会话。全局设置仅限管理员。 | 浏览下载、更改自己的设置 |
| 访客 | 通过访客会话查看。预填充是单独授予的:主要账户按平台授予,可以授予所有新访客,也可以只授予某一个会话。 | 浏览下载、统计、事件、客户端数据 |
要在不分享账户的情况下让其他用户进入:
- 在用户页面打开访客访问,并开启新访客可以登录。
- 访客在登录界面点击以访客身份继续。
会话时长,以及新访客是否获得预填充,都在用户页面的访客访问中设置。
每个页面和每项操作都需要已登录账户或一个访客会话。例外情况:
- 除非你设置
Security__RequireAuthForMetrics=true,否则/metrics是公开的。 /health存活探针始终会应答。- 登录和首次运行设置必须公开,否则无法访问。
通过环境变量设置登录¶
你可以在 Compose 文件中设置登录模式和单点登录,而不必使用界面。所有名称都以 Security__ 开头。应用只在启动时读取这些值一次,因此修改后需要重启。
| 变量 | 含义 | 默认值 |
|---|---|---|
Security__SignInMode |
登录模式,不区分大小写。可用值见下表。 | (未设置) |
| 取值 | 模式 |
|---|---|
Password |
用户名和密码 |
ApiKeyPassword |
API 密钥、用户名和密码 |
ApiKeyOidc |
API 密钥和单点登录(别名 ApiKeyAndSso) |
Oidc |
单点登录(别名 Sso) |
Unauthenticated |
免认证访问。每次启动都会删除所有账户,包括环境变量中的登录所允许的账户。 |
每个单点登录使用相同的字段。服务商有自定义 OpenID Connect(Oidc)、Google、GitHub、Microsoft 和 Apple。
| 变量 | 含义 | 默认值 |
|---|---|---|
Security__Oidc__ClientIdSecurity__Google__ClientIdSecurity__GitHub__ClientIdSecurity__Microsoft__ClientIdSecurity__Apple__ClientId |
服务商应用注册中的客户端 ID。 | (未设置) |
Security__Oidc__ClientSecretSecurity__Google__ClientSecretSecurity__GitHub__ClientSecretSecurity__Microsoft__ClientSecret |
客户端密钥。建议使用 ClientSecretFile 形式,让密钥不出现在 Compose 文件中。Apple 没有客户端密钥,它使用下方的私钥。 |
(未设置) |
Security__Oidc__ClientSecretFileSecurity__Google__ClientSecretFileSecurity__GitHub__ClientSecretFileSecurity__Microsoft__ClientSecretFile |
容器内保存客户端密钥的文件路径。 | (未设置) |
Security__Oidc__DisplayNameSecurity__Google__DisplayNameSecurity__GitHub__DisplayNameSecurity__Microsoft__DisplayNameSecurity__Apple__DisplayName |
登录按钮上显示的名称。 | (未设置) |
Security__Oidc__AllowedSubjectsSecurity__Google__AllowedSubjectsSecurity__GitHub__AllowedSubjectsSecurity__Microsoft__AllowedSubjectsSecurity__Apple__AllowedSubjects |
允许登录的服务商账户 ID,逗号分隔。见允许其他用户登录。 | (未设置) |
Security__Oidc__OwnerSubjectSecurity__Google__OwnerSubjectSecurity__GitHub__OwnerSubjectSecurity__Microsoft__OwnerSubjectSecurity__Apple__OwnerSubject |
所有者的服务商账户 ID,所有者以主管理员身份登录。 | (未设置) |
Security__Oidc__OwnerIssuerSecurity__Google__OwnerIssuerSecurity__GitHub__OwnerIssuerSecurity__Microsoft__OwnerIssuerSecurity__Apple__OwnerIssuer |
与 OwnerSubject 配套的颁发者。 |
服务商经过验证的授权地址。GitHub 为 https://github.com。 |
部分服务商还需要额外字段。
| 变量 | 含义 | 默认值 |
|---|---|---|
Security__Oidc__Authority |
自定义 OpenID Connect 服务商的 HTTP 或 HTTPS 颁发者 URL。服务商使用自签名或私有证书时,请把其 CA 证书(PEM 格式,.crt)放入 /data/certs/ 并重启。 |
(未设置) |
Security__Microsoft__Tenant |
目录(租户)GUID,个人账户填 consumers。 |
(未设置) |
Security__Apple__TeamId |
Apple Team ID。 | (未设置) |
Security__Apple__KeyId |
Apple Key ID。 | (未设置) |
Security__Apple__PrivateKey |
Apple .p8 私钥的内容。 |
(未设置) |
Security__Apple__PrivateKeyFile |
容器内 Apple .p8 私钥文件的路径。 |
(未设置) |
这些值的行为:
| 情况 | 结果 |
|---|---|
*File 变量 |
文件中去掉首尾空白的文本就是该值。文件无法读取时,应用会记录一条错误,其中写明变量名而不是值。此时如果设置了内联变量,该字段使用内联值;如果没有设置,该字段保持未设置。 |
| 同一字段既内联设置又用文件设置 | 以文件为准。应用会记录一条警告,写明两个变量。 |
| 同一字段在环境变量和界面中都有设置 | 该字段以环境变量为准。环境变量没有设置的字段保留界面中的值。 |
| 界面如何显示环境变量设置的字段 | 显示为由环境变量设置,且不能编辑。模式来自环境变量时,模式选择器为只读。 |
| 来自环境变量的密钥 | 永远不会写入 state.json。 |
Oidc 或 ApiKeyOidc 但没有有效登录 |
应用回退到 ApiKeyPassword,绝不回退到 Unauthenticated,并记录一条错误,写明缺少的字段。 |
无效的 Security__SignInMode 值 |
应用只记录一次并忽略它。 |
使用 Password 或 ApiKeyPassword 的首次运行设置 |
跳过访问步骤。数据库步骤和第一个账户步骤仍然会运行。 |
使用 Unauthenticated 的首次运行设置 |
跳过访问步骤。每次启动都会删除所有账户,包括环境变量中的登录所允许的账户。不会创建第一个账户。 |
使用 Oidc 或 ApiKeyOidc 的首次运行设置 |
访问步骤仍会显示,但为只读。所有者在此处通过环境变量中的登录进行登录。 |
| 之后你删除这些变量 | 访问步骤会重新出现。已保存的登录若失去了环境变量字段,且没有环境变量来补全,就不再列出。 |
登录开启时,环境变量中的登录所允许的账户(通过 OwnerSubject 或 AllowedSubjects)无法被移除:
- 删除和批量删除都会拒绝。
- 轮换 API 密钥时保留该账户。
- 重置账户时保留该账户及其已保存的 Steam、Epic 和 Xbox 登录。
- 拒绝提示为:“此账户由环境变量授权。请先从该变量中移除它并重启应用,然后再删除该账户。”
- 只要有任何一个字段来自环境变量,该登录服务就不能在界面中移除。
关闭登录时,该账户也会和其他所有账户一样被删除。如果在该变量仍然设置的情况下重新开启登录,该用户下次登录时会重新创建该账户。
如果回退使所有者无法登录,请按密码恢复操作。
预填充设置¶
预填充会为本表中几乎所有内容自动检测出合适的值。使用前需要了解三点:
- 把
Prefill__LancacheIp设置为你缓存服务器的 IP,预填充就不再依赖 DNS。 这一点对 Battle.net 尤为重要,它的 CDN 域名经常不在 lancache DNS 中,可能导致预填充挂起。 - 不设置的话,管理器会自动检测你的缓存。它会对几个候选地址做一次快速的健康检查,只会使用真正像 lancache 一样应答的地址。
- 只有在自动检测出错时才需要用到其他变量。决策表见网络设置。
| 变量 | 默认值 | 描述 |
|---|---|---|
Prefill__LancacheIp |
(未设置) | 你缓存服务器(保存缓存文件的 HTTP 服务器,端口 80)的 IP 或主机名。会作为 LANCACHE_IP 转发给守护进程;随后守护进程使用伪造的 Host: 头直接连接,跳过 CDN 流量的 DNS 查询。最可靠的覆盖项——只要你的 DNS 不是标准的 lancache-dns,就应该设置它。 |
Prefill__LancacheDnsIp |
auto |
你DNS 服务器(lancache-dns、AdGuard、Pi-hole——端口 53)的 IP。会写入预填充容器的 /etc/resolv.conf,让守护进程用它解析 CDN 主机名。仅在 bridge 模式下使用——LANCache Manager 只会在 bridge 模式的预填充容器上设置它;host 模式下容器使用主机自身的 DNS。auto 会复用检测到的 lancache-dns 容器的 IP。 |
Prefill__NetworkMode |
auto |
预填充容器的 Docker 网络模式。接受 host、bridge 或某个 Docker 网络名称。auto 会根据你的 lancache-dns 容器推断模式。 |
Prefill__SteamDockerImage |
ghcr.io/regix1/steam-prefill-daemon:latest |
Steam 预填充容器所用的 Docker 镜像。 |
Prefill__EpicDockerImage |
ghcr.io/regix1/epic-prefill-daemon:latest |
Epic 预填充容器所用的 Docker 镜像。 |
Prefill__BattlenetDockerImage |
ghcr.io/regix1/battlenet-prefill-daemon:latest |
Battle.net 预填充容器所用的 Docker 镜像。 |
Prefill__RiotDockerImage |
ghcr.io/regix1/riot-prefill-daemon:latest |
Riot 预填充容器所用的 Docker 镜像。 |
Prefill__XboxDockerImage |
ghcr.io/regix1/xbox-prefill-daemon:latest |
Xbox 预填充容器所用的 Docker 镜像。 |
Prefill__SessionTimeoutMinutes |
120 |
非持久预填充会话的总生命周期。访客会话和持久会话使用各自独立的限制。 |
Prefill__StallTimeoutSeconds |
180 |
高级设置。预填充被判定为停滞前的无进展时长。 |
Prefill__AbandonedLoginTimeoutSeconds |
900 |
高级设置。预填充登录可以在浏览器中等待的秒数,超时后应用会结束这次登录。 |
Prefill__DaemonBasePath |
/data/prefill |
存储预填充会话状态的容器内路径。 |
Prefill__HostDataPath |
auto |
映射到管理器 /data 数据卷的主机路径。从管理器的挂载配置中检测;仅在检测失败时(不常见的平台、自定义数据卷驱动)才需要显式设置。 |
Prefill__UseTcp |
auto |
使用 TCP 而非 Unix 域套接字与守护进程通信。auto 在 Windows 上解析为 true,在 Linux 上为 false。Linux 用户只有在想强制使用 TCP 模式时才需要设置此项。 |
Prefill__TcpPort |
45555 |
守护进程在其容器内监听的 TCP 端口。仅用于 TCP 模式——Windows 默认如此,Linux 仅在 Prefill__UseTcp=true 时如此。 |
Prefill__HostTcpPort |
(随机空闲端口) | 守护进程容器在主机上发布的 TCP 端口。仅 TCP 模式。 |
Prefill__TcpHost |
127.0.0.1 |
守护进程绑定、管理器通过 TCP 连接的主机。仅 TCP 模式。 |
Note
TCP 模式是平台分界线。 在 Windows 上,预填充容器通过 TCP 通信,因为 Windows 不向 Docker 暴露 Unix 域套接字。在 Linux 上,预填充默认使用 Unix 域套接字——除非你设置 Prefill__UseTcp=true,否则上面四个 TCP 变量都会被忽略。标准的 Linux 安装可以完全跳过 TCP 相关的行。
路径与数据源¶
| 变量 | 默认值 | 描述 |
|---|---|---|
LanCache__EnvFilePath |
(自动) | lancache .env 文件的路径(用于读取 CACHE_DISK_SIZE)。未设置时会在常见位置搜索。 |
LanCache__AutoDiscoverDatasources |
false |
从 /cache 和 /logs 下匹配的子目录自动检测数据源,最多向下三层。 |
如果你运行多个缓存实例,或者把不同服务分散在多个驱动器上,请参见多数据源。
Nginx 日志轮转¶
| 变量 | 默认值 | 描述 |
|---|---|---|
NginxLogRotation__Enabled |
true |
通知 nginx 在应用轮转日志后重新打开日志文件。需要 Docker 套接字。 |
NginxLogRotation__ContainerName |
(空 = 自动检测) | LANCache 容器名称。留空(或设为 auto)时,应用会查找名称中包含 "lancache" 的容器。 |
NginxLogRotation__ScheduleHours |
24 |
检查是否需要轮转的频率。 |
API 与高级设置¶
| 变量 | 默认值 | 描述 |
|---|---|---|
ApiOptions__MaxClientsPerRequest |
1000 |
单次统计请求最多返回的客户端数量。 |
ApiOptions__DefaultClientsLimit |
100 |
未指定限制时的默认客户端数量。 |
ASPNETCORE_URLS |
http://+:80 |
内部端口绑定。除非你清楚为什么要改,否则不要改动。 |
ConnectionStrings__DefaultConnection |
(自动) | 完整的 PostgreSQL 连接字符串覆盖项。面向单个 POSTGRES_* 变量无法满足的复杂配置的高级用户。 |
CacheSnapshots__RetentionDays |
90 |
缓存快照的保留时长。更早的快照会被自动删除。 |
CacheSnapshots__IntervalMinutes |
60 |
高级设置。记录一次缓存大小快照的频率。 |
GitHubMappings__HttpsProxy |
(未设置) | 仅用于 GitHub depot 映射下载的代理。只对访问 github.com 和 *.githubusercontent.com 的 443 端口 HTTPS 请求(包括重定向)生效;其他主机一律直连。必须是绝对 HTTP 或 HTTPS URL,例如 http://proxy:3128;http://user:pass@proxy:3128 会使用该用户名和密码登录代理。未设置时,下载与应用其他部分一样使用 HTTPS_PROXY、HTTP_PROXY 和 NO_PROXY。 |
缓存切片大小¶
缓存切片大小设置位于管理页面,在缓存操作顶部的缓存设置卡片中。它告诉应用你的缓存中切片有多大,该值由 LANCache 的 CACHE_SLICE_SIZE 决定。应用用它来找到一个缓存文件的所有切片。
| 取值 | 含义 |
|---|---|
| 自动(默认) | 应用从缓存文件的 KEY: 头中读取大小。 |
| 手动指定大小 | 页面提供 1 到 64 MiB 之间 2 的幂的选项。其他整数 MiB 的大小请使用下方的 PATCH 请求。请将它设为与 CACHE_SLICE_SIZE 一致。 |
- 应用始终会检查在磁盘上找到的大小,因此以旧大小写入的文件仍然可见。
- 应用先尝试手动大小,再尝试抽样得到的大小,然后是 1 MiB。都不匹配时,它会尝试从 1 MiB 到 64 MiB 的每一个 2 的幂。
- 不是 2 的幂的大小(例如
CACHE_SLICE_SIZE=10m)不在页面的选项中。请用PATCH /api/system/cache-slice-size设置,sliceSizeBytes填10485760。否则应用只能通过抽样文件来匹配它。保存后,页面会列出该大小并显示为已选中。 - 文件都使用同一种大小的游戏会显示大小标记,例如 8 MB 切片。有多种大小的游戏显示混合切片。检测尚未扫描的游戏不显示标记。
- 当抽样文件因“未找到”以外的原因无法读取时,移除模式的驱逐、游戏和服务移除以及损坏修复会在删除任何内容之前报错并停止。
- 当切片大小为自动、缓存路径下有文件、但抽样找不到可用的
KEY:范围时,移除模式的驱逐也会停止。要让它运行,请设置与CACHE_SLICE_SIZE一致的手动切片大小。
| 请求 | 请求体 | 说明 |
|---|---|---|
GET /api/system/cache-slice-size |
无 | 返回 sliceSizeBytes,null 表示自动。 |
PATCH /api/system/cache-slice-size |
sliceSizeBytes |
null 选择自动。其他值必须是 1 MiB 的正整数倍。 |
这两个请求都需要账户持有者的会话。
完整带注释的 Compose 示例¶
下面这个例子是一份完整、可直接使用的 Compose 文件。生效的几行与快速开始一致;每一项可选设置都已列出但被注释掉,并注明了默认值和适用场景,因此可以放心复制使用。
完整带注释的 Compose 示例——全部支持的变量
services:
lancache-manager:
image: ghcr.io/regix1/lancache-manager:latest
container_name: lancache-manager
restart: unless-stopped
ports:
- "8080:80"
volumes:
- ./data:/data # 数据库、API 密钥、主题、预填充状态
- /mnt/lancache/logs:/logs:ro # LANCache 访问日志
- /mnt/lancache/cache:/cache:ro # 去掉 :ro 可允许清除缓存和移除游戏
- /var/run/docker.sock:/var/run/docker.sock # 可选:预填充和 nginx 日志轮转需要
environment:
# --- 必需(与快速开始相同) ---
- PUID=33 # 应用运行所用的用户 ID;33 = 随附 Compose 文件的值(www-data)。Unraid:99
- PGID=33 # 组 ID;33 = 随附 Compose 文件的值。Unraid:100
- TZ=America/Chicago # IANA 时区;默认 UTC
- LanCache__LogPath=/logs/access.log # 容器内的访问日志
- LanCache__CachePath=/cache # 容器内的缓存目录
# --- PostgreSQL(默认以内嵌 Postgres 运行,无需额外设置) ---
# - POSTGRES_MODE=embedded # embedded(默认)或 external;精简镜像仅支持 external
# - POSTGRES_USER=lancache # 默认 lancache
# - POSTGRES_PASSWORD= # 密钥;留空则首次运行页面会要求输入
# 仅外部模式:
# - POSTGRES_HOST=lancache-db
# - POSTGRES_PORT=5432
# - POSTGRES_DB=lancache
# --- 安全 ---
# - Security__EnableAuthentication=true # 尚未保存模式时:false 选择无需身份验证
# - Security__SignInMode=Oidc # Password、ApiKeyPassword、ApiKeyOidc、Oidc 或 Unauthenticated;设置后即固定模式
# - Security__Google__ClientId= # 一个服务商的配置块;Oidc、GitHub、Microsoft 和 Apple 使用相同字段
# - Security__Google__ClientSecretFile=/run/secrets/google_client_secret # 文件中去掉首尾空白的文本就是密钥
# - Security__Google__OwnerSubject= # 所有者的服务商账户 ID
# - Security__Google__AllowedSubjects= # 允许登录的服务商账户 ID,逗号分隔
# - Security__RequireAuthForMetrics=false # true = /metrics 需要 Bearer 令牌
# - Security__GuestSessionDurationHours=6
# - Security__AllowedOrigins= # CORS 来源列表,逗号分隔;为空 = 仅同源,* = 任意来源(不携带凭据)
# - Security__ForceSecureCookies=false # 在 TLS 终止型代理之后运行时设为 true
# - Security__KnownProxyNetworks= # 可信代理的 CIDR 列表,逗号分隔,例如 172.16.0.0/12
# - Security__TrustAllProxies=false # 暴露于公网的主机上永远不要设为 true
# - Security__ApiKeyPath=/data/security/api_key.txt
# --- 预填充(自动检测;仅在检测失败时才需要设置这些) ---
# - Prefill__LancacheIp=192.168.1.10 # 缓存服务器 IP;最可靠的覆盖项
# - Prefill__NetworkMode=auto # host、bridge、某个 Docker 网络名称,或 auto
# - Prefill__LancacheDnsIp=auto # DNS 服务器 IP;仅 bridge 模式
# - Prefill__SteamDockerImage=ghcr.io/regix1/steam-prefill-daemon:latest
# - Prefill__EpicDockerImage=ghcr.io/regix1/epic-prefill-daemon:latest
# - Prefill__BattlenetDockerImage=ghcr.io/regix1/battlenet-prefill-daemon:latest
# - Prefill__RiotDockerImage=ghcr.io/regix1/riot-prefill-daemon:latest
# - Prefill__XboxDockerImage=ghcr.io/regix1/xbox-prefill-daemon:latest
# - Prefill__SessionTimeoutMinutes=120 # 非持久预填充会话的生命周期
# - Prefill__StallTimeoutSeconds=180 # 高级设置:非持久会话的停滞超时
# - Prefill__AbandonedLoginTimeoutSeconds=900 # 高级设置:清理无人完成的登录
# - Prefill__DaemonBasePath=/data/prefill # 必须位于 /data 之下
# - Prefill__HostDataPath=auto # /data 对应的主机路径;仅检测失败时设置
# - Prefill__UseTcp=auto # auto = Windows 用 TCP,Linux 用 Unix 套接字
# - Prefill__TcpPort=45555 # 仅 TCP 模式
# - Prefill__HostTcpPort= # 仅 TCP 模式;留空会随机选择一个空闲端口
# - Prefill__TcpHost=127.0.0.1 # 仅 TCP 模式
# --- Nginx 日志轮转(需要挂载 docker.sock) ---
# - NginxLogRotation__Enabled=true
# - NginxLogRotation__ContainerName= # 留空或设为 "auto" 会查找 "lancache" 容器
# - NginxLogRotation__ScheduleHours=24
# --- API、优化、缓存快照 ---
# - ApiOptions__MaxClientsPerRequest=1000
# - ApiOptions__DefaultClientsLimit=100
# - CacheSnapshots__RetentionDays=90 # 缓存大小历史保留时长
# - CacheSnapshots__IntervalMinutes=60 # 高级设置:记录快照的频率
# - ASPNETCORE_URLS=http://+:80 # 内部绑定;保持默认即可
# --- 路径与数据源 ---
# - LanCache__EnvFilePath=/lancache/.env # 未设置 = 自动搜索常见位置
# - LanCache__AutoDiscoverDatasources=false # 扫描 /cache 和 /logs 下的匹配子目录,最多三层
# 多数据源会替代上面的 LogPath/CachePath。保持编号连续,
# 并按同样的方式添加更多:__2__、__3__……
# - LanCache__DataSources__0__Name=Default
# - LanCache__DataSources__0__CachePath=/cache
# - LanCache__DataSources__0__LogPath=/logs
# - LanCache__DataSources__0__Enabled=true
# - LanCache__DataSources__1__Name=Steam
# - LanCache__DataSources__1__CachePath=/steam-cache
# - LanCache__DataSources__1__LogPath=/steam-logs
# - LanCache__DataSources__1__Enabled=true
# --- 高级用户 ---
# - ConnectionStrings__DefaultConnection=Host=/var/run/postgresql;Database=lancache;Username=lancache;Maximum Pool Size=20;Minimum Pool Size=2 # 基础连接字符串;你同时设置的 POSTGRES_* 值会覆盖其中的用户/密码/主机/端口/数据库字段;若内嵌了密码则属于密钥
# - Logging__LogLevel__LancacheManager.Infrastructure.Platform=Debug # 任意日志分类;取值 Trace..None
从 1.10.3 升级? 现有的 Compose 文件可以照常使用;没有变量被重命名或移除。新增了四个可选变量:
| 变量 | 用途 |
|---|---|
Prefill__XboxDockerImage |
Xbox,第五个预填充平台 |
Prefill__StallTimeoutSeconds |
高级选项。预填充无进展可持续多久 |
Prefill__AbandonedLoginTimeoutSeconds |
高级选项。预填充登录可等待多久 |
LanCache__DataSources__<n>__SchemeOverride |
日志文件名让自动检测失效的裸机安装 |
可以删除 Security__MaxAdminDevices,当前版本不会读取它。