micromata/dave

dave - 简单的WebDAV服务器

dave是一款轻量的WebDAV服务器，具备以下核心功能：

• 单二进制文件，支持Windows、Linux和OSX系统运行
• HTTP基础认证机制
• TLS加密支持（按需启用）
• 简单用户管理，支持用户目录隔离或全目录管理员权限
• 配置热重载，无需重启即可更新用户设置
• 内置CLI工具生成BCrypt密码哈希

它非常适合通过OSX Finder、Windows资源管理器或Linux Nautilus等常见工具，为用户提供文件上传、下载和共享能力。项目名称dave是Distributed Authoring and Versioning made easy的缩写。

目录

• 配置
  • 快速开始
  • TLS设置
  • 反向代理部署
  • 用户管理
  • 日志配置
  • 热重载
  • 运行dave
• 连接服务器
• 贡献
• 许可证

配置

dave通过yaml文件配置，会按以下顺序查找config.yaml：

• ./config目录
• $HOME/.swd目录（swd是dave的初始项目名）
• $HOME/.dave目录
• 当前工作目录

快速开始

以下是一个简单的功能配置示例：

yaml
address: "127.0.0.1"    # 绑定地址
port: "8000"            # 监听端口
dir: "/home/webdav"     # 基础目录
prefix: "/webdav"       # URL前缀
users:
  user:                 # 密码为'foo'，仅能访问'/home/webdav/user'
    password: "$2a$10$yITzSSNJZAdDZs8iVBQzkuZCzZ49PyjTiPIrmBUKUpB0pwX7eySvW"
    subdir: "/user"
  admin:                # 密码为'foo'，可访问全部目录
    password: "$2a$10$DaWhagZaxWnWAOXY0a55.eaYccgtMOL3lGlqI3spqIBGyM0MD.EN6"

配置后服务器可通过http://127.0.0.1:8000/webdav访问。

TLS设置

首先使用openssl生成证书和密钥：

bash
# 生成密钥对
openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365
# 移除密钥中的密码
openssl rsa -in key.pem -out clean_key.pem

然后在配置中添加TLS部分：

yaml
address: "127.0.0.1"
port: "8000"
dir: "/home/webdav"
tls:
  keyFile: clean_key.pem
  certFile: cert.pem
users:
...

注意：当前版本要求私钥无密码，否则启动失败。

跨域资源共享（CORS）

若需从浏览器应用访问服务器，可配置CORS：

yaml
cors:
  origin: "*"

生产环境需谨慎使用通配符，避免安全风险。

反向代理部署

dave支持反向代理，以下是Apache2的配置示例：

apache
<Location /webdav>
  ProxyPass           https://webdav-host:8000/
  ProxyPassReverse    https://webdav-host:8000/
</Location>

用户管理

用户配置可选，若添加用户需包含密码（BCrypt哈希），可配置子目录隔离：

• 密码生成：使用内置工具davecli passwd
• 子目录配置：用户将被限制在指定子目录内；无配置则可访问全部基础目录

日志配置

可启用/禁用以下操作日志：

• C：文件/目录创建
• R：文件/目录读取
• U：文件/目录更新
• D：文件/目录删除
• 错误日志

默认所有操作日志关闭，启用示例：

yaml
address: "127.0.0.1"
port: "8000"
dir: "/home/webdav"
log:
  error: true
  create: true
  read: true
  update: true
  delete: true
...

热重载

修改用户或日志配置时无需重启服务器，系统会自动后台重载配置。

运行dave

Docker部署示例：

bash
# 创建WebDAV目录
mkdir webdav-home

# 启动容器
docker run -d \
  -p 8000:8000 \
  -v $(pwd)/examples/config-sample.yaml:/config.yaml:ro \
  -v $(pwd)/webdav-home:/tmp:rw \
  micromata/dave:latest

连接服务器

使用支持WebDAV协议的工具连接，例如：

• OSX：Finder中按CMD+K，输入地址（如http://localhost:8000）并连接
• Windows：资源管理器中输入地址，使用配置的用户名和密码登录

贡献

欢迎通过项目仓库提交贡献。

许可证

项目依赖组件遵循各自许可证，本项目开发部分基于Apache 2 License。