k3vmcd/webdav

镜像概述

本镜像为bytemark/webdav的克隆版本，运行基于Apache的可配置WebDAV服务器。其核心特点是启用了socache_shmcb模块，以修复SSL相关错误。支持配置认证类型（Basic/Digest）、多用户认证、自签名SSL证书或自定义证书，适用于搭建文件共享服务。

核心功能与特性

• 灵活认证：支持Basic（适合HTTPS）和Digest（适合HTTP）两种认证方式
• 多用户管理：通过自定义用户文件支持多用户登录
• SSL支持：可生成自签名证书或使用自定义证书链
• 持久化存储：支持卷挂载或目录绑定以保存数据
• 配置灵活：通过环境变量自定义服务器名称、访问路径、认证领域等

支持的标签

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

快速参考

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

使用场景

• 个人文件共享服务器
• 团队协作文件存储
• 本地开发环境的文件共享服务
• 需要简单配置的WebDAV服务搭建

使用方法

基本WebDAV服务器

启动端口80上的WebDAV服务器，支持单用户认证。建议使用Digest认证（适用于HTTP）以避免密码明文传输。推荐使用持久化卷或目录绑定确保数据不丢失。

Docker命令示例：

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%8D%E8%AF%81%E4%B9%A6%EF%BC%8C%E8%AE%BE%E7%BD%AE%60SSL_CERT=selfsigned%60%E5%8D%B3%E5%8F%AF%E8%87%AA%E5%8A%A8%E7%94%9F%E6%88%90%E3%80%82

自签名证书示例：

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  # 添加用户alice
htpasswd -B user.passwd bob    # 添加用户bob

Digest认证用户文件创建：

bash
touch user.passwd
htdigest user.passwd WebDAV alice  # 默认领域为WebDAV
htdigest user.passwd WebDAV bob    # 若自定义领域需重新生成

挂载用户文件：

bash
docker run --restart always -v /srv/dav:/var/lib/dav \
    -v /path/to/user.passwd:/user.passwd \
    --publish 80:80 -d bytemark/webdav

环境变量

所有环境变量均为可选，但建议至少配置USERNAME和PASSWORD（或挂载自定义认证文件）以确保访问控制。