如何在Nginx/1.20.0中配置多sitemap.xml文件的静态服务

问题背景 #

使用Nginx/1.20.0，希望通过https://new-dev.example.com/sitemap/sitemap-index.xml这类路径直接访问/var/www/sitemap/目录下的XML文件，但当前返回404错误。此前尝试的rewrite规则会触发外部重定向，不符合需求；使用try_files时又出现500错误。最终需要实现路径一一对应，比如https://new-dev.example.com/sitemap/articles/63300.xml直接返回/var/www/sitemap/articles/63300.xml文件。

正确配置方案 #

方案一：使用alias指令（推荐）

alias是Nginx中用于目录路径映射的专用指令，能直接将请求路径替换为目标文件路径，不会产生重定向。配置如下：

location /sitemap/ {
    alias /var/www/sitemap/;
    # 可选：仅允许XML文件访问，增强安全性
    types {
        application/xml xml;
    }
}

• 原理：当请求/sitemap/xxx.xml时，Nginx会自动映射到/var/www/sitemap/xxx.xml，直接返回文件内容。
• 额外检查：确保/var/www/sitemap/目录及所有文件对Nginx运行用户（通常是www-data）有可读权限。

方案二：使用try_files配合正则捕获

如果偏好正则匹配的方式，可调整try_files的写法，避免路径循环导致500错误：

location ~ ^/sitemap/(.*)$ {
    try_files /var/www/sitemap/$1 =404;
}

• 原理：通过正则捕获请求路径中sitemap/后的部分（即$1），直接查找对应文件；若文件不存在，返回404错误终止处理，避免之前的循环问题。

配置验证 #

修改配置后，执行以下命令确保配置合法并生效：

nginx -t
nginx -s reload

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