当前位置：首页 > 文章列表 > 文章 > php教程 > 如何在宝塔面板配置Nginx WebDAV模块_搭建个人自托管云盘环境

如何在宝塔面板配置Nginx WebDAV模块_搭建个人自托管云盘环境

2026-05-06 09:12:43 0浏览收藏

小伙伴们有没有觉得学习文章很有意思？有意思就对了！今天就给大家带来《如何在宝塔面板配置Nginx WebDAV模块_搭建个人自托管云盘环境》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

必须编译安装并显式启用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 路径写错上。

好了，本文到此结束，带大家了解了《如何在宝塔面板配置Nginx WebDAV模块_搭建个人自托管云盘环境》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！