Nginx原生http_dav_module不支持PROPFIND等关键WebDAV方法，无法被客户端识别为合法WebDAV服务，必须补装nginx-dav-ext-module模块并验证其存在，否则挂载失败或只读。
Nginx 原生 http_dav_module 不能直接当云盘用，挂载会失败或只读——缺 PROPFIND 等关键方法，必须补 nginx-dav-ext-module 模块。
检查 Nginx 是否真支持 WebDAV 完整协议
很多人执行 nginx -V 看到 with-http_dav_module 就以为万事大吉，其实这只是基础写入模块。WebDAV 客户端（Windows 映射网络驱动器、macOS Finder、Cyberduck、iOS 文件 App）真正依赖的是 PROPFIND、OPTIONS、LOCK 等扩展方法，原生模块根本不提供。
必须验证扩展模块是否存在：
nginx -V 2>&1 | grep -o dav_ext
如果无输出，说明没装 nginx-dav-ext-module，此时任何配置都只能响应 PUT/DELETE，无法被识别为合法 WebDAV 服务。
- 该模块不兼容 Nginx 1.25.0+，建议锁定在 1.22.x 或 1.24.x 版本编译
- 编译时必须加
--add-module=/path/to/nginx-dav-ext-module，不能仅靠--with-http_dav_module -
autoindex_format xml是硬性要求，客户端靠它解析目录结构，设成html或省略会导致挂载失败
location 配置里 alias 和 root 的选择陷阱
用 root 还是 alias？错选会导致 404 或权限越界，尤其在路径末尾带斜杠时。
正确做法：
- 若 URL 路径是
/webdav/（结尾有斜杠），必须用alias /data/webdav/;—— 注意末尾斜杠要对齐 - 若 URL 是
/webdav（无斜杠），才可用root /data;，此时请求/webdav/file.txt会映射到/data/webdav/file.txt -
alias不继承上级location路径，root会拼接完整路径，混用极易导致写入到错误目录
典型错误配置：
location /webdav/ {
root /data/webdav; # ❌ 请求 /webdav/test.txt → 实际写入 /data/webdav/webdav/test.txt
dav_methods PUT;
}挂载失败常见报错与对应修复
Windows 提示“找不到网络路径”、macOS 显示“连接服务器时发生错误”、iOS 文件 App 列表为空——这些都不是网络问题，而是协议层拒绝。
重点排查以下几项：
-
405 Not Allowed：确认dav_ext_methods包含PROPFIND和OPTIONS，且未被其他指令（如limit_except）覆盖 -
403 Forbidden：检查dav_access权限是否覆盖当前用户（如运行 Nginx 的www-data用户需对存储目录有写权限），chmod -R 775比755更稳妥 -
401 Unauthorized：若启用auth_basic，确保auth_basic_user_file路径可读，且文件由htpasswd生成（不是手写） - 挂载后无法新建文件夹：缺少
create_full_put_path on;，或磁盘空间/inode 耗尽（df -i查看）
安全与生产环境必须加的三道锁
开放 WebDAV 就等于开放文件系统写入口，不加固等于裸奔。
- 强制 HTTPS：
listen 443 ssl+ 有效证书，禁用 HTTP 的80端口重定向（WebDAV 客户端多数不自动跳转） - 限制上传大小：
client_max_body_size 2G;放在server或location块内，防 DoS - 禁止执行与遍历：
disable_symlinks on;+location ~ \.(php|sh|pl|py)$ { deny all; }，避免上传脚本被执行
最易被忽略的一点：types { } 必须清空默认 MIME 映射，否则某些客户端会因响应头 Content-Type 错误而拒绝解析 XML 目录列表。
