基于Apache的HTTPS WebDAV服务器搭建终极指南

December 14, 2025

WebDAV (Web Distributed Authoring and Versioning) 是 HTTP 协议的强大扩展，它能将您的远程服务器变成一个安全的文件管理中心。无需额外软件，无论是 Windows、macOS 还是 Linux 用户，都可以像操作本地磁盘一样，通过 HTTPS WebDAV (davs://) 协议轻松实现 Word/Excel 文档协作、音乐收藏分享、或者远程备份。本指南将详细介绍如何在 Debian/Ubuntu 系统上，使用 Apache 和 SSL 证书，搭建一个兼顾安全和性能的 WebDAV 服务器。

🚀 第一阶段：系统环境与核心模块准备

在开始配置前，请确保您的系统已安装 Apache2 并拥有 sudo 权限。

1. 开启 Apache 必需的 WebDAV 模块

为了让 Apache 能够理解 WebDAV 协议并处理文件系统操作，我们需要启用以下模块：

# 启用 WebDAV 核心模块 (mod_dav)
sudo a2enmod dav

# 启用 WebDAV 文件系统后端模块 (mod_dav_fs)
sudo a2enmod dav_fs

# 启用 SSL 模块 (mod_ssl)，这是实现安全连接的前提
sudo a2enmod ssl

# 启用 Headers 模块 (mod_headers)，推荐用于配置 HSTS 等安全响应头
sudo a2enmod headers

2. 创建 WebDAV 并发锁定数据库目录

WebDAV 协议使用锁定数据库 (DavLockDB) 来管理文件的并发访问和编辑，防止多人同时修改一个文件导致冲突。

# 1. 创建用于存储锁定数据库的目录
sudo mkdir -p /var/lib/dav

# 2. 将目录所有权赋予 Apache 运行用户 (www-data)，确保其读写权限
sudo chown -R www-data:www-data /var/lib/dav

3. 重启 Apache 服务加载新模块

必须重启服务才能使 a2enmod 的更改生效。

sudo systemctl restart apache2

🔐 第二阶段：配置 HTTPS WebDAV 虚拟主机

接下来，我们创建或修改您的虚拟主机配置文件 (/etc/apache2/sites-available/webdav.conf)，使用 443 端口 实现 SSL 加密。

<VirtualHost *:443>
    ServerAdmin webmaster@homelab.org
    ServerName webdav.homelab.org

    # --- 安全增强：HSTS 头部 ---
    # 强制浏览器在未来 2 年内只使用 HTTPS (重要 SEO 安全信号)
    Header always set Strict-Transport-Security "max-age=63072000; includeSubDomains; preload"

    # 1. WebDAV 锁定数据库
    DavLockDB /var/lib/dav/davlock
    
    # 启用 SSL
    SSLEngine On
    
    # --- SSL 证书配置 (使用 acme.sh 或 Let's Encrypt 证书) ---
    SSLCertificateFile      /etc/ssl/homelab.org/homelab.org.cer
    SSLCertificateKeyFile   /etc/ssl/homelab.org/homelab.org.key
    SSLCertificateChainFile /etc/ssl/homelab.org/fullchain.cer
    
    # 网站根目录 (DocumentRoot)
    DocumentRoot /var/www/html/
    # 将 /webdav URL 映射到实际的 WebDAV 文件存储目录
    Alias /webdav /var/www/html/webdav
    
    # --- 核心 WebDAV 访问配置 ---
    <Directory /var/www/html/webdav >
        # 启用 WebDAV 功能
        DAV On
        
        # 阻止未授权用户的目录列表 (安全最佳实践)
        Options -Indexes 
        AllowOverride None

        # 身份验证：使用最常见的 Basic 认证
        AuthType Basic
        AuthName "Restricted Access - WebDAV"
        AuthUserFile /etc/apache2/.htpasswd
        
        # 强制要求有效用户才能访问 WebDAV 资源
        Require valid-user
        
    </Directory>
    
    # --- 全局 DocumentRoot 配置 ---
    # 如果 /var/www/html/ 有公共网页，请使用 Require all granted
    <Directory /var/www/html/ >
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted 
    </Directory>

    # 日志记录 (方便故障排除)
    ErrorLog ${APACHE_LOG_DIR}/webdav_error.log
    CustomLog ${APACHE_LOG_DIR}/webdav_access.log combined
</VirtualHost>

🛡️ 第三阶段：创建用户认证文件

我们使用 htpasswd 工具创建用户密码文件，用于 Basic 认证。

# 1. 安装 apache2-utils 工具包
sudo apt install apache2-utils

# 2. 创建密码文件并添加第一个用户 (使用 -c 标志)
# 请替换 'yourusername' 为实际用户名
sudo htpasswd -c /etc/apache2/.htpasswd yourusername

# 3. 添加更多用户 (不带 -c 标志)
sudo htpasswd /etc/apache2/.htpasswd anotherusername

⚙️ 第四阶段：启用配置与测试

1. 测试 Apache 配置文件语法

在启用新的虚拟主机前，务必检查语法是否正确：

sudo apache2ctl configtest
# 预期输出: Syntax OK

2. 启用配置并最终重启

sudo a2ensite webdav.conf
sudo systemctl restart apache2

3. 测试访问

在您的系统文件管理器（Windows/macOS/Linux）中，使用 davs://webdav.homelab.org/webdav 地址进行连接。系统会提示您输入用户名和密码。连接成功后，您就可以像操作本地文件夹一样管理文件了。

🚫 SEO 保护：阻止搜索引擎索引 WebDAV

为了防止您的私人文件和目录结构被 Google 等搜索引擎抓取，这是 强制性 的安全和 SEO 最佳实践。

在您的网站根目录 (/var/www/html/) 下创建 robots.txt 文件：

sudo nano /var/www/html/robots.txt
User-agent: *
Disallow: /webdav/

# 或者使用下面这个，直接禁止搜索引擎抓取任何关于这个webdav站点的任何内容
User-agent: *
Disallow: /