如何配置Nginx的/image路由仅提供PNG和JPG文件？

咱们来一步步搞定这个Nginx配置的问题，先给你捋清楚之前的错误原因，再给你正确的配置方案，顺便把你之前用$1的原理讲明白~

为什么你之前的尝试出错了？ #

你写的location /image \.(png|jpg) 不符合Nginx的location语法规则：

• 这个写法既不是前缀匹配（前缀匹配不需要正则符号），也不是标准的正则匹配（正则匹配需要用~或~*开头），Nginx根本没法正确解析它。
• 要限制请求的文件扩展名，必须用正则表达式类型的location，同时结合捕获组来正确映射服务器上的文件路径。

正确的配置方案 #

根据你的需求，分两种常见场景给你配置：

场景1：请求路径是 /image/xxx.png 这类（带斜杠，和你之前的/images/结构一致） #

直接套用你之前的思路，调整正则匹配的前缀即可：

location ~ ^/image/(.+\.(png|jpg))$ {
    include /etc/nginx/mime.types;
    alias /site/$1;
}

配置解释：

• ~：表示这是区分大小写的正则匹配（如果想支持大写扩展名，比如.PNG，换成~*即可）
• ^/image/：精准匹配以/image/开头的请求路径
• (.+\.(png|jpg))：第一个捕获组，专门捕获/image/之后的完整文件名，要求必须是.png或.jpg结尾
• $：匹配路径的结尾，避免无效的路径（比如/image/xxx.png/abc这种错误请求）
• alias /site/$1：把请求映射到服务器本地的/site/目录下的对应文件，比如请求/image/cat.jpg，实际会读取/site/cat.jpg

场景2：请求路径是 /image.png 这类（直接在/image后加扩展名，无斜杠） #

如果你的请求是这种格式，配置要做一点调整：

location ~ ^/image\.(png|jpg)$ {
    include /etc/nginx/mime.types;
    alias /site/image.$1;
}

配置解释：

• ^/image\.(png|jpg)$：直接匹配/image.png或/image.jpg（\.是转义后的点，因为正则里.是通配符）
• $1这里捕获的是扩展名（png或jpg），所以alias /site/image.$1会对应到服务器上的/site/image.png或/site/image.jpg

如果两种请求格式都需要支持，把两个location配置都加上就行。

关于你之前用$1的原理 #

其实很简单：正则表达式里的括号()会创建一个捕获组，每个捕获组匹配到的内容可以用$1、$2这类变量来引用（$1对应第一个捕获组，$2对应第二个，以此类推）。

在你之前的/images/配置里：

location ~ ^/images/(.+\.(?:gif|jpe?g|png))$ {
    include /etc/nginx/mime.types;
    alias /site/$1;
}

(.+\.(?:gif|jpe?g|png))就是第一个捕获组，它把/images/后面的完整文件名（比如xxx.jpg）捕获了下来，alias /site/$1就相当于把请求的/images/xxx.jpg映射到了服务器上的/site/xxx.jpg，完美解决了路径映射的问题。

最后提醒 #

• 配置完后，用nginx -t命令测试配置是否合法，避免语法错误
• 确保/site/目录存在对应的PNG/JPG文件，并且Nginx进程有读取权限
• 测试没问题后，重启Nginx生效

内容的提问来源于stack exchange，提问作者user3525290