hhs66317/webdav

webdav镜像说明

镜像概述

本镜像基于Alpine系统构建，通过apk安装Nginx及相关模块（nginx-mod-http-dav-ext、nginx-mod-http-fancyindex等），提供WebDAV服务。需注意：Nginx原生WebDAV功能不完整，Windows驱动器映射仅支持读取，无法写入（缺少PROPPATCH方法支持），但多数客户端（如移动端App、WinSCP）可正常使用。

核心功能

1. 支持单用户登录：通过环境变量USERNAME和PASSWORD设置
2. 支持多用户登录：通过挂载htpasswd文件实现，优先级高于单用户模式
3. 时区配置：通过TZ环境变量设置，默认Asia/Shanghai
4. HTTPS支持：挂载SSL证书即可启用
5. 自定义配置：支持挂载nginx.conf修改服务参数

使用场景

• 个人文件远程访问与共享
• 团队协作中的文件同步与管理
• 家庭NAS的WebDAV服务扩展

配置说明

拉取镜像

bash
docker pull hhs66317/webdav

单用户部署（Docker Compose示例）

yaml
version: "3"
services:
  webdav:
    image: hhs66317/webdav
    container_name: webdav
    hostname: webdav
    environment:
      USERNAME: matthew
      PASSWORD: EMLsRqL8iNbgg7iaqqQ4EXfNebUzZric
      TZ: "Asia/Shanghai"
    volumes:
      - /share/homes/admin/.Qsync/webdav:/data  # 共享文件目录
      - /share/Public/webdav/conf/nginx.conf:/etc/nginx/nginx.conf  # 自定义Nginx配置
      - /share/Public/webdav/conf/certs:/etc/nginx/certs  # SSL证书目录
    restart: unless-stopped
    ports:
     - 80:80

多用户部署（Docker Compose示例）

yaml
version: "3"
services:
  webdav:
    image: hhs66317/webdav
    container_name: webdav
    hostname: webdav
    environment:
      TZ: "Asia/Shanghai"
    volumes:
      - /share/homes/admin/.Qsync/webdav:/data
      - /share/Public/webdav/conf/htpasswd:/etc/nginx/htpasswd  # 多用户认证文件
      - /share/Public/webdav/conf/nginx.conf:/etc/nginx/nginx.conf
      - /share/Public/webdav/conf/certs:/etc/nginx/certs
    restart: unless-stopped
    ports:
     - 80:80

多用户目录限定配置

若需不同用户使用独立目录（仅特定用户访问根目录），可修改nginx.conf：

nginx
http {
    ...
    map $remote_user $profile_directory {
        default      /data/$remote_user;  # 默认用户使用/data下的子目录
        matthew     /data;  # 特定用户matthew直接访问根目录
    }
    
    server {
    ...
        location / {
            ...
            root $profile_directory;
        }
    }
}

注意事项

• 多用户模式需提前生成htpasswd文件（推荐Md5加密）
• 共享文件需挂载到/data目录
• SSL证书需放置在/etc/nginx/certs目录并在nginx.conf中配置
• 自定义nginx.conf可调整服务端口、权限等参数