Beego项目CDN加速需三步：构建时将/static/路径替换为CDN域名（模板或前端工具配置）、Nginx为静态文件添加immutable缓存头、避免使用BeforeStatic等源站逻辑；否则仍直连源站。
Beego 项目要走 CDN 加速静态资源，核心不是改 Go 代码，而是改构建输出路径 + Nginx 缓存头 + DNS 解析三处，否则 beego.ServeStatic 或 /static/ 路由仍直连源站。
Beego 构建时如何让静态资源 URL 指向 CDN 域名
Beego 本身不处理前端资源的 URL 生成逻辑，它只负责服务已存在的文件。真正决定浏览器请求哪个地址的，是 HTML/CSS/JS 中写的路径。所以必须在构建或模板渲染阶段替换掉 /static/ 前缀。
- 若用 Beego 模板（
.tpl），在app.conf中加配置项：cdn_url = "https://static.example.com"，然后模板里写<link rel="stylesheet" href="%7B%7B.cdn_url%7D%7D/css/app.css"> - 若用 Webpack/Vite 等前端构建工具，需在
output.publicPath（Webpack）或base（Vite）中设为"https://static.example.com/"，确保所有import './logo.png'生成的 URL 都带 CDN 域名 - 切勿依赖 Beego 的
beego.SetStaticPath("/static", "static")来“自动切换”，它只影响源站本地服务路径，对浏览器发出的请求地址毫无影响
Nginx 必须为静态资源加 immutable + expires 头
CDN 和浏览器能否长期缓存，取决于响应头是否明确声明“该资源不可变”。Beego 默认不加 Cache-Control: public, immutable，必须在 Nginx 层补上，否则 CDN 节点可能忽略缓存或频繁回源。
- 在 Nginx 的
server块中添加 location 匹配规则，**不能放在 Beego 的反向代理块内**：location ~* \.(js|css|png|jpg|gif|woff2|ttf|eot|svg|webp)$ { expires 1y; add_header Cache-Control "public, immutable"; add_header X-Content-Type-Options nosniff; try_files $uri =404; } - 注意：这个 location 必须作用于实际文件系统路径（如
root /var/www/myapp/static;），而不是转发给 Beego 应用；否则 Beego 会接管并返回无缓存头的响应 - 如果静态资源由 Beego 动态生成（比如带参数的图片缩略图），则不能加
immutable，应改用短 TTL + ETag 协商
Beego 的 BeforeStatic 过滤器和 CDN 不兼容
Beego 的 beego.BeforeStatic 是为源站鉴权设计的，它在 Nginx 尚未介入前就由 Go 进程处理请求。一旦你把静态资源全量交给 CDN，用户请求根本不会到达 Beego 进程 —— 请求被 CDN 边缘节点直接响应了。此时 BeforeStatic 完全失效。
- 私有静态资源（如用户上传的 PDF）若需鉴权，有两种选择：
– 用 CDN 的 Referer 白名单 + 签名 URL（推荐）
– 或保留部分路径不走 CDN，例如将私有资源放在/private/下，Nginx 不 proxy_pass 给 Beego，而是用auth_request模块做前置校验 -
beego.BeforeStatic只适用于「静态资源仍由 Beego 服务，且需运行时权限判断」的极少数场景，与 CDN 加速目标天然冲突 - 常见错误：开发者在
BeforeStatic里写了 session 校验，又把/static/全部 CNAME 到 CDN，结果权限逻辑彻底失活，还查不出原因
最容易被忽略的一点：CDN 缓存键（cache key）默认忽略 URL 参数和部分 Header。如果你的 JS 文件用了 app.js?v=1.2.3 这种方式更新，而 CDN 缓存规则没开启「忽略查询参数」，就会导致每次 v 变更都算新资源、旧缓存无法复用。务必在 CDN 控制台把 .js 类型的缓存策略设为「忽略 URL 参数」或「基于文件哈希重命名」（如 app.a1b2c3.js）。
