必须编译安装并显式启用http_dav_module，否则WebDAV方法会返回405或501；需先执行nginx -V | grep with-http_dav_module验证模块存在，再通过宝塔卸载重装、配置前置脚本和模块参数（--with-http_dav_module --add-module=/www/server/nginx-dav-ext-module --with-http_ssl_module）完成编译。
nginx 默认不带完整 WebDAV 支持，直接在宝塔里点“安装 Nginx”是没用的——你必须编译安装并显式启用 http_dav_module，否则后续所有配置都会 405 Method Not Allowed 或 501 Not Implemented。
确认当前 Nginx 是否已编译 dav_module
别跳过这步。很多人配了半天发现 dav_methods 不生效，其实是模块压根没加载。
- 在 SSH 中执行：
nginx -V 2>&1 | grep -o with-http_dav_module，有输出才表示已编译 - 若无输出，说明宝塔默认安装的 Nginx（哪怕选了“编译安装”但没填参数）不包含该模块
-
宝塔面板里看“软件商店 → Nginx → 设置 → 安装扩展”，
http_dav_module不会出现在列表中——它不是“扩展”，而是编译期开关
宝塔中编译安装含 WebDAV 的 Nginx
必须卸载现有 Nginx 后重装，且前置脚本和模块参数要严格匹配，否则编译失败或模块未启用。
- 前置脚本（确保模块源存在）：
if [ ! -d "/www/server/nginx-dav-ext-module" ]; then git clone https://github.com/arut/nginx-dav-ext-module.git /www/server/nginx-dav-ext-module; fi - 模块参数（缺一不可）：
--with-http_dav_module --add-module=/www/server/nginx-dav-ext-module --with-http_ssl_module - 模块名称建议填
webdav_full，避免和宝塔内置名冲突 - 编译耗时较长（15–30 分钟），期间不要关闭 SSH 连接；失败时看日志末尾的
make[1]: ***行定位错误
Nginx 配置文件中启用 WebDAV 功能
光有模块还不够，location 块里的指令必须成对出现，且权限、路径、临时目录都要手动指定，否则 PUT/PROPFIND 会静默失败。
-
root必须指向一个真实存在的、www用户可写的绝对路径，比如/www/wwwroot/dav.example.com - 必须显式声明
dav_methods PUT DELETE MKCOL COPY MOVE和dav_ext_methods PROPFIND OPTIONS LOCK UNLOCK（后者依赖nginx-dav-ext-module） -
client_body_temp_path /tmp/nginx_webdav要提前创建并授权：mkdir -p /tmp/nginx_webdav && chown www:www /tmp/nginx_webdav -
create_full_put_path on是关键，否则嵌套目录上传会报 409 Conflict
认证与安全绕不开 BasicAuth
WebDAV 协议本身不处理用户隔离，Nginx 层必须加 Basic 认证，否则任何知道地址的人都能删你全部文件。
- 不能只靠宝塔的“网站目录权限”或“SSL 强制”，那只是 HTTPS 传输加密，不等于访问控制
- 在
location块内加：auth_basic "WebDAV Login"; auth_basic_user_file /www/wwwroot/dav.example.com/.htpasswd; - 用
htpasswd -c /www/wwwroot/dav.example.com/.htpasswd username创建首个用户（注意路径和用户组一致） -
.htpasswd文件权限必须是644，且父目录/www/wwwroot/dav.example.com的属主为www
最常被忽略的一点：Nginx 编译成功 ≠ 模块自动启用，nginx.conf 里还得有 load_module modules/ngx_http_dav_module.so; ——但宝塔编译安装会自动处理这行，你只需确认 nginx -V 输出里有 with-http_dav_module 就行。其他所有问题，基本都出在路径权限、临时目录缺失、或 auth_basic_user_file 路径写错上。
