宝塔面板 Nginx WebDAV 搭建指南#

本文详细介绍了在宝塔面板中使用 Nginx 搭建 WebDAV 程序的完整步骤，包括模块安装、配置和常见问题解决，助力快速搭建个人云盘。

1. 前置条件与模块确认#

WebDAV 基础: WebDAV (Web-based Distributed Authoring and Versioning) 是一种基于 HTTP 协议的扩展，允许用户通过 Web 浏览器访问和管理文件。
Nginx 模块支持: WebDAV 需要 Nginx 的 http_dav_module 模块支持。
版本确认: 宝塔面板 7.4.5 及以上版本使用极速安装模式默认安装 http_dav_module。
模块检查: 使用 nginx -V 命令检查 Nginx 是否已安装 http_dav_module。

如果 nginx -V 命令显示未安装 http_dav_module，则需要卸载并重新编译安装 Nginx，并添加自定义模块。

克隆扩展模块:

1
git clone https://github.com/arut/nginx-dav-ext-module.git /root/nginx-dav-ext-module

自定义模块信息填写:
- 模块名称: http_dav_module
- 模块描述: webdev
- 模块参数: --with-http_dav_module --add-module=/root/nginx-dav-ext-module
编译安装: 按照宝塔面板提供的步骤进行 Nginx 编译安装，并包含上述自定义模块参数。
验证安装: 编译安装完成后，再次使用 nginx -V 命令验证 http_dav_module 是否已成功安装。

创建网站: 在宝塔面板中创建一个新的网站。
PHP 版本: 选择 “纯静态” 作为 PHP 版本，因为 WebDAV 不需要 PHP 支持。
开启密码访问: 前往网站设置，开启密码访问，设置账户和密码。
修改 Nginx 配置文件:
- 在网站设置中选择 “配置文件”。
- 在配置文件的末尾，} 符号之前粘贴以下设置代码：
```
1
location / {
2
    root     /home/Downloads;  # WebDAV 目录路径 (自行修改)
3
    client_max_body_size 102400M; # 大文件支持参数
4
    charset utf-8; # 编码参数（不设定可能导致中文乱码）
5
    autoindex on;
6
    dav_methods PUT DELETE MKCOL COPY MOVE;
7
    # 需要 nginx-dav-ext-module 才有下面的选项
8
    dav_ext_methods PROPFIND OPTIONS LOCK UNLOCK;
9
    create_full_put_path  on;
10
}
```
- 重要参数说明:
  - root: WebDAV 目录的路径，根据实际情况修改。
  - client_max_body_size: 允许上传文件的最大尺寸，根据需要调整。
  - charset: 设置字符编码，防止中文乱码。
  - autoindex: 开启自动生成目录索引。
  - dav_methods: 允许的 WebDAV 方法。
  - dav_ext_methods: 需要 nginx-dav-ext-module 才能使用的扩展方法。
  - create_full_put_path: 开启此选项后，上传文件时会自动创建完整路径。