You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Nginx中按文件扩展名设置差异化上传大小限制?

按文件扩展名差异化设置Nginx上传大小限制

绝对可以实现!Nginx的配置灵活性刚好能满足这种按文件扩展名差异化限制上传大小的需求,核心思路是利用location指令匹配特定扩展名,然后在对应的location块内单独设置client_max_body_size来覆盖全局默认值。

具体配置示例

首先你可以先设置一个全局的默认上传限制(比如你原来的100M),然后针对不同扩展名的文件单独定义规则:

# 全局默认上传大小限制,适用于所有未匹配到特定规则的文件
client_max_body_size 100m;

# 匹配所有.png文件(不区分大小写,若要区分则用~代替~*)
location ~* \.png$ {
    client_max_body_size 5m;  # 限制PNG文件最大5MB
    # 补充你的实际业务配置:比如静态文件路径或反向代理地址
    root /var/www/static;
    # 如果是上传到后端服务,替换成proxy_pass http://your-backend;
}

# 匹配所有.jpg/.jpeg文件(可合并规则)
location ~* \.(jpg|jpeg)$ {
    client_max_body_size 10m;  # 限制JPG/JPEG文件最大10MB
    root /var/www/static;
}

# 其他未匹配到的文件沿用全局100M限制
location / {
    root /var/www/html;
    index index.html index.htm;
}

关键注意事项

  • 匹配优先级:Nginx的location匹配有优先级顺序,正则匹配(~/~*)的优先级高于前缀匹配,所以要确保你的扩展名规则不会被其他更优先的location覆盖。
  • 大小写问题:~*是不区分大小写的匹配,如果你需要严格区分.PNG和.png,就用~代替。
  • 反向代理场景:如果你的文件是上传到后端服务,要把client_max_body_size放在包含proxy_pass的location块内,同时确保后端服务也配置了对应的上传大小限制(避免后端拒绝请求)。
  • 配置验证:修改完配置后,一定要用nginx -t检查语法是否正确,确认无误后执行nginx -s reload重载配置生效。

测试建议

可以用curl命令测试不同扩展名的上传限制是否生效:

# 测试上传超过5M的PNG文件,应该返回413 Request Entity Too Large
curl -X POST -F "file=@large.png" http://your-domain/test.png

# 测试上传10M以内的JPG文件,应该正常处理
curl -X POST -F "file=@valid.jpg" http://your-domain/test.jpg

内容的提问来源于stack exchange,提问作者Çağla A. D.

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.20 11:55:14