# 网络拓扑文档

> 更新时间：2026-07-09
> 本文只记录当前正式口径，不再把历史旁路和备用域名混进默认方案。

## 1. 正式入口

- 主站：`sc.jiansun.vip -> 218.93.9.38`
- 资源 / S3：`s3.jiansun.vip -> 218.93.9.38`
- 内网生产机：`192.168.58.20`
- 当前公网入口机：新穿透服务器 `218.93.9.38`
- 历史入口：`103.118.245.6` 不再作为当前默认排障入口。
- 已停用入口：`180.97.215.57` 不再作为正式资源入口或缓存入口使用。
- 历史入口：`180.97.221.140`、`156.239.227.105` 不再作为当前默认排障入口。

## 2. 当前正式链路

### 2.1 主站

```text
公网用户
  -> https://sc.jiansun.vip
  -> 218.93.9.38
  -> nginx
  -> 127.0.0.1:2321
  -> FRP 专用入口
  -> 192.168.58.20:4320
```

说明：

- 主站公网入口只认 `sc.jiansun.vip`。
- 首页自动切到 `192.168.58.20:4320` 的逻辑已经下线。
- `180.97.221.140:2320` 不再作为正式入口链路的一部分。
- `sc.jiansun.vip` 的 nginx 必须放开大文件上传：`client_max_body_size 2048m`，并设置较长 `proxy_read_timeout` / `proxy_send_timeout`。2026-05-07 曾因该配置缺失导致 `/api/materials/upload/chunk` 50MB 分片被 nginx 直接返回 `413`，表现为素材上传一直卡住。
- 当前前端分片策略是内网 20MB / 2 并发，公网 10MB / 1 并发；公网不要再默认使用 50MB 大分片，否则会放大 nginx + FRP 链路抖动下的 `499` / `502` 和上传 100% 后长时间等待问题。

### 2.2 资源 / S3

```text
公网用户
  -> https://s3.jiansun.vip
  -> 218.93.9.38
  -> nginx
  -> 127.0.0.1:2323
  -> FRP
  -> 192.168.58.20:9000
```

说明：

- `180.97.215.57` 已停用，不再作为 `s3.jiansun.vip` 的正式链路。
- 当前资源域名和主站域名都收敛到 `218.93.9.38` 入口机。
- `s3.jiansun.vip` 是否命中缓存不再作为当前正式验证标准，先以域名可达、FRP 可达、MinIO 回源可达为准。
- `s3.yydd.ai` 不再作为正式资源入口。

## 3. 展示资源口径

### 3.1 正式展示前缀

- 正式展示图统一落到：`/gongxiangpan/public-display/`

当前应走这个前缀的对象包括：

- 白底图预览
- 任务-详情主图 / SKU 图 / 详情图预览
- 素材库通用预览图、展示图、模特图等展示型图片
- AI 生图平台最终对外展示图

### 3.2 不再默认承担展示资源的路径

- `/gongxiangpan/uploads/`

说明：

- `uploads` 保留为混合区和历史兼容区。
- 首期不做历史对象全量迁移。
- 新生成展示图直接写 `public-display`，不再指望 `uploads` 承担正式展示路径。

### 3.3 不纳入 `public-display` 展示图/缓存规则的大对象

视频预览、预览片段和封面仍然会写入 S3 并通过对应的媒体 URL 提供播放；本节只说明它们不使用图片展示资源的 `public-display` 前缀和缓存规则。

- 视频源文件（canonical 源仍在生产机 uploads/NAS）
- 视频预览大文件（对象仍在 S3，但不走 `public-display` 前缀）
- 压缩包
- 其它下载型源文件

## 4. 已完成的入口收口

### 4.1 `218.93.9.38`

- 主站 `nginx upstream` 使用 `127.0.0.1:2321`
- 资源 / S3 `nginx upstream` 使用 `127.0.0.1:2323`
- FRPS 服务：`frps-jiansun-entry`
- FRPS 端口：`7002`
- 入口配置：`/etc/nginx/conf.d/cutover-legacy.conf`
- FRPS 配置：`/opt/frp/frps-jiansun-entry.toml`
- FRPS 日志：`/var/log/frps-jiansun-entry.log`

