bytemark/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 docker.xuanyuan.run/bytemark/webdav

通过Docker Compose部署：

yaml
version: '3'
services:
  webdav:
    image: docker.xuanyuan.run/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

若接受自签名SSL证书，可指定-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 docker.xuanyuan.run/bytemark/webdav

若需使用自定义证书，可将证书链绑定挂载到/cert.pem，私钥绑定挂载到/privkey.pem，容器将自动使用这些文件。

多客户端认证

USERNAME和PASSWORD仅支持单用户。如需多用户登录，可绑定挂载自定义user.passwd文件到/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（或绑定挂载自定义认证文件到/user.passwd），否则无法访问WebDAV服务器。

• SERVER_NAMES：逗号分隔的域名列表（如example.com,www.example.com）。第一个域设置为https://httpd.apache.org/docs/current/mod/core.html#servername%EF%BC%8C%E5%85%B6%E4%BD%99%EF%BC%88%E5%A6%82%E6%9C%89%EF%BC%89%E8%AE%BE%E7%BD%AE%E4%B8%BAhttps://httpd.apache.org/docs/current/mod/core.html#serveralias%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%60localhost%60%E3%80%82
• LOCATION：WebDAV的URL路径（如设置为/webdav，客户端需连接example.com/webdav）。默认值：/。
• AUTH_TYPE：Apache认证类型，可选Basic（HTTPS推荐）或Digest（HTTP推荐）。默认值：Basic。
• REALM：设置https://httpd.apache.org/docs/current/mod/mod_authn_core.html#authname%EF%BC%8C%E5%AE%A2%E6%88%B7%E7%AB%AF%E8%BF%9E%E6%8E%A5%E6%97%B6%E6%98%BE%E7%A4%BA%E7%9A%84%E6%A0%87%E8%AF%86%E7%AC%A6%E3%80%82%E9%BB%98%E8%AE%A4%E5%80%BC%EF%BC%9A%60WebDAV%60%E3%80%82
• USERNAME：认证用户名（配合下方密码使用）。若绑定挂载自定义认证文件，此变量将被忽略。
• PASSWORD：认证密码（配合上方用户名使用）。若绑定挂载自定义认证文件，此变量将被忽略。
• ANONYMOUS_METHODS：逗号分隔的HTTP请求方法列表（如GET,POST,OPTIONS,PROPFIND）。指定的方法无需认证即可使用。设置为ALL可禁用认证。默认值：禁止***访问。
• SSL_CERT：设置为selfsigned时生成自签名证书并启用Apache SSL模块。若指定SERVER_NAMES，第一个域将作为通用名称（Common Name）。