clickhouse/nginx-dav

WebDAV测试集成镜像文档

镜像概述

本Docker镜像专为集成测试场景设计，提供轻量级WebDAV服务环境，旨在帮助开发和测试人员快速搭建符合标准的WebDAV服务，用于验证WebDAV客户端应用或依赖WebDAV协议的系统组件功能正确性。镜像基于高效的WebDAV服务器实现，支持动态配置，可无缝集成到自动化测试流程中。

核心功能与特性

• 标准协议支持：兼容WebDAV协议（RFC 4918），支持核心操作（PROPFIND、MKCOL、PUT、GET、DELETE、MOVE等）
• 轻量级部署：镜像体积小巧，启动快速，资源占用低，适合测试环境
• 灵活认证配置：支持基本认证（Basic Auth），可通过环境变量自定义用户名和密码
• 可定制存储：支持指定数据存储路径，支持数据卷挂载以持久化测试数据
• 即开即用：默认配置无需复杂设置，一键启动即可提供WebDAV服务

使用场景与适用范围

• WebDAV客户端应用集成测试：验证客户端的文件上传、下载、目录创建等功能
• 系统组件测试：测试依赖WebDAV服务的系统模块（如文件同步工具、内容管理系统）
• 自动化测试流水线：作为测试环境服务，集成到CI/CD流程中进行功能验证
• 开发环境模拟：为开发人员提供本地WebDAV服务模拟，无需依赖外部服务

使用方法与配置说明

基本使用（无认证）

通过以下命令快速启动无认证的WebDAV服务：

bash
docker run -d -p 8080:80 --name webdav-test [镜像名称]

服务启动后，可通过 http://localhost:8080 访问WebDAV服务。

带认证的使用

通过环境变量配置基本认证：

bash
docker run -d \
  -p 8080:80 \
  -e USERNAME=testuser \
  -e PASSWORD=testpass123 \
  --name webdav-test-auth \
  [镜像名称]

客户端访问时需提供用户名 testuser 和密码 testpass123 进行认证。

自定义存储路径

通过数据卷挂载指定本地目录作为WebDAV存储路径：

bash
docker run -d \
  -p 8080:80 \
  -v /local/test/data:/webdav \
  --name webdav-test-custom-storage \
  [镜像名称]

容器内WebDAV服务默认存储路径为 /webdav，挂载本地目录后可持久化测试文件。

Docker Compose配置示例

创建 docker-compose.yml 文件集成到测试环境：

yaml
version: '3'
services:
  webdav-test:
    image: [镜像名称]
    ports:
      - "8080:80"
    environment:
      - USERNAME=test
      - PASSWORD=test123
      - STORAGE_PATH=/webdav/data
    volumes:
      - ./test-data:/webdav/data
    restart: unless-stopped

启动服务：docker-compose up -d

环境变量配置说明

注：当同时设置 USERNAME 和 PASSWORD 时，自动启用基本认证，ALLOW_ANONYMOUS 配置失效。

测试验证示例

使用 curl 验证WebDAV服务可用性（无认证场景）：

bash
# 查看目录列表
curl -X PROPFIND http://localhost:8080/ -H "Depth: 1"

# 创建目录
curl -X MKCOL http://localhost:8080/testdir

# 上传文件
echo "test content" > test.txt
curl -X PUT -T test.txt http://localhost:8080/testdir/test.txt

# 下载文件
curl -O http://localhost:8080/testdir/test.txt

带认证场景需添加 -u username:password 参数：

bash
curl -u testuser:testpass123 -X PROPFIND http://localhost:8080/ -H "Depth: 1"