Nginx反向代理如何配置仅允许指定扩展名文件访问并拦截其他请求
可落地的Nginx扩展名白名单拦截配置
核心实现逻辑
在现有反向代理配置基础上,新增一层正则规则拦截:对所有带文件扩展名的请求做白名单校验,仅放行指定扩展名的请求走原有代理流程,非白名单扩展名的请求直接返回403拦截。
配置特意规避了两个常见踩坑点:
- 不会误拦无扩展名的常规请求(比如网站根路径首页、无后缀的API接口)
- 不会把请求查询参数里的内容误判为文件扩展名
修改后的完整配置
直接将原有server块替换为如下内容即可,核心新增的拦截规则已标注:
server { listen 443 ssl ; listen 8080 ; ssl on; ssl_certificate /etc/nginx/bundle.crt; ssl_certificate_key /etc/nginx/cert.key; ssl_protocols TLSv1.2 TLSv1.3; ssl_prefer_server_ciphers on; ssl_ciphers 'ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA256'; server_name mydomain.net; # 新增:非白名单扩展名拦截规则 # 匹配所有带文件扩展名的请求,不在白名单的直接返回403 # 用~*实现不区分大小写匹配,比如.JPG、PNG这类大写扩展名也会被识别为合法请求 location ~* \.(?!(html|png|php|svg|jpg|css|js)$)[a-zA-Z0-9]+$ { return 403; } location / { proxy_pass https://172.16.0.1:8080/; # 原有代理逻辑全部保留 proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $http_host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forward-For $proxy_add_x_forwarded_for; proxy_set_header X-Forward-Proto http; proxy_set_header X-Nginx-Proxy true; proxy_redirect off; } }
规则匹配效果说明
- 合法请求(正常代理放行):
- 访问网站根路径 / (无扩展名,不受拦截规则影响)
- 访问 /index.html、/style.css、/app.js、/pic.jpg 等白名单内的扩展名请求
- 访问 /api/userList 这类无后缀的接口路径
- 被拦截的请求(直接返回403,不转发到后端服务):
- 访问 /malware.exe、/shell.php5、/backup.sql 等非白名单扩展名的文件
- 所有带白名单外扩展名的请求
注意事项
- 配置修改完成后,先执行
nginx -t检查语法正确性,确认无报错后再执行nginx -s reload重载配置生效 - 如果需要严格区分扩展名大小写(比如只认小写.jpg、不认大写.JPG),把拦截规则里的
~*改成~即可 - 该规则会在Nginx收到请求的第一阶段完成拦截,不会把非法请求转发到后端代理服务,不会额外增加后端服务的压力
内容的提问来源于stack exchange,提问作者Anthony Chen
相关产品推荐
相关产品推荐

