固定媒体地址与CDN远程鉴权

当前阶段与最终方案

2026-11-20统一App媒体协议已部署:所有已认证App成功聚合响应及独立下载授权使用本页同一结构,不再通过X-Media-Delivery选择格式。不传、cdn-v1、oss-v1均按服务端当前配置和资源类型选择通道,响应不再回传能力头。产品尚未正式开放,本次按确认不保留旧App响应格式。公共头、Bearer、JWE、业务ID、原权限及保存方式保持。

统一媒体协议已在唯一正式部署环境生效,运行配置仍为dev。 该环境继续启用https://media.budyoo.cn、阿里云全球CDN、HTTPS、私有OSS回源和远程鉴权,App与后台CDN开关均为true;配置默认值仍为关闭,其他部署须显式配置。本次无新增数据库迁移、清库或桶权限变更;服务器与公网验证不等于Flutter设备验收,实际范围见下方记录。

阶段 transport url与expiresAt 媒体网络请求
CDN关闭、当前已审公开资源 OSS_PUBLIC 当前公开副本OSS地址,expiresAt=null 独立OSS HTTPS;requestHeaders为空,不发送媒体凭证
CDN关闭、私密/待审资源 OSS_SIGNED 当前OSS签名地址,expiresAt最长5分钟 独立OSS HTTPS;requestHeaders为空,不发送媒体凭证
服务端CDN已启用 CDN media.budyoo.cn+正式对象路径,同一版本地址固定,expiresAt=null 使用指定静态请求头,并附加独立媒体凭证;凭证会失效,文件地址不因此变化
默认头像等显式API资源 API 原API相对路径 沿原API身份及缓存规则
无权或暂不可用 NONE url=null DENIED/UNAVAILABLE,不使用历史地址或缓存绕过权限

“地址不过期”不代表权限永远有效。CDN每次联网读取,包括命中边缘缓存和视频Range,都先请求后台鉴权;后台重新检查真实会话、账号/设备/IP限制、注册/VIP准入、屏蔽、当前头像/相册/动态/明信片权限及请求对象是否匹配。退出、注销、会话失效、撤销可见性后拒绝后续联网请求,已下载内容无法远程回收。

mediaDelivery字段

mediaDelivery与data一起在原JWE响应内。原有URL字段仍可直接供页面使用;新增字段由统一媒体加载器处理,页面无需自行组装CDN路径。独立批量下载授权的data数组始终使用本页结构;该接口不再重复添加顶层mediaDelivery。不返回旧下载项delivery或单项message,顶层message保留四语规则。匿名、管理员、错误和二进制响应不进入本App聚合投影。

字段 类型/可空 含义
path string,非空 原业务媒体相对路径,用于按需授权与刷新,不是OSS路径
url string或null 当前真实可用的OSS、CDN或API地址
access string PUBLIC、PRIVATE、API、DENIED、UNAVAILABLE;PUBLIC表示业务已公开,不等于CDN源站匿名可读
expiresAt UTC时间或null OSS_SIGNED的地址期限;CDN地址为null,凭证期限单独读取
cacheKey string,非空 正式对象的不透明稳定键,与域名、签名和凭证无关;API及不可用条目为业务path;原样使用,不自行计算
cacheMaxAgeSeconds integer PUBLIC为86400;其他0,私密不落盘
code string SUCCESS、NOT_FOUND、FORBIDDEN、SERVICE_UNAVAILABLE等
transport string OSS_PUBLIC、OSS_SIGNED、CDN、API、NONE
requestHeaders object CDN为X-Budyoo-Media-Path: path;其他为空对象。只包含静态业务路径,不包含凭证
authorization object或null 仅CDN非空;含origin、headerName、credentialPath,其他通道为null
authorization.origin HTTPS源站字符串 允许附加媒体凭证的精确源,含协议与主机;不能只比较主机字符串前缀
authorization.headerName string 当前为X-Budyoo-Media-Token
authorization.credentialPath API相对路径 当前为/api/v1/media/credentials,使用原App身份与JWE调用

以下是合成对象示例,示例对象不存在;实际地址必须使用接口返回值:

