seanhoughton/webdav

Nginx WebDAV容器

镜像概述与主要用途

该镜像基于Nginx，提供通过WEBDAV协议共享和访问数据的功能。它允许用户便捷地通过WEBDAV协议上传、下载和管理文件，适用于需要简单数据共享解决方案的场景。

核心功能与特性

• 支持数据持久化存储，通过挂载卷实现数据保存
• 可配置用户认证，支持guest模式（无需密码）或指定用户密码
• 提供Nginx性能参数调整，如工作进程数、最大连接数等
• 支持LDAP集成，可通过LDAP服务器进行用户认证
• 可配置访问日志记录，便于监控和分析
• 支持自定义监听端口和访问控制（通过子网限制写入权限）

使用场景与适用范围

• 个人数据共享：需要通过WEBDAV协议访问个人文件
• 小型团队协作：团队成员通过WEBDAV共享项目文件
• 应用数据服务：为其他应用提供基于WEBDAV的数据访问接口
• 临时文件存储：需要快速搭建的文件上传/下载服务

使用方法与配置说明

卷挂载

以下路径可通过卷挂载进行配置：

环境变量

可通过环境变量配置容器行为，具体如下：

Docker部署示例

docker run命令示例

bash
docker run -d \
  -p 8080:80 \
  -v /path/to/data:/data \
  -v /path/to/tmp:/tmp/upload \
  -v /path/to/logs:/log \
  -e WEBDAV_USERNAME=admin \
  -e WEBDAV_PASSWORD=secret \
  -e WORKER_COUNT=2 \
  -e LISTENPORT=80 \
  --name nginx-webdav \
  nginx-webdav

docker-compose配置示例

yaml
version: '3'
services:
  webdav:
    image: nginx-webdav
    ports:
      - "8080:80"
    volumes:
      - ./data:/data
      - ./tmp:/tmp/upload
      - ./logs:/log
    environment:
      - WEBDAV_USERNAME=admin
      - WEBDAV_PASSWORD=secret
      - WORKER_COUNT=2
      - TRUSTED_SUBNET=192.168.1.0/24
      - USE_PERFLOG=1
    restart: always

相关资源

• Nginx DAV模块文档
• Nginx优化：理解sendfile、tcp_nodelay和tcp_nopush
• Nginx静态内容服务指南
• https://github.com/kvspb/nginx-auth-ldap
• Nginx监控指南

替代方案

• https://github.com/jgeusebroek/docker-webdav