hacdias/webdav是开箱即用的webdav服务端，完整实现rfc 4918协议（含propfind、lock等十余方法及xml/etag/锁机制），避免手写易错；3行代码即可启动带认证的生产级服务，支持内存或磁盘文件系统、bcrypt密码、crud权限控制。
直接用 github.com/hacdias/webdav 这个库最省事，它不是客户端而是完整可运行的 WebDAV 服务端，开箱即用，不用自己拼 HTTP handler 或实现 LOCK/PROPFIND 等协议细节。
为什么不用自己实现 WebDAV handler？
WebDAV 不是简单“加个 PUT/DELETE 路由”就能跑通的协议。它依赖 PROPFIND、PROPPATCH、MKCOL、LOCK、UNLOCK 等十几个方法，还要处理 XML 请求体、状态码（如 207 Multi-Status）、ETag、If-None-Match 头、锁令牌（Lock-Token）等。自己手写容易漏逻辑，比如：
• PROPFIND 返回的 XML 格式不标准，Windows 资源管理器会拒绝挂载
• 忘记在 OPTIONS 响应中声明 DAV: 1,2，导致客户端降级为只读模式
• 锁机制没实现或时序错乱，多用户编辑时文件被覆盖
而 hacdias/webdav 已完整覆盖 RFC 4918，经多年生产验证，直接复用比重造轮子更可靠。
启动一个带认证的 WebDAV 服务只需 3 行代码
不是 demo，是真实可用的服务：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
package main
import (
"log"
"github.com/hacdias/webdav"
)
func main() {
handler := &webdav.Handler{
FileSystem: webdav.NewMemFS(), // 或 webdav.NewFileSystem("/path/to/data")
Users: []webdav.User{{
Username: "alice",
Password: "{bcrypt}$2a$10$...",
Permissions: "CRUD",
}},
}
log.Fatal(http.ListenAndServe(":8080", handler))
}
-
webdav.NewMemFS()适合测试；换成webdav.NewFileSystem("/data")即可持久化到磁盘 - 密码必须是 bcrypt 哈希（明文仅用于开发），用
webdav hash-password --password xxx生成 - 权限字符串
"CRUD"对应 Create/Read/Update/Delete，"R"表示只读
Docker 部署时挂载路径和配置的坑
用 Docker 启动时，常见失败原因是路径映射错位或配置未生效：
- 容器内
-v ./data:/data挂载后，directory: /data才能访问宿主机文件；若写成directory: ./data，服务会在容器内部找相对路径，结果是空目录 -
-v ./config.yml:/config.yml:ro中的:ro必须加上，否则webdav进程因无写权限无法启动（它会尝试校验并锁定配置） - 端口映射
-p 6065:6065和配置里port: 6065必须一致，否则浏览器能连，但 Windows 映射网络驱动器会超时 - 若用反向代理（如 Nginx），需透传
Authorization和Depth头，否则认证失败或目录递归失效
Windows 挂载失败的典型原因和验证步骤
不是服务没跑，而是客户端协议协商出问题：
- Windows 资源管理器默认禁用 Basic Auth over HTTP（非 HTTPS），所以
http://localhost:8080会静默失败；要么启用 TLS，要么改用 PowerShell 的net use强制 Basic：net use Z: http://localhost:8080 /user:alice password - 挂载后显示“拒绝访问”，大概率是用户权限没匹配到路径——检查配置中
users[0].directory是否为空，空值表示根目录；若设了directory: /data/alice，但宿主机该路径不存在或权限不足，就会 403 - 右键刷新卡住？说明
PROPFIND响应慢，通常是磁盘 I/O 高或启用了日志 JSON 格式但没配log.outputs导致阻塞
真正麻烦的从来不是启动服务，而是让不同客户端（Windows/macOS/Android 文件管理器）都按协议预期工作——每个系统对 WebDAV 的容忍度不同，得一个个试。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
