softbrix/webdav

Docker WebDAV镜像

本项目从https://github.com/jgeusebroek/docker-webdav%E5%88%86%E5%8F%89%E8%80%8C%E6%9D%A5%E3%80%82

一个轻量级镜像，运行https://github.com/gliderlabs/docker-alpine Linux和Lighttpd。

镜像概述和主要用途

该镜像提供了一个简单的WebDAV服务器解决方案，基于轻量级的Alpine Linux和Lighttpd Web服务器。适用于需要快速部署WebDAV服务的场景，支持基本的文件共享功能，并可通过环境变量灵活配置访问控制。

核心功能和特性

• 轻量级：基于Alpine Linux，镜像体积小，资源占用低
• 安全认证：默认提供密码保护，支持自定义用户凭证
• 访问控制：支持IP白名单功能，可限制特定IP访问
• 权限管理：可配置读写权限，默认只读
• 灵活配置：通过环境变量自定义用户ID、组ID等参数

使用场景和适用范围

• 个人文件共享服务器
• 小型团队内部文件协作
• 开发环境中的临时文件共享
• 需要简单WebDAV服务的嵌入式设备或服务器

使用方法和配置说明

基本使用

通过以下命令启动WebDAV服务器：

bash
docker run --restart=always -d \
    -p 0.0.0.0:80:80 \
    --hostname=webdav \
    --name=webdav \
    -v /<主机共享目录>:/webdav \
    softbrix/webdav

默认认证信息

默认情况下，WebDAV服务器受密码保护，用户名为webdav，密码为vadbew。出于安全考虑，建议通过环境变量自定义认证信息。

自定义认证信息

使用HTPASSWD环境变量设置自定义用户和密码哈希：

bash
-e HTPASSWD=<用户名>:<密码哈希>

如果没有安装htpasswd工具（通常在apache2-utils包中），可以使用在线htpasswd生成器（如[***]

可选环境变量

重要：如果使用持久化配置卷，WHITELIST和READWRITE变量仅在首次启动（即尚无自定义配置时）生效。

高级配置示例

带自定义认证和读写权限的配置

bash
docker run --restart=always -d \
    -p 0.0.0.0:8080:80 \
    --name=webdav \
    -v /data/webdav:/webdav \
    -e HTPASSWD="user1:\$apr1\$xyz123\$abcdefghijklmnopqrstuvw" \
    -e READWRITE=true \
    -e WHITELIST='192.168.0.*' \
    softbrix/webdav

许可证

MIT / BSD

作者信息

Jeroen Geusebroek
Andreas Sehr