{
  "path": "/api/v1/media/avatars/33333333-3333-4333-8333-333333333333",
  "url": "https://media.budyoo.cn/media/avatars/33333333-3333-4333-8333-333333333333.png",
  "access": "PRIVATE",
  "expiresAt": null,
  "cacheKey": "budyoo-media:v1:example-opaque-resource-key",
  "cacheMaxAgeSeconds": 0,
  "code": "SUCCESS",
  "transport": "CDN",
  "requestHeaders": {"X-Budyoo-Media-Path": "/api/v1/media/avatars/33333333-3333-4333-8333-333333333333"},
  "authorization": {
    "origin": "https://media.budyoo.cn",
    "headerName": "X-Budyoo-Media-Token",
    "credentialPath": "/api/v1/media/credentials"
  }
}

App凭证与缓存处理

以下为现有公共媒体加载组件的职责,业务页面只使用后台URL。CDN启停、域名、回源和地址生成由后台管理;不要求Flutter页面开启CDN,也不扩展现有鉴权协议。

  1. 首屏直接使用原业务接口返回的地址和交付项。拿到CDN条目后,先按当前业务可见性和cacheKey检查有效的公开缓存;有缓存不发文件请求,也不为此刷新凭证。私密仅当前账号和页面内存使用。
  2. 确实需要CDN联网读取时,复用当前账号内存中仍有效的媒体凭证;没有或临近失效时,调用申请媒体凭证。同账号并发加载合并为一次签发请求,无后台定时轮询,不按每张图片申请。
  3. 仅当transport=CDN且目标URL的origin与authorization.origin、凭证origin完全一致时,添加服务端给出的requestHeaders,并用headerName附加媒体token。不得把App登录Bearer、Cookie、JWE、公共头或CDN回调秘密发给媒体或OSS。不把媒体token提交给普通App API。
  4. CDN凭证最长一小时,退出、账号/会话变化可提前失效;它与App访问Token的十五分钟刷新独立。到期且需网络读取时自动更新一次;403最多重新签发并重试一次,再拒绝则停止,不能无限刷新或回退到旧OSS/API文件地址。
  5. PUBLIC缓存最长86400秒,源对象UUID不可覆盖,换文件自然换cacheKey;签名更新、换凭证或从OSS切CDN不清空已有有效公开缓存。新业务结果为下架、删除、屏蔽或无权时撤下显示。PRIVATE不写磁盘缓存,不将地址、凭证或字节写日志。
  6. 视频/语音仍使用分段或播放器按需读取;每个网络Range请求携带同一交付项的路径头和当前媒体凭证。界面退出、换号或注销清理凭证、私密内存及晚到回执。

媒体单项故障仍不推翻已经成功提交的资料/动态保存。原业务响应会将对应URL置null,并返回UNAVAILABLE,不应重复提交业务写入。

云端配套与迁移边界

真实CDN必须配置远程鉴权后再提供媒体访问:鉴权先于缓存,超时及其他未配置状态码均拒绝,鉴权结果不缓存放宽权限;CDN向私有OSS回源时去掉媒体token和业务路径头,仅使用云端受限回源身份。源对象路径与业务path必须在后台逐项匹配,不能只验token就放行整个桶。

此前云端上线按用户确认启用cdn-v1并保留OSS交付:已完成备案、媒体域名/HTTPS/CNAME、受限私有回源及全文件类型远程鉴权。HTTP会301跳转HTTPS,TLS仅允许1.2/1.3;远程鉴权3秒超时或非200均拒绝,回源使用HTTPS。边缘缓存最长一天,普通HTTP客户端收到Cache-Control: private, no-store;App显式公开缓存仍按mediaDelivery的业务规则处理。

