业务赋能中心
外网预览与上传链路
外网 480p 视频预览、统一媒体入口、地区网关路由、分片上传和资源登记说明。
功能定位
外网预览与上传 用于让不在办公室网络内的人员完成受控审片和上传交付。
它只解决两件事：
- 外网播放低码率预览，用于审片、评论、修改建议和审批。
- 外网原片上传落盘，最终文件仍进入办公室共享盘和本地网关管理范围。
它不是公开视频分发平台，也不是把素材长期缓存到云端。
架构边界
当前视频文件主数据面仍在办公室共享盘，由本地网关读取、预览、上传落盘和下载。
外网访问时，链路按这个方向工作：
外网浏览器
-> 云端鉴权和票据签发
-> media.studiox-mkt.com
-> ECS 反向代理
-> Tailscale 组网
-> 地区 local-gateway
-> 办公室共享盘云端负责账号、权限、元数据、票据、审计和协作流程；ECS 只做公网入口和转发，不保存视频文件；本地网关继续负责签名校验、Range 响应、路径约束和文件读取。
外网预览
外网预览默认播放本地网关生成的 480p 低码率预览文件。这样可以让外出编导、运营或客户服务人员完成审片和评论，但不把外网播放体验当作最终画质验收依据。
业务规则：
- 外网默认走 480p 预览，不承诺外网原片播放体验。
- 评论、修改建议和审批动作绑定原始资源和时间码，不绑定预览文件。
- 480p 预览生成应异步执行，不阻塞上传、入库和审核。
- 外网预览失败时，不影响办公室内网预览和本地网关原有链路。
地区路由
外网媒体 URL 使用统一入口：
https://media.studiox-mkt.com/gw/{gateway_route}/api/video-collab/local/preview?payload=...gateway_route 使用地区短名，例如 shanghai、changsha、hangzhou。它不是让用户手工选择地区，而是云端根据资源的网关归属字段签发出来的代理路由。
路由原则：
- 优先使用资源记录中的 primary gateway。
- primary gateway 在线时，预览和下载优先走 primary gateway。
- primary gateway 离线时，只有确认其他网关已同步该文件或预览文件，才允许 fallback。
- 没有可用网关时，提示外网预览暂不可用，网关离线或文件同步中。
外网上传
外网上传落盘的是原片，不是 480p 预览文件。
当前推荐方式是浏览器分片断点续传：
- 云端校验账号、权限、业务归属和目标资源类型。
- 云端签发上传票据，明确目标网关和上传会话。
- 浏览器把分片发送到统一媒体入口。
- ECS 透传到目标地区本地网关。
- 本地网关在共享盘合并原片。
- 云端登记资源元数据、路径、大小、哈希和业务来源。
ECS 不承担视频缓存池，也不把上传文件长期落盘。
常见异常
外网预览打不开
优先检查：
- 资源是否已经有可用 480p 预览。
- 资源绑定的 primary gateway 是否在线。
media.studiox-mkt.com到对应地区网关的组网链路是否可达。- 签名票据是否过期。
- 目标文件是否已经同步到可承接的网关。
外网播放很慢
优先检查：
- 是否命中 480p 预览，而不是误走原片。
- ECS 反向代理是否对
/gw/媒体链路继承了限速配置。 - 地区本地网关的上传带宽、磁盘读取和 Range 响应是否正常。
上传完成但资源库看不到
优先检查：
- 上传 session 是否完成合并。
- 云端资源登记回调是否成功。
- 当前账号是否有目标目录或部门数据权限。
- 共享盘路径是否可写，文件大小和哈希是否回写。
某地区能预览，另一个地区不能
优先看资源的 primary gateway 和同步状态。多地区共享并不代表每个网关都已经拥有同一个文件或预览缓存。