Beego 保护私有静态资源必须用 beego.BeforeStatic 过滤器,因静态请求绕过 BeforeRouter;需正则匹配路径、手动校验 Referer 与会话,并配合 Nginx valid_referers 兜底。

Beego 框架本身不内置防盗链逻辑,所有 Referer 校验、Token 验证、路径权限控制都得靠你自己写过滤器或配合 Nginx 实现。直接依赖 beego.StaticDir 暴露 /static/ 目录,等于把图片资源大门敞开。
Beego 中静态资源请求绕过路由,BeforeRouter 过滤器完全无效
这是最常踩的坑:很多人在 beego.BeforeRouter 或 beego.BeforExec 里注册校验逻辑,结果对 /static/img/logo.png 这类请求毫无反应。
原因很直接:Beego 对匹配 StaticDir 的请求会跳过整个路由匹配和控制器执行流程,直接由静态文件处理器响应——你的过滤器根本没机会运行。
- ✅ 唯一有效的拦截点是
beego.BeforeStatic - ⚠️ 路径必须精确匹配静态资源路径前缀,比如
/static/users/:id([0-9]+)/private/* - ⚠️ 正则中的参数名建议用
:id,避免框架解析歧义(如:userId可能被截断) - ⚠️ 过滤器函数里要手动调用
ctx.Abort()并返回状态码,否则默认继续走静态文件流程
beego.BeforeStatic 过滤器里怎么校验 Referer?
Referer 校验不能只比对域名,得覆盖 none、blocked、HTTPS→HTTP 等真实场景。Beego 没提供现成白名单工具,得自己写。
- 用
ctx.Request.Referer()获取 Referer 字符串,注意它可能为空("")或为"about:blank" - 白名单建议存为全局
[]string,包含:"https://yourdomain.com"、"https://www.yourdomain.com"、"http://localhost:8080"(开发环境) - 不要用
strings.Contains粗暴匹配,防止evil-yourdomain.com误通过;用strings.HasPrefix或完整域名比对 - 对空 Referer 的策略要明确:直接放行(适合营销页)、拒绝(高安全要求)、或重定向到水印图
- 示例判断逻辑片段:
referer := ctx.Request.Referer()
if referer == "" {
// 根据业务决定是否允许空 Referer
ctx.Abort("403")
return
}
allowed := false
for _, domain := range whiteListDomains {
if strings.HasPrefix(referer, domain) || referer == domain {
allowed = true
break
}
}
if !allowed {
ctx.Abort("403")
return
}为什么光靠 Beego 过滤器防不住盗链?
因为前端可直接构造 URL 访问静态资源,绕过所有 Beego 中间件——只要你知道路径,curl https://yoursite.com/static/private/123/photo.jpg 就能触发。
- ✅ 必须配合 Nginx 的
valid_referers做兜底,例如:
location ~* \.(jpg|jpeg|png|gif)$ {
valid_referers none blocked *.yourdomain.com;
if ($invalid_referer) {
return 403;
}
}- ⚠️ Beego 生成的 Presigned URL(如对接 MinIO)不能暴露原始 bucket 名,要用反向代理统一前缀,比如
/cdn/photo.jpg→proxy_pass https://minio.internal/bucket/ - ⚠️ 不要给静态资源加 Token 参数再让 Beego 解析校验——这会破坏 HTTP 缓存,且 Token 易被日志或 CDN 缓存泄露
- 真正安全的路径级隔离,得靠 Beego
BeforeStatic+ Nginxvalid_referers+ 后端动态签发短时效 URL 三层组合
最容易被忽略的是 Referer 的空值与协议降级场景:从 HTTPS 页面跳到 HTTP 图片链接时,现代浏览器会清空 Referer;而某些隐私插件或企业防火墙也会主动剥离它。不显式处理这些 case,你的“防盗链”在真实用户眼里就是形同虚设。


















