在线文档教程
Nginx

ngx_http_dav_module

ngx_http_dav_module模块

  • 示例配置

  • 指令

  • dav_access

  • dav_methods

  • create_full_put_path

  • min_delete_depth

ngx_http_dav_module模块旨在通过WebDAV协议进行文件管理自动化。该模块处理HTTP和WebDAV方法PUT,DELETE,MKCOL,COPY和MOVE。

该模块不是默认生成的,它应该使用--with-http_dav_module配置参数启用。

需要额外WebDAV方法操作的WebDAV客户端无法使用此模块。

示例配置

location / { root /data/www; client_body_temp_path /data/client_temp; dav_methods PUT DELETE MKCOL COPY MOVE; create_full_put_path on; dav_access group:rw all:r; limit_except GET { allow 192.168.1.0/32; deny all; } }

指令

句法:dav_access users:permissions ...;
默认:dav_access user:rw;
语境:http,服务器,位置

为新创建的文件和目录设置访问权限,例如:

dav_access user:rw group:rw all:r;

如果指定了任何groupall访问权限,则user可以省略权限:

dav_access group:rw all:r;

句法:dav_methods off | method ...;
默认:dav_methods off;
语境:http,服务器,位置

允许指定的HTTP和WebDAV方法。该参数off拒绝该模块处理的所有方法。该支持下列方法:PUTDELETEMKCOLCOPY,和MOVE

使用PUT方法上传的文件首先被写入临时文件,然后文件被重命名。从0.8.9版开始,临时文件和持久性存储可以放在不同的文件系统上。但是,请注意,在这种情况下,文件将跨两个文件系统复制,而不是廉价的重命名操作。因此建议,对于任何给定的位置,由client_body_temp_path指令设置的保存文件和保存临时文件的目录都放在同一个文件系统上。

使用PUT方法创建文件时,可以通过在“Date”标题字段中传递修改日期来指定修改日期。

句法: create_full_put_path 开启| 关闭;
默认:create_full_put_path off;
语境:http,服务器,位置

WebDAV规范仅允许在已经存在的目录中创建文件。该指令允许创建所有需要的中间目录。

句法:min_delete_depth number;
默认:min_delete_depth 0;
语境:http,服务器,位置

允许DELETE方法移除文件,前提是请求路径中的元素数量不小于指定的数量。例如,指令

min_delete_depth 4;

允许删除请求上的文件

/users/00/00/name /users/00/00/name/pic.jpg /users/00/00/page.html

并拒绝删除