efrecon/webdav-client

Docker化WebDAV客户端

镜像概述和主要用途

该Docker镜像（同时发布于https://hub.docker.com/r/efrecon/webdav-client%E5%92%8Chttps://github.com/efrecon/docker-webdav-client/pkgs/container/webdav-client%EF%BC%89%E6%97%A8%E5%9C%A8%E5%B0%86%E8%BF%9C%E7%A8%8BWebDAV%E8%B5%84%E6%BA%90%E6%8C%82%E8%BD%BD%E5%88%B0%E5%AE%B9%E5%99%A8%E4%B8%AD%E3%80%82%E9%80%9A%E8%BF%87davfs2%E5%AE%9E%E7%8E%B0%E6%8C%82%E8%BD%BD%E5%8A%9F%E8%83%BD%EF%BC%8C%E6%94%AF%E6%8C%81%E6%89%80%E6%9C%89davfs2%E9%85%8D%E7%BD%AE%E9%80%89%E9%A1%B9)%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E5%8F%AF%E4%BD%9C%E4%B8%BA%E8%BD%BB%E9%87%8F%E7%BA%A7Docker%E5%8D%B7%E4%BD%BF%E7%94%A8%EF%BC%8C%E9%80%9A%E8%BF%87%E9%80%82%E5%BD%93%E9%85%8D%E7%BD%AE%E5%8F%AF%E5%B0%86%E8%BF%9C%E7%A8%8B%E8%B5%84%E6%BA%90%E7%BB%91%E5%AE%9A%E6%8C%82%E8%BD%BD%E5%88%B0%E4%B8%BB%E6%9C%BA%E7%9B%AE%E5%BD%95%EF%BC%8C%E4%BD%BF%E8%AF%A5%E7%9B%AE%E5%BD%95%E4%B8%8B%E7%9A%84%E5%86%85%E5%AE%B9%E5%AF%B9%E4%B8%BB%E6%9C%BA%E8%BF%9B%E7%A8%8B%E5%8F%8A%E5%85%B6%E4%BB%96%E5%AE%B9%E5%99%A8%E5%8F%AF%E8%A7%81%E3%80%82%E5%AE%B9%E5%99%A8%E7%BB%88%E6%AD%A2%E6%97%B6%E4%BC%9A%E8%87%AA%E5%8A%A8%E5%8D%B8%E8%BD%BD%E8%BF%9C%E7%A8%8B%E8%B5%84%E6%BA%90%E3%80%82

核心功能和特性

• 基于davfs2实现WebDAV资源挂载，支持完整的davfs2配置选项
• 容器终止时自动卸载远程WebDAV资源，避免系统挂载状态异常
• 支持通过环境变量灵活配置认证信息和挂载参数
• 可通过Docker secrets安全管理密码
• 内置https://github.com/krallin/tini%EF%BC%8C%E6%94%AF%E6%8C%81%E5%9C%A8Swarm%E7%8E%AF%E5%A2%83%E4%B8%AD%E8%BF%90%E8%A1%8C

使用场景和适用范围

适用于需要在Docker环境中访问远程WebDAV存储的场景，例如：

• 将WebDAV存储作为共享数据卷供多个容器访问
• 在Swarm集群中统一管理远程WebDAV资源访问
• 需要安全挂载远程WebDAV资源并确保自动清理的场景

使用方法和配置说明

部署示例

假设主机存在/mnt/tmp目录，以下命令将挂载远程WebDAV资源，并将其绑定挂载到主机/mnt/tmp目录，使远程文件对主机进程及其他容器可见：

bash
docker run -it --rm \
    --device /dev/fuse \
    --cap-add SYS_ADMIN \
    --security-opt "apparmor=unconfined" \
    --env "WEBDRIVE_USERNAME=<YourUserName>" \
    --env "WEBDRIVE_PASSWORD=<SuperSecretPassword>" \
    --env "WEBDRIVE_URL=https://dav.box.com/dav" \
    --env "DAVFS2_ASK_AUTH=0" \
    -v /mnt/tmp:/mnt/webdrive:rshared \
    efrecon/webdav-client

参数说明：

• --device /dev/fuse、--cap-add SYS_ADMIN和--security-opt "apparmor=unconfined"：确保容器可使用FUSE挂载文件系统
• rshared：确保绑定挂载的资源可被主机及其他容器递归访问

容器选项

通过环境变量配置容器行为，主要以WEBDRIVE_为前缀：

davFS配置选项

可通过环境变量设置所有davfs2配置选项)。配置项需转换为大写并添加DAVFS2_前缀。例如：

• 要设置ask_auth配置项为0，需设置环境变量DAVFS2_ASK_AUTH=0

命令说明

默认情况下，容器会定期列出挂载目录内容（通过ls.sh脚本实现）。若不需要此行为，可将命令指定为empty.sh。两种命令均通过trap机制确保容器终止时自动卸载WebDAV资源，避免系统挂载状态异常。

示例：使用empty.sh命令运行容器

bash
docker run -it --rm \
    --device /dev/fuse \
    --cap-add SYS_ADMIN \
    --security-opt "apparmor=unconfined" \
    --env "WEBDRIVE_USERNAME=<YourUserName>" \
    --env "WEBDRIVE_PASSWORD=<SuperSecretPassword>" \
    --env "WEBDRIVE_URL=[***]" \
    -v /mnt/tmp:/mnt/webdrive:rshared \
    efrecon/webdav-client empty.sh