efrecon/webdav-client Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Docker化WebDAV客户端

镜像概述和主要用途

该Docker镜像（同时发布于Docker Hub和GHCR）旨在将远程WebDAV资源挂载到容器中。通过davfs2实现挂载功能，支持所有davfs2配置选项)。该镜像可作为轻量级Docker卷使用，通过适当配置可将远程资源绑定挂载到主机目录，使该目录下的内容对主机进程及其他容器可见。容器终止时会自动卸载远程资源。

核心功能和特性

• 基于davfs2实现WebDAV资源挂载，支持完整的davfs2配置选项
• 容器终止时自动卸载远程WebDAV资源，避免系统挂载状态异常
• 支持通过环境变量灵活配置认证信息和挂载参数
• 可通过Docker secrets安全管理密码
• 内置tini，支持在Swarm环境中运行

使用场景和适用范围

适用于需要在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