gongxiangp2/docs/素材库平台预览缓存方案.md

素材库平台预览缓存方案

更新时间：2026-04-29 状态：180.97.215.57 缓存入口已停用，本文保留历史方案和当前展示资源口径。

1. 当前口径

• 资源入口：s3.jiansun.vip -> 180.97.221.140
• 桶本体：192.168.58.20:9000
• 已停用缓存入口：180.97.215.57
• 旧缓存目录：/data/nginx-cache/s3，不再作为当前正式链路门禁
• 旧缓存上限：180g，只作为历史记录保留

2. 正式展示缓存路径

2.1 默认展示路径

• /gongxiangpan/public-display/

这里存放：

• 素材库卡片预览图
• 展示图
• 白底图预览
• 任务-详情主图 / SKU 图 / 详情图预览

2.2 继续保留的历史预览规则

• preview-*
• display-*
• model-*
• video-cover-*
• audio-cover-*
• pdf-preview-*
• product-package/main-preview-*
• product-package/sku-preview-*
• product-package/detail-preview-*

说明：

• 这些规则先保留，是为了兼容历史对象。
• 新写入展示图应优先走 public-display。

3. 明确不走展示缓存的对象

• /gongxiangpan/uploads/ 下的一般混合对象
• 视频大文件
• 压缩包
• 源文件下载

4. 历史缓存策略

• 下面规则属于 180.97.215.57 缓存方案的历史记录。
• 当前正式链路不再用 X-Cache-Status 作为排障门禁。
• 当前优先验证 s3.jiansun.vip -> 180.97.221.140 -> 192.168.58.20:9000 是否可达。

5. 历史验证结果

5.1 展示缓存命中

• https://s3.jiansun.vip/gongxiangpan/public-display/network-check/20260325-cache-test.png

  • 第一次：MISS
  • 第二次：HIT

• https://s3.jiansun.vip/gongxiangpan/public-display/network-check/limit-exact-10m-1774428109043.png

  • Content-Length: 10485760
  • 第一次：MISS
  • 第二次：HIT

5.2 大文件绕过

• https://s3.jiansun.vip/gongxiangpan/由壹点AI/video-preview-720p-9b1c86b6-0249-44ae-98fe-e480f5f5ac2c-1767153103562.mp4

  • 结果：BYPASS

• https://s3.jiansun.vip/gongxiangpan/public-display/network-check/limit-over-10m-1774428109043.png

  • Content-Length: 10485761
  • 第一次：BYPASS
  • 第二次：BYPASS

6. 使用建议

• 以后只要是“页面上要展示给人看”的成品图，就优先写 public-display
• 只要是“下载型、源文件型、大对象”，就不要硬塞进展示资源口径
• 对外说明时，统一写 s3.jiansun.vip，不要再把 s3.yydd.ai 当正式入口
• 排障时不要再默认检查 180.97.215.57，先检查 180.97.221.140 入口和 FRP 回源链路