Nginx多域名白名单防盗链需用valid_referers配置允许域名(支持精确、通配、正则等写法),并配合if($invalid_referer)拦截;它仅校验Referer头,不加密不鉴权,轻量实用但可被伪造。

在 Nginx 中配置多域名白名单防盗链,核心是用 valid_referers 指令列出所有允许的来源,并配合 if ($invalid_referer) 做拦截。它不加密、不鉴权,只校验请求头中的 Referer 字段是否匹配预设范围,轻量但实用。
支持的域名写法类型
valid_referers 支持多种匹配方式,可混合使用:
-
精确域名:如
example.com,仅匹配该完整域名(不含协议和路径) -
通配子域:如
*.example.com,匹配www.example.com、api.example.com等 -
后缀通配:如
example.*,匹配example.org、example.net(慎用,范围较宽) -
正则表达式:以
~开头,如~\.baidu\.com$(注意点号要转义,末尾加$防止误匹配) -
空 Referer:用
none显式允许直接输入 URL 或 HTTPS 页面引用 HTTP 资源等场景 -
解析失败的 Referer:用
blocked匹配被浏览器/代理过滤或格式异常的情况
典型多域名白名单配置示例
以下配置放在 server 或 location 块中,针对图片、视频等静态资源:
location ~* \.(jpg|jpeg|png|gif|webp|mp4|avi|flv)$ {
valid_referers none blocked
example.com *.example.com
partner-site.com *.partner-site.com
~\.baidu\.com$
~\.google\.com$;
<pre class="brush:php;toolbar:false;">if ($invalid_referer) {
return 403;
# 或重定向到提示图(需提前准备):
# rewrite ^/.*$ /images/forbidden.png break;
}}
说明:
– 多个域名之间用空格分隔,不分行不影响语法;
– none blocked 应放在最前,确保直接访问和异常 Referer 可通行;
– 正则末尾的 $ 是关键,避免 baidu.com.hacker.site 这类伪造值被误放。
常见注意事项
-
valid_referers本身不拦截,只设置内置变量$invalid_referer(0=合法,1=非法),必须搭配if使用 - Referer 可被客户端轻易伪造,该方案适合防御普通盗链,不能替代鉴权机制
- HTTPS 页面引用 HTTP 资源时,浏览器会清空 Referer,此时依赖
none才能正常加载 - 若需同时支持 www 和非 www 版本,建议都写上:
example.com www.example.com *.example.com
不复杂但容易忽略细节。按需组合域名写法,再加一层 if 判断,就能快速启用多域名白名单防护。











