chonjay21/webdav

WebDav

镜像概述和主要用途

本镜像基于官方最新httpd镜像构建，提供WebDav服务。旨在创建简单、一致、可定制且便捷的文件共享解决方案，支持多种架构，适用于个人或团队的文件存储与共享需求。

核心功能和特性

• 多架构支持：兼容x86-64、armhf、arm64等架构
• 认证机制：支持BasicAuth和DigestAuth两种认证方式
• SSL加密：可启用HTTPS，自动生成自签名证书，也支持自定义证书
• URL前缀：支持设置URL前缀，适用于反向代理场景
• 权限管理：支持修改umask、用户ID（UID）和组ID（GID）
• 时区自定义：可配置自定义时区
• 事件脚本覆盖：支持自定义事件脚本，实现初始化和运行时的定制逻辑

支持的架构

使用方法

docker (简单版)

bash
docker run -e APP_USER_NAME=admin -e APP_USER_PASSWD=admin -e APP_UID=1000 -e APP_GID=1000 -p 80:80 -p 443:443 -v /webdav/data:/var/webdav/data chonjay21/webdav

docker (完整版)

bash
docker run \
  -e APP_USER_NAME=admin	\
  -e APP_USER_PASSWD=admin	\
  -e APP_UID=1000	\
  -e APP_GID=1000	\
  -e APP_UMASK=007                                                `#可选`	\
  -e TZ=America/Los_Angeles                                       `#可选` \
  -e USE_SSL=true                                                 `#可选`	\
  -e FORCE_REINIT_CONFIG=false                                    `#可选` \
  -e SERVER_NAME=WebDav.example.org                               `#可选` \
  -e DIGEST_AUTH_REALM=WebDav                                     `#可选` \
  -e URL_PREFIX=/webdav                                           `#可选` \
  -p 80:80 \
  -p 443:443 \
  -v /webdav/data:/var/webdav/data \
  -v /webdav/config:/webdav/config                                `#可选，用于持久化数据` \
  -v /webdav/server.key:/usr/local/apache2/conf/server.key:ro     `#可选，用于自定义SSL证书` \
  -v /webdav/server.crt:/usr/local/apache2/conf/server.crt:ro     `#可选，用于自定义SSL证书` \
  chonjay21/webdav

docker-compose

兼容docker-compose v2和v3架构：

yaml
version: '2.2'
services:
  webdav:
    container_name: webdav
    image: "chonjay21/webdav:latest"
    ports:
      - 80:80
      - 443:443
    environment:
      - APP_USER_NAME=admin
      - APP_USER_PASSWD=admin
      - APP_UID=1000
      - APP_GID=1000
      - APP_UMASK=007                                                 #可选
      - TZ=America/Los_Angeles                                        #可选
      - USE_SSL=true                                                  #可选
      - FORCE_REINIT_CONFIG=false                                     #可选
      - SERVER_NAME=WebDav.example.org                                #可选
      - DIGEST_AUTH_REALM=WebDav                                      #可选
      - URL_PREFIX=/webdav                                            #可选
    volumes:
      - /webdav/data:/var/webdav/data
      - /webdav/config:/webdav/config                                 #可选
      - /webdav/server.key:/usr/local/apache2/conf/server.key:ro      #可选
      - /webdav/server.crt:/usr/local/apache2/conf/server.crt:ro      #可选

参数说明

事件脚本

本镜像支持自定义事件脚本，用于实现初始化和运行时的定制逻辑：

覆盖方法

1. 卷挂载覆盖

bash
docker run \
  ...
  -v /webdav/on_pre_init.sh:/sources/webdav/eventscripts/on_pre_init.sh \
  ...
  chonjay21/webdav

2. Dockerfile覆盖

dockerfile
FROM chonjay21/webdav:latest
ADD host/on_pre_init.sh /sources/webdav/eventscripts/

示例：on_pre_init.sh

bash
#!/usr/bin/env bash
set -e

# 从密钥存储获取密码（示例）
APP_USER_PASSWD=$(curl -s https://secret-store.example.com/password)

日志到文件

若需将httpd日志输出到文件（如用于fail2ban等），可使用以下命令重定向日志：

bash
# 追加日志到access.log
docker logs --timestamps -f webdav >> access.log 2>&1 &

# 使用tee命令同时输出到终端和文件
docker logs --timestamps -f webdav | tee -a access.log &

许可证

本镜像的许可证信息请查看https://github.com/chonjay21/docker-webdav/blob/master/LICENSE%E3%80%82
与所有Docker镜像一样，本镜像可能包含其他软件，这些软件可能具有各自的许可证（如基础发行版中的Bash等，以及主要软件的直接或间接依赖）。
使用预构建镜像时，用户有责任确保对本镜像的任何使用都符合其中包含的所有软件的相关许可证。

httpd官方镜像许可证

官方httpd镜像的许可证信息请查看Apache许可证。