Apache配置WebDAV实现团队协同办公，核心是模块顺序加载（dav_module在dav_fs_module前）、Directory块中Dav on/DavDepthInfinity on/Require valid-user三要素齐全、系统权限与SELinux/AppArmor策略到位，且Windows客户端需满足http协议、MS-Author-Via头、无尾斜杠三条件。
Apache配置WebDAV服务实现团队内部云端协同办公，核心在于可写、可锁、可认证、可跨平台访问。它不是简单挂个目录，而是要让Windows资源管理器、macOS Finder、rclone、Obsidian等工具都能稳定连接并支持文件锁定、递归操作和多用户协作。下面分四块讲清楚关键实操点。
模块加载与基础启用必须一步到位
缺一不可，顺序不能错：
- dav_module 必须在 dav_fs_module 之前加载（否则DAV功能静默失效）
- 运行
apache2ctl -M | grep dav确认输出含dav_module和dav_fs_module；若缺dav_lock_module，也建议启用（支持文件加锁，避免多人同时编辑冲突） - 认证模块至少启用
auth_basic（mod_auth_basic），否则 PUT/DELETE/MKCOL 操作会返回 500 错误，日志仅显示 “Could not open property database”——这是最常被误判的坑 - 确保
headers_module已启用（Windows客户端必需，用于添加MS-Author-Via: DAV响应头）
目录配置块里三个字段不能少、不能错位
放在
-
Dav on—— 全小写，不是 On、ON 或 1；写错即失效 -
DavDepthInfinity on—— 否则 macOS Finder、rclone 无法展开子目录，卡在根路径 -
Require valid-user—— 必须放在AuthType和AuthUserFile之后；否则认证形同虚设，所有请求直接 403
示例（推荐用
Apache Superset Dashboard and SQL Exploration Skill
下载
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
Dav on
DavDepthInfinity on
Options Indexes FollowSymLinks
AllowOverride None
AuthType Basic
AuthName "Team Workspace"
AuthUserFile /etc/apache2/.webdav-passwd
Require valid-user
权限与安全必须双管齐下
光有认证不够，系统级权限和策略限制同样关键：
- Apache 运行用户（如
www-data）对 WebDAV 目录必须有 读+写+执行 权限：sudo chown -R www-data:www-data /var/www/webdavsudo chmod -R 755 /var/www/webdav - SELinux 用户（RHEL/CentOS）需运行：
setsebool -P httpd_can_network_connect 1chcon -t httpd_sys_rw_content_t /var/www/webdav - Ubuntu（AppArmor）用户需确认
/etc/apparmor.d/usr.sbin.apache2允许写入目标路径，或临时禁用测试：sudo aa-disable /usr/sbin/apache2 - 密码文件（如
.webdav-passwd）权限设为640，属组为www-data，防止被 Web 访问泄露
Windows客户端连接失败？重点查这三点
Windows 自带映射网络驱动器对 WebDAV 协议极其敏感，90% 的“找不到网络路径”问题源于以下配置：
-
URL 必须是 http://，不能是 https:// —— 除非已手动启用注册表项：
HKEY_LOCAL_MACHINESYSTEMCurrentControlSetServicesWebClientParametersBasicAuthLevel = 2 -
响应头必须含
MS-Author-Via: DAV—— 在 Apache 配置中加入：Header set MS-Author-Via "DAV"（需先a2enmod headers） -
路径末尾不能带斜杠 —— 正确：
http://team.example.com/webdav；错误：http://team.example.com/webdav/
连接时使用格式：\team.example.com@80webdav（HTTP）或 \team.example.com@443webdav（HTTPS + 注册表启用后）。
