网站静态资源 CDN¶
官网、管理后台和文档站共用独立的公开资源域名 https://static.budyoo.cn,通过阿里云 ESA 全球节点分发图片、字体、CSS、JavaScript 和官网语言包。三个站点的页面地址保持不变:
| 站点 | 页面入口 | CDN 资源路径 |
|---|---|---|
| 官网 | https://budyoo.cn/ | /site-assets/official/<内容版本>/ |
| 管理后台 | https://admin.budyoo.cn/admin/ | /site-assets/admin/assets/<带内容哈希的文件名> |
| 接口文档 | https://docs.budyoo.cn/docs/ | /site-assets/docs/<内容版本>/assets/ |
www.budyoo.cn继续跳转官网主域。官网根域的邮件解析不受静态资源域名影响。HTML 和后台 API 仍由各自原域名提供,后台 API 与页面保持同源;api.budyoo.cn 的动态 API/WSS 继续使用独立的不缓存规则。
缓存与发布¶
公开资源成功响应使用 Cache-Control: public, max-age=31536000, immutable、Access-Control-Allow-Origin: * 和 X-Content-Type-Options: nosniff,不设置应用会话 Cookie。ESA可能附加自身的acw_tc/cdn_sec_tc防护Cookie,它们不代表App或管理员身份。资源只允许读取,不接收上传或业务写操作。边缘缓存状态以X-Site-Cache-Status为准。
发布先上传完整资源,再切换引用它们的 HTML。官网与文档主题按内容摘要生成新目录,后台构建文件名含内容哈希;同一路径不能覆盖为不同内容,旧资源保留供已打开页面和版本回退使用。普通发布无需清空 CDN 缓存。后台 HTML 保持 no-store;静态域名的非资源路径绕过缓存,资源路径的 4xx/5xx 不做边缘缓存。
官网语言包和动态示例图片也使用当前页面的资源版本。文档正文、页面导航和接口示例地址保持原契约,文档主题资源从 CDN 加载。
公开内容与权限¶
静态资源包括后台登录页所需代码和图标,其公开下载不授予管理员权限。管理员 Cookie、CSRF、公共请求头和 JWE 仍由原后台 API 校验;CSP 只加入明确的静态域名。CDN 资源请求不携带管理员会话,详见后台登录与安全。
static.budyoo.cn不存放用户头像、相册、视频、聊天附件、会话凭据或运行配置。业务媒体继续使用 media.budyoo.cn 和媒体远程鉴权,不能改成公开静态地址。发布工具仅收集约定资源目录,拒绝隐藏文件、符号链接、源码映射和未允许的文件类型。
当前验收范围¶
2026-11-20已完成部署并通过以下验证:
- 使用系统CA和主机名验证静态域名HTTPS,实际协商TLS 1.3;边缘证书有效至北京时间2027-02-18 11:01:36。
- 官网55个、后台187个、文档主题6个,共248个当前版本资源逐个与服务器发布产物比对一致;图片、字体、CSS、JavaScript、语言包等15项抽样均观测到ESA缓存HIT,三个站点的HEAD和Range通过。
- 资源缓存、CORS、nosniff及Cookie边界符合上文;后台HTML保持
no-store且CSP允许明确的静态域名。静态域名的管理员API、隐藏路径、缺失资源和运行配置路径均拒绝且未命中缓存,POST写方法拒绝。 - 通过完整元数据和真实JWE验证匿名、伪造App Bearer、伪造管理员Cookie三种请求均返回401/
UNAUTHORIZED,并通过加密响应认证;缺少JWE返回400/ENCRYPTION_REQUIRED。API健康为UP。 - 浏览器完成官网六语切换、通话示例动态图像、后台既有会话恢复及页面加载、文档深层导航与主题交互检查;未发现资源加载或控制台错误。服务器发布/配置单元检查14项通过,后台类型检查和构建、MkDocs严格构建、Nginx检查通过。
部署环境仍是唯一正式环境、上线前阶段,Java实际运行配置仍为dev。本次不修改Flutter,不改变App媒体协议,不重启Java业务容器,也不代表真实供应商、Flutter真机或App正式开放验收;未做容量压测或海外移动网络全覆盖测试。证书托管续期已配置,首次签发不代替后续续期验收。