undergrid/apache-webdav

undergrid/apache-webdav

镜像概述和主要用途

该容器基于Alpine Linux 3.7和Apache 2.4提供WebDAV功能。与常规WebDAV默认从子目录（如[***]

核心功能和特性

• 基于轻量级Alpine Linux 3.7和Apache 2.4
• 默认从域名根目录提供WebDAV服务
• 支持SSL和非SSL端口访问
• 可通过环境变量配置用户ID（PUID）和组ID（PGID），避免权限问题
• 支持时区设置和时间同步
• 提供默认用户凭据，支持自定义密码和添加新用户

使用场景和适用范围

• 需要简单WebDAV服务的个人或小型团队
• 作为反向代理后端的WebDAV服务节点
• 需通过网络共享文件并支持WebDAV协议的场景

使用方法和配置说明

基本部署命令

bash
docker create \
    --name apache-webdav \
    -p 80:80 \
    -p 443:443 \
    -e PUID=<UID> \
    -e PGID=<GID> \
    -e TZ=<timezone> \ 
    -v /etc/localtime:/etc/localtime:ro \
    -v </path/to/config>:/config \
    -v </path/to/data>:/webdav \
    undergrid/apache-webdav

参数说明

参数格式为主机端:容器端，左侧代表主机配置，右侧代表容器内部配置：

• 端口映射

  • -p 80：非SSL WebDAV端口
  • -p 443：SSL WebDAV端口

• 数据卷

  • -v /config：Apache配置文件目录
  • -v /webdav：WebDAV可访问的文件目录
  • -v /etc/localtime:/etc/localtime:ro：用于时间同步（详见Localtime）

• 环境变量

  • -e TZ：时区信息，如Europe/London（详见Localtime）
  • -e PGID：组ID（详见用户/组ID）
  • -e PUID：用户ID（详见用户/组ID）

本容器基于Alpine Linux并使用S6 overlay。

Localtime

必须设置以下任一选项以确保时间同步：

• 挂载本地时间文件：-v /etc/localtime:/etc/localtime:ro
• 设置时区环境变量：-e TZ=<timezone>（如Asia/Shanghai）

用户/Group Identifiers

使用数据卷（-v标志）时，主机OS与容器之间可能出现权限问题。通过指定PUID（用户ID）和PGID（组ID）可避免此问题。确保主机上的数据卷目录归属于指定的用户，即可正常工作。

例如，PUID=1001和PGID=1001。可通过以下命令获取当前用户的ID：

bash
$ id <dockeruser>
  uid=1001(dockeruser) gid=1001(dockergroup) groups=1001(dockergroup)

WebDAV配置

默认凭据

容器默认使用以下凭据：

• 用户名：admin
• 密码：password

修改密码

容器运行后，通过以下命令修改密码：

bash
docker exec -it apache-webdav htdigest /config/apache/user.passwd DAV-upload admin

执行后会提示输入新密码。

添加新用户

容器运行后，通过以下命令添加新用户（将username替换为实际用户名）：

bash
docker exec -it apache-webdav htdigest -v /config/apache/user.passwd DAV-upload username

执行后会提示输入该用户的密码。

允许用户写入文件

默认情况下，仅admin用户有权写入WebDAV目录。如需允许其他用户写入，需修改配置文件/path/to/config/apache/site-confs/default.conf：

找到以下段落（端口80和443配置中各出现一次）：

<RequireAll>
    Require method PUT POST DELETE PROPPATCH MKCOL COPY MOVE LOCK UNLOCK
    Require user admin
</RequireAll>

将Require user admin修改为Require valid-user：

<RequireAll>
    Require method PUT POST DELETE PROPPATCH MKCOL COPY MOVE LOCK UNLOCK
    Require valid-user
</RequireAll>

修改后需重启容器使配置生效。

进一步自定义

可通过创建用户独立目录等方式进行更复杂的配置，具体配置需用户自行实现。

信息查看

实时日志监控

bash
docker logs -f apache-webdav

容器版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' apache-webdav

镜像版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' undergrid/apache-webdav

版本历史

• 08.03.17：初始发布