现有media/public/*匿名GetObject按确认暂时保留,旧公开OSS直链仍可独立访问;私密源对象保持私有。因此当前不能声称全部媒体只能通过CDN访问。收敛公开前缀前必须完成Flutter真机与缓存验收,并确认边缘限频、流量告警及容量。本次已确认无需兼容旧App,但这不等于授权修改OSS桶权限或删除已有对象。CDN传输和HTTPS请求按云服务计费;鉴权不替代限流或费用控制。

2026-11-19已为媒体域名配置带宽、下行流量和边缘请求数三项云监控告警,并为CDN和OSS分别配置产品日费用预警。按用户确认只发送通知,未启用超限自动停用;分钟级用量告警与次日账单费用提醒均不构成费用硬上限。旧OSS直链不经过CDN域名监控,费用侧另由OSS产品预警覆盖。告警配置已回读验证,尚未通过制造超限流量验证短信实际送达。

统一协议在CDN关闭时仍可使用OSS_PUBLIC/OSS_SIGNED交付;客户端不能自行替换返回域名,CDN403也不能擅自绕回旧OSS地址。普通CDN远程鉴权仍向后台发起轻量权限请求;文件正文经CDN/OSS传输。ESA边缘JWT是另一种方案,当前未采购、配置或切换。

API与WebSocket的ESA接入不改变本媒体契约:api.budyoo.cn负责动态接口和/ws/v1/realtime,media.budyoo.cn继续使用本页的媒体CDN、远程鉴权和私有OSS回源。2026-11-20已切换API至ESA,并再次通过15项媒体鉴权回归,包含合成账号HTTPS/JWE登录、OSS直传、缓存命中后鉴权、跨账号与退出后拒绝、HEAD和Range;合成账号已通过正常注销清理。完整范围见安全状态。香港ECS仅规划为Google/FCM等服务端出站中转,仍按约定在业务开发完成后采购,不能作为媒体或用户API的替代域名。

依据:阿里云远程鉴权、私有Bucket回源、CDN域名备案要求。

验证范围

2026-11-17后端准备已发布,Flyway仍为48,无新增迁移;服务器全量1364项测试零失败/零错误,1项真实翻译条件跳过。新增25项覆盖固定地址与稳定缓存身份、真实JWE/Redis、凭证摘要与期限、退出/封禁/VIP/对象替换、跨对象拒绝及依赖故障拒绝;CDN开启分支使用隔离配置和云网络替身,不代表真实CDN通过。服务器同模板Nginx原50项及CDN关闭/隔离开启15项检查通过,附带JS/JWE公开示例18项服务器检查通过。

2026-11-17关闭模式经保留系统CA与主机名校验的HTTPS/JWE完成9项检查:OSS直传及确认、本人私密OSS直读/无签名拒绝、原JSON交付信息、签名变化而cacheKey保持、下载授权新结构、合法会话凭证404、关闭的CDN回调403、未选能力的旧字段以及已审公开OSS无期限地址。API媒体正文GET为0;合成账号经正常注销接口清理。

2026-11-19真实公网服务器验收15项通过:HTTPS/JWE登录与OSS上传确认、本人私密媒体读取、相同地址再次读取、实际边缘HIT、缓存命中后无凭证/伪造凭证/其他账号/路径对象不符/查询串变体拒绝、终端伪造可信回调头被覆盖、HEAD、Range 206、更新凭证保持url及cacheKey、旧OSS签名回退且无签名拒绝、退出后旧凭证读取已缓存文件拒绝。验收账号通过用途绑定的正常注销接口清理。本次仅调整云配置、运行环境与部署脚本,无Java业务或数据库迁移。

媒体独立证书已部署,Certbot DNS续期及CDN部署钩子的完整dry-run通过。运行值为MEDIA_CDN_ENABLED=true、MEDIA_CDN_ORIGIN=https://media.budyoo.cn。真实封禁/屏蔽/下架组合、视频播放器持续Range、容量、海外与移动网络设备链路未在本次重测;相关后端规则仍以既有自动测试为据。Flutter代码未修改,其设备验收由独立客户端任务完成;OSS公开前缀收敛仍待单独实施与验收。费用与用量告警已配置,自动停用按用户选择保持未启用。

统一协议验证

2026-11-20部署前源码验证在服务器独立Compose项目的临时PostgreSQL/Redis执行,使用真实控制器、JWE、会话、准入与领域权限,云签名/存储网络使用替身;当时没有切换正式应用。先执行完整clean test,再更新旧相对路径测试断言并定向复跑175项;最终报告汇总1390项、0失败、0错误、1项真实DeepSeek翻译因环境条件跳过。统一协议7项、CDN关闭同结构7项、接口文档映射与模块/包边界检查均通过。MD相对链接与113个JSON示例检查通过,15个聚合交付示例条目字段一致。

同日正式发布重新执行服务器clean verify:1390项、0失败、0错误、1项真实翻译条件跳过,Java打包与后台静态构建通过。发布前数据库与本地上传目录备份及校验完成,随后切换Java版本,应用健康、四语回退、401鉴权、Nginx语法、受信HTTPS与域名检查通过;配置仍为dev,没有新增迁移或执行清库。

北京时间2026-11-20 11:21后,经真实公网API/ESA、HTTPS/JWE、私有OSS及媒体CDN完成39项检查,全部通过:

  • 合成PNG上传确认、私密读取、真实缓存HIT、HEAD/Range;无能力头和两种废弃能力头返回相同结构,凭证刷新不改变URL及cacheKey;资料与首页聚合响应直接返回头像CDN地址。
  • 合成3秒H.264 MP4直传、OSS首帧PNG、重复确认及本人待审动态;视频完整字节与上传文件一致,缓存HIT、HEAD长度、起始/中间/尾段Range及Content-Range准确,上传确认和动态响应直接返回视频/封面URL。
  • 无凭证、伪造凭证、跨账号、路径错配、查询串和伪造回调头按预期处理;跨账号视频/封面授权返回DENIED/NONE/null,缓存命中后仍鉴权;退出后旧凭证以及删除动态后的旧视频/封面地址均拒绝读取。
  • 后台授权接口拒绝无管理员Cookie和仅持App凭证的请求;精确后台来源的CDN预检通过,实际无媒体凭证读取仍拒绝。后台正向管理员权限、会话撤销和对象归属由本次全量回归覆盖;本次没有登录管理员或验证后台浏览器视频播放器。

两个合成账号均通过用途绑定的二次验证完成注销,数据库核查身份、会话、头像、视频及动态业务引用均为0;两个头像、视频和首帧共4个正式OSS对象均已返回404。3个原始直传暂存对象保留无身份的取消记录,按既有“签名失效后一小时”宽限自动回收,没有跳过防止旧PUT重建对象的等待窗口。未公开批准合成资料或动态,也未操作真实用户内容。

发布后另通过公网HTTPS健康、动态API不缓存、未认证用户/CDN回调拒绝、ESA真实IP与源站伪造头拒绝,以及WSS握手/无效票据拒绝。Flutter真机播放器、磁盘缓存、完整封禁/屏蔽组合、容量与海外移动网络仍待验收;本次没有切换线上CDN开关来测试OSS回退,CDN关闭分支以服务器隔离回归为准。

本轮覆盖无能力头/cdn-v1/oss-v1均使用同结构,CDN开启与关闭、公开OSS与私密签名、API默认头像、逐项拒绝与整批故障、已提交保存的媒体软失败,以及匿名/管理员/错误/二进制边界。原CDN凭证、远程鉴权、Range、退出/封禁/VIP与对象匹配继续回归。新协议未在真实线上服务或Flutter设备验收。客户端对话已报告源码同步:删除dev/prod的CDN打包开关和能力头、统一解析聚合及downloads、保留公共加载组件鉴权,425项回归及43项补测通过;该客户端报告不计入上述Java测试数量,也不表示已构建或发布。后续先部署对应Java版本,再安排客户端设备联调;最终字段维持本页契约。

管理后台

后台另走申请后台媒体下载,不使用App媒体凭证。管理员Cookie、CSRF与JWE只发送到后台;CDN使用五分钟单文件授权,每次GET/HEAD重新检查当前会话、权限及对象归属。图片和音视频正文由CDN返回,上传与审核流程保持原样。数据库图标和未迁移的历史图片明确走API兼容交付。后台CORS仅允许配置中的后台来源,文件URL不含凭证。