WebDAV
这一篇分两层
config.toml里的[webdav]—— 路径前缀和上传体积硬上限，改完要重启管理 -> 系统设置 -> WebDAV—— 总开关和系统文件拦截规则，保存后立即影响新请求，不用重启
普通用户用 WebDAV 一般只关心：在要连接的工作空间里创建专用账号，把地址塞进 Finder / Windows / rclone。个人空间和团队空间的 WebDAV 地址相同，账号凭据决定进入哪个工作空间。
config.toml 里的静态配置
[webdav]
prefix = "/webdav"
payload_limit = 10737418240
xml_payload_limit = 1048576| 选项 | 默认值 | 作用 |
|---|---|---|
prefix | "/webdav" | WebDAV 路径前缀；改完客户端地址也要一起改 |
payload_limit | 10737418240 | WebDAV 文件写入请求体硬上限，默认 10 GiB |
xml_payload_limit | 1048576 | WebDAV XML 类请求体硬上限，默认 1 MiB；用于 PROPFIND、PROPPATCH、REPORT、LOCK |
这些静态项改完要重启服务
和后台总开关不一样，静态配置只在启动时读一次。
后台运行时设置
入口：
管理 -> 系统设置 -> WebDAV这里有三项：
- 启用 WebDAV：总开关。关闭后桌面客户端会立刻无法继续访问，不需要重启
- 阻止 WebDAV 系统文件：默认开启，用来拦住 Finder、Windows 资源管理器和同步工具自动生成的系统元数据文件
- WebDAV 系统文件拦截规则：按文件或目录 basename 匹配，忽略大小写，支持简单的
*通配符
默认拦截这些名字：
.DS_Store._*.Spotlight-V100.Trashes.fseventsdThumbs.dbdesktop.ini$RECYCLE.BINSystem Volume Information
这些文件通常不是用户真正想保存的内容。开启拦截后，客户端尝试通过 WebDAV 创建它们时会收到 403，普通文件上传不受影响。
什么时候需要改规则
大多数站点保持默认就好。只有在你明确要备份这些系统元数据，或者某个客户端因为拦截规则反复报错影响正常同步时，再按实际客户端行为调整。
普通用户的标准用法
- 在要连接的工作空间里打开
WebDAV，创建一个专用账号 - 设用户名和密码
- 需要的话限制到根目录下某个文件夹
- 把地址、用户名、密码填进 Finder、Windows 资源管理器、rclone、Mountain Duck
用专用账号，不要复用网页登录密码
WebDAV 专用账号的密码、范围都能单独管理，丢了也不会影响主账号。
个人空间的 WebDAV 账号只访问个人文件。团队空间的 WebDAV 账号在团队工作空间或 设置 -> 团队 -> 团队详情 -> WebDAV 里创建，只访问对应团队文件；团队所有者和管理员可以管理全队账号，普通成员只能管理自己的团队 WebDAV 账号。
默认地址
https://你的域名/webdav//webdav/ 这个挂载根只作为入口和列表边界存在，不是数据库里的真实文件夹。客户端可以对它做 PROPFIND 来列出根目录，但不能对它做 PROPPATCH 写自定义 dead properties；这种请求会明确返回 403 Forbidden。需要保存自定义属性时，目标必须是具体文件或文件夹。
如果把 prefix 改成 /dav，客户端地址也改：
https://你的域名/dav/上传大文件要看三处
通过 WebDAV 上传大文件时，下面三个上限取最小值生效：
webdav.payload_limit- 反向代理的上传大小限制（Nginx
client_max_body_size/ Caddy 等） - 存储策略里的单文件大小限制
任何一个卡住，整体就卡住——排查时三处都要看。
xml_payload_limit 不限制文件内容上传，它只限制 WebDAV 的 XML 控制请求。除非客户端发出特别大的目录查询、锁请求或属性更新请求，否则一般不用调整。
锁和并发写入
AsterDrive 支持 WebDAV 常见的 LOCK / UNLOCK 流程，包括独占锁和共享锁。锁存在时，客户端需要带正确的 Lock-Token 或 If 条件继续写入；否则覆盖、移动、复制、删除这类可能破坏一致性的操作会被拒绝。
需要注意：
- 同一个资源在协议允许时可以存在多把共享锁
- 递归移动、复制、删除文件夹时，会检查目标树和源树里是否有冲突锁
- 过期锁会被后台清理；客户端异常退出导致的残留锁也可以在
管理 -> 锁里清理
如果桌面客户端提示 locked、conflict 或 precondition failed，先确认同一个文件是否还在其他客户端或在线编辑器里打开。确认没有其他人使用后，再等锁过期，或让管理员到 管理 -> 锁 清理异常锁。
反向代理时不要丢这些
WebDAV 不只是 GET/PUT
WebDAV 用了一堆扩展方法和头部，反向代理常常默认丢掉。请确保代理层透传：
头部： Authorization、Depth、Destination、Overwrite、If、Lock-Token、Timeout
方法： PROPFIND、PROPPATCH、MKCOL、MOVE、COPY、LOCK、UNLOCK
完整反向代理示例见 反向代理部署。