### 4.2 `180.97.221.140`

- 旧 `127.0.0.1:2320 backup` 已移除
- `frps` 已不再开放 `2320` / `2330`
- 防火墙已移除 `2320/tcp` 和 `2330/tcp`
- 不再作为当前默认公网入口。

### 4.3 `192.168.58.20`

- `/etc/frp/frpc.toml` 中旧 `2320 -> 4320`、`2330 -> 9000` 映射已移除
- `frpc-sc-entry` 仍保留正式主站 `2321 -> 4320`
- `frpc-s3-jiansun-entry` 保留正式资源入口 `2323 -> 9000`
- `frpc-s3-entry` 面向 `180.97.215.57` 的旧资源入口不再作为正式链路使用
- `frpc-sc-health-check` 必须检查 `218.93.9.38:7002`
  - 2026-05-07 曾因 `/root/frp/frpc-sc-health-check.sh` 仍检查旧入口 `156.239.227.105:7002`，误判正式 `frpc-sc-entry` 异常并约每 70 秒重启一次，导致公网上传从 `413` 修复后继续出现 `502`、`499`、`408` 和卡住。
  - 2026-07-09 当前正式入口已切到 `218.93.9.38`，不要再沿用旧入口判断健康状态。

### 4.4 `180.97.215.57`

- 已停用，不再作为 `s3.jiansun.vip` 的正式入口。
- 相关 `180G` nginx 磁盘缓存方案只作为历史记录保留，不再作为当前上线或排障门禁。

## 5. 当前验证标准

### 5.1 主站

- `https://sc.jiansun.vip` 应能通过 `218.93.9.38 -> nginx -> 127.0.0.1:2321 -> FRP -> 192.168.58.20:4320` 返回页面。
- 如果公网直接超时，优先检查 `218.93.9.38` 的公网可达性、`nginx`、`frps-jiansun-entry` 和生产机 `frpc-sc-entry`。
- 上传排障要同时看 `218.93.9.38:/var/log/nginx/error.log`，如果出现 `client intended to send too large body`，说明入口机 `sc.jiansun.vip` 的上传 body 限制配置丢失或未生效。
- 如果不再出现 `413`，但 `/api/materials/upload/chunk` 仍出现 `502`、`499`、`408`，继续检查生产机 `frpc-sc-health-check.service` 是否又用旧入口误判并重启 `frpc-sc-entry.service`。

### 5.2 资源 / S3

- `https://s3.jiansun.vip` 应能通过 `218.93.9.38 -> nginx -> 127.0.0.1:2323 -> FRP -> 192.168.58.20:9000` 回源。
- 不再使用 `180.97.215.57` 或 `127.0.0.1:29000` 作为正式资源验证链路。

### 5.3 历史缓存验证

- 过去关于 `X-Cache-Status: MISS/HIT/BYPASS` 的验证结果属于 `180.97.215.57` 缓存方案历史记录。
- 当前排障不要再把 `180.97.215.57` 缓存层作为默认检查项。

## 6. 当前对外说明口径

- 主站统一写：`https://sc.jiansun.vip`
- 资源统一写：`https://s3.jiansun.vip`
- 展示资源统一写：`https://s3.jiansun.vip/gongxiangpan/public-display/...`

不要再把下面这些写成正式入口：

- `s3.yydd.ai`
- `http://180.97.221.140:2320`
- `http://180.97.221.140:2330`
- `http://156.239.227.105:7002`
- `http://192.168.58.20:4320`
- `http://180.97.215.57`

## 7. 建议验证命令

```bash
# 主站
curl -I https://sc.jiansun.vip

# 展示资源
curl -I https://s3.jiansun.vip/gongxiangpan/public-display/network-check/20260325-cache-test.png

# 大文件访问
curl -I https://s3.jiansun.vip/gongxiangpan/由壹点AI/video-preview-720p-9b1c86b6-0249-44ae-98fe-e480f5f5ac2c-1767153103562.mp4
```