docker-nginx-webdav-nononsense 镜像文档

镜像概述和主要用途

docker-nginx-webdav-nononsense 是一个基于最新nginx（稳定版和主线版）的WebDAV Docker镜像，旨在提供简洁实用的WebDAV系统。该镜像及生成的容器设计用于在反向代理后运行，专注于WebDAV核心功能，将SSL/TLS、域名管理等功能交由反向代理处理，确保轻量高效。

核心功能和特性

主要特点

• 基于linuxserver.io Ubuntu：包含其用户和组权限处理机制，支持/config卷（详见下文）及s6-overlay v3。
• 增强WebDAV兼容性：借鉴Rob Peck的nginx WebDAV配置指南，集成以下组件：
  1. mid*** fork的nginx-dav-ext-module：支持PROPFIND、OPTIONS、LOCK、UNLOCK等方法，处理隐藏文件夹、符号链接等。
  2. 最新headers-more-nginx-module：兼容各类问题客户端。
  3. 最新ngx-fancyindex：优化目录列表显示效果。
• 客户端兼容性：解决macOS Safari 14+、iOS 14+的NSPOSIXErrorDomain:100错误；开箱支持jc21/nginx-proxy-manager（无需高级配置）、macOS Finder、Windows 11资源管理器（包含rozhuk-im提供的修复）。
• 便捷配置：已预设CORS头，支持通过环境变量自动配置常用参数。

设计用于反向代理

容器不原生支持以下功能，需通过反向代理（如nginx-proxy-manager、caddy）实现：

• SSL/TLS加密
• 域名及子域名管理
• 非根路径访问（如子文件夹）

容器通过内部80端口提供服务，反向代理可实现上述功能及更多扩展。虽然可通过修改暴露的配置文件实现这些功能，但容器本身不原生支持，配置文件仅为方便自定义提供。

配置说明

卷挂载

需挂载以下卷之一或全部：

• ./path/to/dir:/data：WebDAV内容的根目录（nginx将服务此目录下的内容）。
• ./config:/config：包含nginx配置文件及容器整体配置。空文件夹挂载时会自动初始化默认配置文件，可直接编辑。

环境变量

/config卷详情

/config为***卷，包含以下路径和文件：

• /config/nginx：nginx自定义配置目录，包含：
  • http.conf：包含在nginx.conf的http指令末尾
  • server.conf：包含在nginx.conf的server指令末尾
  • location.conf：包含在nginx.conf的location指令末尾

htpasswd认证

若提供/config/nginx/htpasswd文件（Apache HTTP兼容的用户名密码扁平文件），容器将使用此文件进行认证，忽略WEBDAV_USERNAME和WEBDAV_PASSWORD环境变量。所有用户拥有相同访问权限。删除该文件后，容器将恢复使用环境变量认证。

使用方法

快速测试

满足以下条件可快速测试：

1. 数据保存在主机./dav1目录
2. WebDAV用户名为user1，密码为password1
3. 通过主机127.0.0.1:8080访问

bash
docker container run --rm \
  -p 127.0.0.1:8080:80 \
  -v ./dav1:/data \
  -e WEBDAV_USERNAME=user1 \
  -e WEBDAV_PASSWORD=password1 \
  -e PUID=1000 \
  -e PGID=1000 \
  dgraziotin/nginx-webdav-nononsense

访问[***]测试，按CTRL-C停止并删除容器。

构建和运行

• 通过源码构建：克隆仓库，编辑docker-compose.yml，执行docker-compose build && docker-compose up，通过http://localhost:32080访问。
• 直接运行：构建Dockerfile后通过docker run运行，或拉取镜像dgraziotin/nginx-webdav-nononsense使用docker-compose部署。

反向代理配置提醒

• 若反向代理为容器化部署，需将WebDAV容器连接至反向代理网络。
• 建议不暴露WebDAV容器端口，仅通过反向代理访问。
• 反向代理配置需注意超时时间、上传大小限制等参数，避免覆盖WebDAV容器设置（如Cloudflare有100MB上传限制）。

贡献与致谢

构建系统说明

项目使用构建脚本（build.sh）基于Dockerfile.template生成Dockerfile，每次nginx更新时自动更新。提交PR时请修改Dockerfile.template而非直接修改Dockerfile。

致谢

感谢dotWee添加CI功能，FlorianEndel提供可选多用户支持。