mrwulf/webdav

支持的标签

• https://github.com/BytemarkHosting/docker-webdav/blob/master/2.4/Dockerfile

快速参考

该镜像运行一个易于配置的基于Apache的WebDAV服务器。可配置认证类型、多用户认证，或使用自签名SSL证书运行。如需Let's Encrypt证书，可参考https://github.com/BytemarkHosting/configs-webdav-docker%E3%80%82

• 代码仓库：https://github.com/BytemarkHosting/docker-webdav
• 问题反馈：https://github.com/BytemarkHosting/docker-webdav/issues
• 维护者：Bytemark Hosting
• 支持架构：https://hub.docker.com/_/httpd/

使用方法

基本WebDAV服务器

此示例在80端口启动WebDAV服务器，仅可通过单个用户名和密码访问。使用未加密HTTP时，建议使用Digest（摘要）认证而非Basic（基本）认证，避免明文密码传输。为确保数据持久化，建议创建持久存储卷（-v vol-webdav:/var/lib/dav）或绑定挂载目录（-v /path/to/directory:/var/lib/dav）：

bash
docker run --restart always -v /srv/dav:/var/lib/dav \
    -e AUTH_TYPE=Digest -e USERNAME=alice -e PASSWORD=secret1234 \
    --publish 80:80 -d bytemark/webdav

通过Docker Compose：

yaml
version: '3'
services:
  webdav:
    image: bytemark/webdav
    restart: always
    ports:
      - "80:80"
    environment:
      AUTH_TYPE: Digest
      USERNAME: alice
      PASSWORD: secret1234
    volumes:
      - /srv/dav:/var/lib/dav

带SSL的安全WebDAV

建议使用反向代理（如Traefik）处理SSL证书，示例参考https://github.com/BytemarkHosting/configs-webdav-docker%E3%80%82%E8%8B%A5%E4%BD%BF%E7%94%A8%E8%87%AA%E7%AD%BE%E5%90%8DSSL%E8%AF%81%E4%B9%A6%EF%BC%8C%E6%8C%87%E5%AE%9A%60-e SSL_CERT=selfsigned`，容器将自动生成：

bash
docker run --restart always -v /srv/dav:/var/lib/dav \
    -e AUTH_TYPE=Basic -e USERNAME=test -e PASSWORD=test \
    -e SSL_CERT=selfsigned --publish 443:443 -d bytemark/webdav

若需使用自定义证书，将证书链绑定挂载至/cert.pem，私钥绑定挂载至/privkey.pem即可。

多客户端认证

USERNAME和PASSWORD仅支持单用户。如需多用户登录，绑定挂载自定义/user.passwd文件。

使用Basic认证：

bash
touch user.passwd
htpasswd -B user.passwd alice
htpasswd -B user.passwd bob

使用Digest认证： （默认REALM为WebDAV，若自定义REALM，需使用新名称重新运行htdigest）

bash
touch user.passwd
htdigest user.passwd WebDAV alice
htdigest user.passwd WebDAV bob

创建完成后，通过-v /path/to/user.passwd:/user.passwd绑定挂载至容器。

环境变量

所有环境变量均为可选，但建议至少指定USERNAME和PASSWORD（或绑定挂载认证文件），否则无法访问服务器。

• SERVER_NAMES：逗号分隔的域名列表（如example.com,www.example.com）。第一个域设置为ServerName，其余为ServerAlias。默认值：localhost。
• LOCATION：WebDAV的URL路径（如设为/webdav，客户端需连接example.com/webdav）。默认值：/。
• AUTH_TYPE：Apache认证类型，可选Basic（HTTPS推荐）或Digest（HTTP推荐）。默认值：Basic。
• REALM：设置AuthName，客户端连接时显示的标识符。默认值：WebDAV。
• USERNAME：认证用户名（与下方密码配合使用）。若绑定挂载/user.passwd，此变量失效。
• PASSWORD：认证密码（与上方用户名配合使用）。若绑定挂载/user.passwd，此变量失效。
• ANONYMOUS_METHODS：逗号分隔的HTTP方法列表（如GET,POST,OPTIONS,PROPFIND）。指定的方法无需认证即可使用。设为ALL禁用认证。默认值：禁止***访问。
• SSL_CERT：设为selfsigned以生成自签名证书并启用Apache SSL模块。若指定SERVER_NAMES，第一个域作为通用名称（Common Name）。