在服务器上搭一个 WebDAV：nginx + Apache 的组合方案

方案：nginx 在前，Apache 在后#

一开始想直接用 nginx 的 dav 模块，但很快发现不行：nginx 自带的 ngx_http_dav_module 只支持 PUT、DELETE、MKCOL、COPY、MOVE，不支持 PROPFIND——而几乎所有 WebDAV 客户端都靠 PROPFIND 列目录。实测请求会返回 405。

完整的 WebDAV 需要 nginx-dav-ext-module，得自己编译 nginx；另一个选择是 Apache 的 mod_dav，功能完整，还能处理 LOCK（Windows 映射网络驱动器会用到）。

于是最终结构是：

1
客户端 --HTTPS--> nginx (TLS + Basic Auth + 反代) --> Apache mod_dav (127.0.0.1:8081) --> /srv/webdav

这样既不用额外跑 Docker 容器（省内存），又能拿到完整的 WebDAV 能力。

一、域名#

给域名加一条 A 记录：

1
dav.julyrain.top  A  <服务器IP>

还是用之前的火山引擎 DNS 脚本：

1
node scripts/volc-dns.mjs add-a julyrain.top dav <服务器IP>

二、Apache 后端#

安装并启用模块：

1
sudo apt install -y apache2
2
sudo a2enmod dav dav_fs
3
sudo a2dissite 000-default default-ssl

关键一步：Apache 默认会监听 80 端口，和 nginx 冲突。把它改成只监听本机：

1
Listen 127.0.0.1:8081

新建 WebDAV 站点：

1
<VirtualHost 127.0.0.1:8081>
2
    ServerName dav.julyrain.top
3
    DocumentRoot /srv/webdav
4

5
    <Directory /srv/webdav>
6
        Options Indexes FollowSymLinks
7
        AllowOverride None
8
        Require all granted
9
        Dav On
10
    </Directory>
11

12
    DavLockDB /var/lib/dav/lockdb
13
    ErrorLog ${APACHE_LOG_DIR}/webdav-error.log
14
    CustomLog ${APACHE_LOG_DIR}/webdav-access.log combined
15
</VirtualHost>

1
sudo a2ensite webdav
2
sudo mkdir -p /var/lib/dav && sudo chown www-data:www-data /var/lib/dav
3
sudo apache2ctl configtest
4
sudo systemctl restart apache2

数据目录：

1
sudo mkdir -p /srv/webdav
2
sudo chown www-data:www-data /srv/webdav
3
sudo chmod 750 /srv/webdav

注意：Apache 只监听 127.0.0.1:8081，外网访问不到，只有 nginx 能转发进来。

三、Basic Auth#

生成密码文件（apr1 哈希）：

1
sudo sh -c 'printf "zuoqi:%s\n" "$(openssl passwd -apr1 "你的密码")" > /etc/nginx/.htpasswd-dav'
2
sudo chown root:www-data /etc/nginx/.htpasswd-dav
3
sudo chmod 640 /etc/nginx/.htpasswd-dav

四、nginx 反向代理#

1
server {
2
    listen 80;
3
    listen [::]:80;
4
    server_name dav.julyrain.top;
5

6
    client_max_body_size 4g;
7

8
    location ~ /\. {
9
        deny all;
10
    }
11

12
    location / {
13
        auth_basic "WebDAV";
14
        auth_basic_user_file /etc/nginx/.htpasswd-dav;
15

16
        proxy_pass http://127.0.0.1:8081;
17
        proxy_http_version 1.1;
18
        proxy_set_header Host $host;
19
        proxy_set_header X-Real-IP $remote_addr;
20
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
21
        proxy_set_header X-Forwarded-Proto $scheme;
22
        proxy_request_buffering off;
23
    }
24
}

要点：

• client_max_body_size 4g：允许传大文件；
• proxy_request_buffering off：上传大文件时边收边转发，不先落盘到 nginx 临时目录；
• location ~ /\. 拒绝 .git、.env 这类隐藏文件；
• 认证放在 nginx 层，Apache 只信任本机流量。

然后签证书：

1
sudo certbot --nginx -d dav.julyrain.top --redirect

五、验证#

1
# 未认证 → 401
2
curl -I https://dav.julyrain.top/
3

4
# 列目录 → 207
5
curl -u zuoqi:密码 -X PROPFIND -H "Depth: 1" https://dav.julyrain.top/
6

7
# 上传 → 201
8
echo hi > hi.txt
9
curl -u zuoqi:密码 -T hi.txt https://dav.julyrain.top/hi.txt
10

11
# 读取
12
curl -u zuoqi:密码 https://dav.julyrain.top/hi.txt
13

14
# 删除 → 204
15
curl -u zuoqi:密码 -X DELETE https://dav.julyrain.top/hi.txt

实测返回：401 / 207 / 201 / 204，HTTP 也会 301 跳到 HTTPS。

客户端怎么连#

地址统一是 https://dav.julyrain.top/，用户名 zuoqi，密码就是上面生成的。

安全和限制#

• 只开 HTTPS：HTTP 已 301 跳转，Basic Auth 不会明文传输；
• 单账号：个人用足够，以后要多人可以改成多行 htpasswd；
• 上传上限 4G：由 client_max_body_size 控制；
• 隐藏文件拒绝：location ~ /\. 直接 403；
• 暴力破解：Basic Auth 没有验证码，建议配合 fail2ban 对 nginx 的 401 做封禁，或者只在内网/VPN 下使用；
• 备份：数据都在 /srv/webdav，直接 tar 这个目录即可。

踩到的坑#

1. nginx 的 dav 模块不支持 PROPFIND：一开始配完发现列目录 405，才意识到需要 Apache 的 mod_dav；
2. Apache 默认抢占 80 端口：装完必须先改 ports.conf 只监听 127.0.0.1，否则和 nginx 冲突；
3. 数据目录权限：Apache 以 www-data 运行，目录属主和权限不对会写不进去；
4. 大文件上传：记得关掉 proxy_request_buffering，否则 nginx 会先把整个文件缓存到本地磁盘。

小结#

这套组合没有额外容器，只多了 Apache 一个进程（内存几十 MB），但拿到了完整 WebDAV：列目录、上传、下载、移动、锁都支持。

如果你也想自建一个「自己的网盘」，又不想折腾 Nextcloud 那一套，nginx + Apache mod_dav 是很轻的方案。