制品缓存 · 上游

客户端把包管理器指向左侧的「下游地址」并携带账号 API Key,网关校验 Key 后按本表配置转发到上游、把响应落到本地磁盘缓存(命中不再回源)。 一个生态可能有两个上游:例如 crates.io 的索引在 index.crates.io、而 .crate 包本体在 static.crates.io,所以要分开配 /cargo/ 与 /cargo-dl/。 「凭据」填完整的 Authorization 头值(如 Bearer xxx),留空则透传客户端自带的 Authorization;网关自己的 sk_ 始终不会传给上游。 停用某个路由,对客户端表现为 503 上游未配置。
生态路由 / 下游地址上游地址凭据状态操作

容量与淘汰

数字直接读自 nginx 自己的缓存记账(proxy_cache_path 的共享内存),口径与淘汰动作同源 —— 「这里显示 91%」与「nginx 正在淘汰」说的是同一件事,不是扫盘估算。 上限来自 conf 的 max_size(默认每生态 50g、docker 200g),超了按 LRU 自动淘汰;inactive 到期的条目也会被清掉。淘汰是渐进的(cache manager 每秒一轮),短时猛灌可短暂超过上限再收敛,它不是硬配额。
「盘点磁盘」会把真实占用也列出来:两者差额是 nginx 还没回收的条目(手工清过缓存文件后会明显偏大,节点要等再被访问或到期才释放)—— 差多少就照实显示,不替你对平。
另一条容易漏掉的轴是索引内存(keys_zone:条目元数据住这里,不占磁盘)。它吃紧时 nginx 会改按条目数强制回收,看板上的「索引吃紧」标记就是它 —— 该扩 keys_zone 了。
「清空」只删缓存文件、保留目录:手工 rm 掉 cache/<生态> 目录会让该路由此后每次写缓存都失败并断开客户端(直到 restart),这个坑踩过,所以清理必须由网关来做。
缓存区磁盘目录占用 / 上限 条目数索引内存状态操作
按制品失效

命中计数

来自网关共享内存的运行期读数(按生态 × $upstream_cache_status,含跨生态汇总行 global)。 只统计真的进了缓存层的请求;被鉴权拦下或上游连不上的请求不计入分母。网关重启读数归零,但磁盘上的缓存文件仍在(命中不会因此变回 MISS)。
生态HITMISSBYPASSEXPIREDREVALIDATEDUPDATINGSTALE命中率

nginx 变量契约

下面这几个变量由网关模块按「上游表 + 请求 URI」实时算出,nginx 配置里直接引用即可。 改上游地址/凭据不需要改 conf、也不需要 reload —— 变量每次求值都读共享内存。
变量含义