宝塔面板防盗链误伤自家CDN:白名单与空Referer放行

    发布时间:2026-10-01 05:00 更新时间:2026-10-01 05:00 阅读量:14

    给站点开了防盗链,本意是拦住外站盗用图片和下载资源,结果上线没多久就有用户反馈图片全裂、附件下载变成 403。登录服务器一看,源站日志里被拒的请求大多来自自家 CDN 的回源节点——防盗链把「自己人」也拦了。这类问题在宝塔面板里特别常见,因为面板提供了一个勾选框式的防盗链开关,默认规则对 CDN 场景并不友好,而面板界面又不会提示你回源请求长什么样。

    下面从 Referer 校验的原理讲起,把 CDN 回源时 Referer 的几种形态拆开,再给出白名单、空 Referer 放行和验证的完整做法。读完你应该能自己判断:这次拦截到底该放行谁,规则写在哪一层最合适。

    防盗链是怎么判断的,为什么 CDN 会被误伤

    防盗链的核心逻辑很朴素:浏览器请求一张图片时,会在请求头里带上 Referer,表示「我是从哪个页面点过来的」。Nginx 用 valid_referers 指令把这个头拿来比对,不在名单里的就返回 403。宝塔面板的防盗链开关,本质上就是往站点的 Nginx 配置文件里写了一段 valid_referers 规则,把允许的域名填进去。

    问题出在 CDN 这一层。用户访问的是 CDN 边缘节点,节点发现本地没有缓存,才回源到你的服务器取文件。这次回源请求是节点发起的,Referer 头取决于 CDN 厂商的配置,常见有三种形态:

    第一种,节点把原始请求的 Referer 原样转发给源站,比如用户从 https://www.example.com/a.html 请求图片,回源时 Referer 也是这个地址,这种最省事,白名单填自己的域名即可。第二种,节点把 Referer 清空,回源请求里根本没有这个头,Nginx 看到的就是空 Referer,默认会被 valid_referers 拦掉。第三种,部分厂商会改写 Referer,填成节点域名或厂商内部标识,这种就必须把对应域名加进白名单。

    所以排查的第一步不是改配置,而是先确认回源请求到底带不带 Referer、带的是什么。具体行为以你所用的 CDN 厂商官方文档为准,不同厂商、不同套餐甚至不同加速域名的默认策略都可能不一样。

    白名单、空 Referer 与放行规则怎么写

    先看怎么确认回源请求的特征。在源站抓一次真实回源,比对着文档猜靠谱得多。可以在服务器上临时抓包,或者直接看 Nginx 访问日志里被拒的请求,重点看 Referer 字段:

    # 查看近期被防盗链拦截的请求(403 且带 referer 信息)
    tail -n 500 /www/wwwlogs/example.com.log | awk '$9==403'
    
    

    只看 Referer 字段,统计出现过的来源

    awk '$9==403 {print $11}' /www/wwwlogs/example.com.log | sort | uniq -c | sort -rn | head

    如果日志里打了 referer,用 grep 抽出回源节点的特征

    grep -i 'referer' /www/wwwlogs/example.com.log | tail -n 50

    日志字段顺序取决于宝塔默认的 log_format,实际字段位置以你服务器上的配置为准;如果日志里没有 Referer,需要在 Nginx 日志格式里加上 $http_referer 再观察。

    确认之后,规则可以这样写。下面这段是放在图片、附件目录 location 里的典型写法,none 表示允许空 Referer,blocked 表示允许被防火墙或代理去掉 Referer 的请求,后面跟上允许的域名:

    location ~ .*\.(gif|jpg|jpeg|png|webp|mp4|zip|rar)$ {
        valid_referers none blocked server_names
            *.example.com example.com
            *.your-cdn-domain.com;
    
        if ($invalid_referer) {
            return 403;
        }
        expires 30d;
        access_log off;
    }

    几个容易踩的点需要说清楚。

    关于 none 和 blocked。加上 none 意味着直接访问图片地址(地址栏粘贴、下载工具、部分 App 内嵌浏览器)也能拿到文件,防盗链强度会下降;但不加,CDN 清空 Referer 回源时就必然 403。这里是个取舍:图片站更看重可用性,可以加;付费资源站更看重拦截效果,就要靠 CDN 侧配置保证回源带 Referer,而不是在源站硬拦。宝塔面板的防盗链勾选项通常不带 none,这就是误伤的直接原因之一。

    关于通配写法。*.example.com 能匹配子域名,但写法要规范,别写成 example.com*,那会连带匹配到 example.com.evil.net 这类伪造 Referer,等于没防。同时注意 server_names 关键字,它会自动把当前 server_name 指令里列出的域名纳入白名单,多域名站点用起来省事。

    关于放行位置。如果站点同时用了 CDN 和面板自带的防盗链,建议把规则统一收到站点的 Nginx 配置里手动维护,而不是依赖面板开关反复勾选——面板升级或规则重载时,手动改的内容有时会被覆盖,具体行为以你当前面板版本为准。改完规则后记得重载并验证:

    # 语法检查,通过后再重载
    nginx -t
    nginx -s reload
    
    

    模拟带 Referer 和空 Referer 两种请求,看返回码

    curl -I -e "https://www.example.com/" https://www.example.com/uploads/a.jpg curl -I https://www.example.com/uploads/a.jpg

    两条 curl 都应该返回 200;再换一个不在白名单里的 Referer 试一次,应该返回 403。如果空 Referer 那条返回 403,说明规则里缺 none 或者 CDN 回源没带 Referer,需要回到上一步确认回源特征。

    验证与长期维护建议

    规则生效后别只看 curl,还要走一遍真实链路:清一次 CDN 缓存,用手机流量和不同网络各访问一次页面,确认图片能正常加载;再打开浏览器开发者工具,看图片请求的响应状态和响应头里的 X-Cache 之类字段,判断是命中边缘还是回源。如果有条件,把源站被 403 的请求按小时统计一下,规则调整前后的曲线能直接说明问题是否解决。

    长期来看,防盗链规则应该跟着 CDN 配置一起维护。换 CDN 厂商、改回源策略、加新域名时,都回头检查一遍白名单;把这段配置写进自己的运维笔记,比记在面板某个勾选框里可靠。至于防盗链本身,它只能拦住「老实」的盗链者,真正要紧的付费资源,还是配合签名 URL、限速和访问日志监控一起用更稳妥。具体参数和实现方式,以官方文档和你的实际环境为准,配置前先在测试站点验证一遍再上生产。

    继续阅读

    📑 📅
    宝塔面板站点被降权前的征兆:抓取频次、收录量与Nginx日志交叉观察 2026-10-01
    宝塔多版本PHP站点选错版本:fastcgi_pass与.user.ini排查 2026-09-30
    Nginx 限流不生效排查:zone、层级与 CDN 真实 IP 三个坑 2026-09-30
    WordPress数据库MyISAM转InnoDB:引擎、行格式与写入观察 2026-09-30
    宝塔面板站点开 HTTP/3:Nginx 版本、Brotli 与 CDN 回源链路评估 2026-09-30
    Nginx add_header 层层覆盖导致安全响应头丢失:继承规则与location嵌套排查 2026-10-01
    WordPress上传图片自动生成多尺寸缩略图:禁用与冗余清理 2026-10-01
    宝塔面板反代后端走HTTPS出现502:SNI、证书校验与proxy_ssl参数配置 2026-10-01
    企业官网从零搭栏目结构:首页产品案例关于联系五块怎么定 2026-10-03
    企业官网移动端适配检查清单:十个细节逐屏验收 2026-10-03