Nginx location如何配置允许PUT请求？

Question

**Nginx中如何配置location以允许PUT请求？** 在使用Nginx作为Web服务器或反向代理时，有时需要允许客户端通过PUT方法上传文件或更新资源。默认情况下，Nginx可能未正确配置以处理PUT请求，导致出现“405 Not Allowed”错误。那么，如何在Nginx的`location`块中正确配置以允许PUT请求？是否需要额外模块支持？是否需要设置`dav_method`或启用`ngx_http_dav_module`？此外，如何在保证安全的前提下开放PUT方法？

Answer 1

一、Nginx中配置location以允许PUT请求的背景与基础

在现代Web开发中，Nginx不仅作为高性能的Web服务器，还广泛用于反向代理、负载均衡和静态资源处理。当客户端需要通过HTTP的PUT方法上传或更新服务器上的资源时，Nginx默认并不支持该方法，导致返回“405 Not Allowed”错误。

PUT请求通常用于更新资源，与POST不同，它具有幂等性，适用于RESTful API设计中的资源更新场景。因此，正确配置Nginx以支持PUT请求是构建现代Web服务的重要一环。

二、Nginx中处理PUT请求的核心配置方法

要允许PUT请求，需要在Nginx的location块中进行配置。基本配置如下：

location /upload/ {
    # 允许PUT方法
    if ($request_method = 'PUT') {
        # 允许请求通过
        add_header 'Access-Control-Allow-Methods' 'PUT' always;
    }

    # 其他常见配置
    root /data/upload;
    dav_methods PUT;
    dav_ext_methods PROPFIND OPTIONS;
    create_full_put_path on;
    client_body_temp_path /tmp/client_body;
}

该配置片段中，关键点包括：

• dav_methods PUT;：启用WebDAV的PUT方法。
• create_full_put_path on;：允许自动创建路径目录。
• client_body_temp_path：指定上传文件的临时存储路径。

三、模块依赖：ngx_http_dav_module的作用与启用方式

Nginx本身并不默认启用WebDAV相关模块，支持PUT请求的关键在于是否启用了ngx_http_dav_module。该模块提供了对WebDAV协议的支持，包括PUT、DELETE、MKCOL等方法。

可以通过以下方式检查Nginx是否包含该模块：

nginx -V 2>&1 | grep -- '--add-module' | grep 'dav'

若未包含，需在编译Nginx时添加：

--add-module=../ngx_http_dav_module

四、安全配置建议：在开放PUT请求的同时保障系统安全

虽然PUT方法对于某些业务场景是必需的，但其也带来了潜在的安全风险，如任意文件上传、覆盖关键资源等。以下是几个安全配置建议：

1. 限制访问IP：allow 192.168.1.0/24; deny all;
2. 设置上传目录权限：root /var/www/upload;，并确保权限为644或更严格。
3. 使用if语句限制请求方法，避免其他方法被误用。
4. 启用HTTPS以防止数据被中间人窃取。

五、PUT请求处理流程图示例

以下是Nginx处理PUT请求的基本流程图：

graph TD
    A[客户端发送PUT请求] --> B{Nginx接收到请求}
    B --> C[检查location匹配]
    C --> D{是否允许PUT方法？}
    D -- 是 --> E[调用dav_methods处理]
    D -- 否 --> F[返回405错误]
    E --> G[检查文件路径权限]
    G -- 允许 --> H[写入文件]
    G -- 拒绝 --> I[返回403错误]

六、完整配置示例与说明

以下是一个完整的Nginx配置示例，用于支持PUT请求并兼顾安全性：

server {
    listen 80;
    server_name upload.example.com;

    location /upload/ {
        dav_methods PUT;
        create_full_put_path on;
        client_body_temp_path /tmp/upload_temp;

        # 限制访问来源
        allow 192.168.1.0/24;
        deny all;

        # 设置根目录
        root /var/www/uploads;

        # 安全头信息
        add_header 'Access-Control-Allow-Methods' 'PUT' always;
        add_header 'Access-Control-Allow-Origin' '*' always;
    }
}

该配置中：

• 启用了PUT方法。
• 限制了访问IP范围。
• 设置了上传目录。
• 添加了CORS头以支持跨域请求。