跳转至

配置参考

本节是一份查询表。浏览标题,按需深入。真正涉及决策的两项设置各有专门的说明:数据库模式和预填充网络。

如果是常规安装,从代码仓库中的 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 密钥的账户。对其他所有账户隐藏,包括其会话。 清空账户、重新生成密钥
账户 登录后使用应用。可以看到其他普通账户,但只能更改自己的设置。不能看到主要账户及其会话。全局设置仅限管理员。 浏览下载、更改自己的设置
访客 通过访客会话查看。预填充是单独授予的:主要账户按平台授予,可以授予所有新访客,也可以只授予某一个会话。 浏览下载、统计、事件、客户端数据

要在不分享账户的情况下让其他用户进入:

  1. 在用户页面打开访客访问,并开启新访客可以登录。
  2. 访客在登录界面点击以访客身份继续。

会话时长,以及新访客是否获得预填充,都在用户页面的访客访问中设置。

每个页面和每项操作都需要已登录账户或一个访客会话。例外情况:

  • 除非你设置 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__ClientId
Security__Google__ClientId
Security__GitHub__ClientId
Security__Microsoft__ClientId
Security__Apple__ClientId
服务商应用注册中的客户端 ID。 (未设置)
Security__Oidc__ClientSecret
Security__Google__ClientSecret
Security__GitHub__ClientSecret
Security__Microsoft__ClientSecret
客户端密钥。建议使用 ClientSecretFile 形式,让密钥不出现在 Compose 文件中。Apple 没有客户端密钥,它使用下方的私钥。 (未设置)
Security__Oidc__ClientSecretFile
Security__Google__ClientSecretFile
Security__GitHub__ClientSecretFile
Security__Microsoft__ClientSecretFile
容器内保存客户端密钥的文件路径。 (未设置)
Security__Oidc__DisplayName
Security__Google__DisplayName
Security__GitHub__DisplayName
Security__Microsoft__DisplayName
Security__Apple__DisplayName
登录按钮上显示的名称。 (未设置)
Security__Oidc__AllowedSubjects
Security__Google__AllowedSubjects
Security__GitHub__AllowedSubjects
Security__Microsoft__AllowedSubjects
Security__Apple__AllowedSubjects
允许登录的服务商账户 ID,逗号分隔。见允许其他用户登录。 (未设置)
Security__Oidc__OwnerSubject
Security__Google__OwnerSubject
Security__GitHub__OwnerSubject
Security__Microsoft__OwnerSubject
Security__Apple__OwnerSubject
所有者的服务商账户 ID,所有者以主管理员身份登录。 (未设置)
Security__Oidc__OwnerIssuer
Security__Google__OwnerIssuer
Security__GitHub__OwnerIssuer
Security__Microsoft__OwnerIssuer
Security__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,当前版本不会读取它。