gongxiangp2/docs/统一流量访问规则.md

统一流量访问规则

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

1. 统一原则

• 公网用户统一走正式域名，不再自动切内网。
• 服务端访问 MinIO 继续走内网 192.168.58.20:9000。
• 展示型图片统一写入 /gongxiangpan/public-display/。
• /gongxiangpan/uploads/ 保留为混合区，不再默认承担展示资源职责。
• 180.97.215.57 已停用，不再作为正式资源入口或缓存入口。

2. 正式入口

场景	正式入口	说明
主站	https://sc.jiansun.vip	唯一正式主站入口
资源 / S3	https://s3.jiansun.vip	唯一正式资源入口
内网生产机	192.168.58.20	只给服务端和内网运维链路使用

3. 访问规则

3.1 公网用户

• 打开网站：走 https://sc.jiansun.vip
• 看图：走 https://s3.jiansun.vip/gongxiangpan/public-display/...
• 下载大文件：继续走业务下载接口或原有下载链路

3.2 内网服务端

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

3.3 内网用户

• 正式访问口径同样优先走正式域名
• 只有诊断、运维或服务端内部访问，才直接使用内网地址

4. 写入规则

内容	写入位置	是否进入展示缓存
白底图预览	/gongxiangpan/public-display/white-background/...	是
任务-详情预览	/gongxiangpan/public-display/task-detail/...	是
通用预览 / 展示图	/gongxiangpan/public-display/materials/...	是
历史混合对象	/gongxiangpan/uploads/...	否，默认不按展示缓存处理
压缩包 / 视频源文件 / 大下载对象	原业务路径	否

5. 展示资源规则

5.1 默认展示对象

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

5.2 明确不作为展示资源处理的对象

• 视频预览大文件
• 视频源文件
• 压缩包
• 其它下载型大文件

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 内容

8. 推荐排查顺序

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

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