photoprism/dummy-webdav

镜像概述和主要用途

Dummy WebDAV Server镜像是一个轻量级的虚拟WebDAV服务器实现，旨在提供简单、快速部署的WebDAV服务环境。主要用于开发、测试或演示场景，帮助用户无需配置复杂的生产级WebDAV服务器，即可快速搭建功能基础但可用的WebDAV服务，适用于验证WebDAV客户端功能、学习WebDAV协议或在开发流程中模拟WebDAV服务依赖。

核心功能和特性

• 轻量级设计：基于精简基础镜像构建，镜像体积小，运行时资源占用低
• 快速部署：无需预先配置，一键启动即可提供基础WebDAV服务
• 协议兼容性：支持WebDAV基础协议操作，包括GET（获取资源）、PUT（上传资源）、MKCOL（创建目录）、DELETE（删除资源）等核心功能
• 可配置性：支持通过环境变量自定义服务端口、根目录路径、访问认证（可选）等参数
• 灵活存储：默认使用临时文件系统（适合无状态测试），也支持挂载外部目录实现数据持久化

使用场景和适用范围

• 开发环境依赖：在应用开发过程中作为WebDAV服务组件，快速搭建本地或测试环境
• 客户端功能验证：测试WebDAV客户端工具（如文件管理器、专用客户端软件）的连接、上传、下载等功能
• 演示环境搭建：在产品演示或技术分享中，快速部署WebDAV服务展示相关功能
• 协议学习实践：供开发者或学习者了解WebDAV协议的基本交互流程和操作方式
• 临时服务需求：需要临时提供WebDAV访问能力的场景（非生产环境）

使用方法和配置说明

基本运行命令

通过以下命令可快速启动基础WebDAV服务：

bash
docker run -d -p 8080:80 --name dummy-webdav dummy-webdav-server

服务启动后，可通过http://localhost:8080访问WebDAV服务，默认支持***访问。

环境变量配置

镜像支持通过环境变量自定义服务参数，常用配置项如下：

带认证的启动示例

启用用户名密码认证并自定义端口：

bash
docker run -d -p 9000:9000 \
  -e PORT=9000 \
  -e USERNAME=testuser \
  -e PASSWORD=testpass123 \
  --name dummy-webdav-auth dummy-webdav-server

访问时需使用用户名testuser和密码testpass123进行基础认证。

数据持久化配置

默认情况下，服务数据存储在容器内的/webdav目录，容器重启后数据会丢失。如需持久化，可挂载宿主机目录到容器内/webdav：

bash
docker run -d -p 8080:80 \
  -v /host/path/to/webdav_data:/webdav \
  --name dummy-webdav-persist dummy-webdav-server

其中/host/path/to/webdav_data为宿主机本地目录，用于持久化存储WebDAV服务的文件数据。

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  webdav:
    image: dummy-webdav-server
    ports:
      - "8080:80"
    environment:
      - PORT=80
      - USERNAME=demo
      - PASSWORD=demo@2024
      - ROOT_DIR=/webdav/data
    volumes:
      - ./webdav_data:/webdav/data
    restart: unless-stopped

执行docker-compose up -d启动服务，数据将持久化到当前目录的webdav_data文件夹，访问需使用认证信息demo/demo@2024。

服务访问验证

服务启动后，可通过WebDAV客户端或命令行工具（如curl）验证：

bash
# ***访问示例（获取根目录列表）
curl -X PROPFIND http://localhost:8080/ -H "Depth: 1"

# 带认证访问示例
curl -X PROPFIND http://testuser:testpass123@localhost:9000/ -H "Depth: 1"