WuYongJie/gongxiangp2
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
gongxiangp2/docs/统一流量访问规则.md
chenpei 7326e273e1 fix: harden media upload and release safety 
Protect upload cleanup and atomic completion paths, add durable media worker leases and brand asset validation, and introduce verified migration/bootstrap/deployment gates.
2026-08-12 18:04:08 +08:00

4.8 KiB
Raw Blame History

统一流量访问规则

更新时间：2026-07-09 目标：统一正式入口、展示资源口径和内外网分工，减少历史残留带来的分流与误判。

1. 统一原则

  • 公网用户统一走正式域名，不再自动切内网。
  • 服务端访问 MinIO 继续走内网 192.168.58.20:9000。
  • 展示型图片统一写入 /gongxiangpan/public-display/。
  • /gongxiangpan/uploads/ 保留为混合区，不再默认承担展示资源职责。
  • 源文件 / 下载型文件默认落在生产机独立 ZFS uploads 数据集：/mnt/PoolOne/youyidian-uploads。
  • 1080p.hk 旧桶只用于极少数老素材兼容，不作为新素材写入目标。
  • 180.97.215.57 已停用，不再作为正式资源入口或缓存入口。

2. 正式入口

场景 正式入口 说明
主站 https://sc.jiansun.vip 唯一正式主站入口
资源 / S3 https://s3.jiansun.vip 唯一正式资源入口
当前公网入口机 218.93.9.38 主站和资源域名当前都解析到这台入口机
内网生产机 192.168.58.20 只给服务端和内网运维链路使用

3. 访问规则

3.1 公网用户

  • 打开网站：走 https://sc.jiansun.vip
  • 看展示图：走 https://s3.jiansun.vip/gongxiangpan/public-display/...
  • 看视频预览 / 片段 / 封面：走 S3 中对应的媒体 URL，不要求位于 public-display
  • 下载大文件：继续走业务下载接口或原有下载链路

3.2 内网服务端

  • 上传到 MinIO：走 http://192.168.58.20:9000
  • 下载 MinIO 对象：走 http://192.168.58.20:9000
  • 不通过公网域名回自己

3.3 内网用户

  • 正式访问口径同样优先走正式域名
  • 只有诊断、运维或服务端内部访问，才直接使用内网地址
  • 媒体资源返回值会按代码做内外网改写；内网请求仍可能拿到 SERVER_IP:MINIO_API_PORT、/uploads/... 或 /api/uploads/... 这类内网/本机链路。

4. 写入规则

内容 写入位置 是否进入展示缓存
白底图预览 /gongxiangpan/public-display/white-background/... 是
任务-详情预览 /gongxiangpan/public-display/task-detail/... 是
通用预览 / 展示图 /gongxiangpan/public-display/materials/... 是
Header / 登录 Logo 仓库内置 /brand/...；可选当前桶 gongxiangpan/由壹点AI/... 是
历史混合对象 /gongxiangpan/uploads/... 否，默认不按展示缓存处理
视频预览 / 片段 / 封面 S3 gongxiangpan/由壹点AI/...（不走 public-display） 否，按媒体预览规则访问
压缩包 / 视频源文件 / 大下载对象 生产机 uploads 目录 否

5. 展示资源规则

5.1 默认展示对象

  • /gongxiangpan/public-display/ 下的图片对象
  • 现有素材库预览图
  • 现有 product-package/*-preview 图片对象

5.2 不纳入 public-display 展示图/缓存规则的对象

  • 视频预览大文件（对象仍在 S3，通过媒体预览 URL 访问）
  • 视频源文件（canonical 源仍在生产机 uploads/NAS）
  • 压缩包
  • 其它下载型大文件

6. 已下线或不再使用的口径

  • 首页自动探测并跳转 192.168.58.20:4320
  • s3.yydd.ai 作为正式资源域名
  • 180.97.221.140:2320 作为正式应用入口
  • 180.97.221.140:2330 作为正式 MinIO 入口
  • 180.97.215.57 作为正式资源入口或缓存入口

7. 当前验证标准

7.1 展示资源

  • 请求 https://s3.jiansun.vip/gongxiangpan/public-display/...
  • 结果应能正常返回资源或明确的对象不存在状态，不再要求 X-Cache-Status: HIT

7.2 大文件

  • 请求 Content-Length > 10MB 的展示图、视频大文件或压缩包
  • 不再以 X-Cache-Status: BYPASS 作为当前正式门禁

7.3 主站入口

  • 打开 https://sc.jiansun.vip
  • 不再自动跳到 192.168.58.20:4320

7.4 历史旁路

  • 2320 / 2330 不再返回正式应用或正式 MinIO 内容

7.5 品牌资源

  • Header、登录页和 favicon 在远端对象不可用时必须回退到镜像内 /brand/... 的可见图片，不能返回透明像素冒充成功。
  • 系统设置数据库只能保存 /brand/... 或 https://s3.jiansun.vip/gongxiangpan/...，不得保存代理包装地址、旧域名或第三方地址。
  • 后台“恢复默认”、Schema 默认值、设置行自动创建都必须回到本地品牌资源。

8. 推荐排查顺序

当用户反馈“公网慢”时，先按下面顺序判断：

  1. 是主站慢，还是资源图慢。
  2. 如果是资源图慢，先看链接是不是 s3.jiansun.vip。
  3. 再看路径是不是 /gongxiangpan/public-display/。
  4. 再看 s3.jiansun.vip 是否解析到当前正式入口 218.93.9.38。
  5. 最后再看 218.93.9.38 -> 127.0.0.1:2323 -> 192.168.58.20:9000 回源链路。