mulino/webdav

Apache WebDAV服务器Docker镜像文档

镜像概述与主要用途

本镜像基于Apache HTTP Server构建，提供开箱即用的WebDAV服务器环境。WebDAV（Web-based Distributed Authoring and Versioning）是HTTP协议的扩展，支持文件创建、读取、更新、删除（CRUD）及版本控制等操作。镜像旨在简化WebDAV服务部署流程，通过容器化技术提供跨平台一致的运行环境，适用于个人、团队或企业搭建轻量级文件共享与管理系统。

核心功能与特性

• 标准协议支持：完全兼容WebDAV协议（RFC 4918），支持PUT/GET/DELETE/PROPFIND等标准操作，可与各类WebDAV客户端（如Windows资源管理器、macOS Finder、FileZilla）无缝对接。

• 灵活访问控制：集成Apache认证机制，支持基本认证、摘要认证及IP访问限制，可通过配置文件自定义用户权限、目录访问规则。

• 持久化存储：支持数据卷挂载，确保文件数据在容器重启或重建后不丢失，适配生产环境数据持久化需求。

• 轻量级设计：基于官方Apache镜像优化，镜像体积小巧，启动快速，资源占用低，适合边缘设备及资源受限环境。

• 可扩展性：支持通过环境变量或自定义配置文件扩展功能，如启用SSL/TLS加密、集成日志分析、配置缓存策略等。

使用场景与适用范围

• 个人文件共享：快速搭建个人远程文件存储服务，通过浏览器或文件管理器远程访问、编辑文件。

• 团队协作平台：为小团队提供集中式文件协作空间，支持多人同时编辑、文件版本追踪（需配合版本控制工具）。

• Web应用后端：作为Web应用的文件管理模块，提供HTTP接口供应用上传/下载文件（如CMS系统媒体库、博客附件管理）。

• 开发测试环境：在开发流程中快速部署临时文件服务，模拟生产环境的文件交互场景。

使用方法与配置说明

基本部署（Docker CLI）

通过以下命令启动WebDAV服务器，映射主机端口并挂载数据卷：

bash
docker run -d \
  --name webdav-server \
  -p 8080:80 \  # 主机端口:容器Apache端口
  -v /path/to/local/files:/var/www/webdav \  # 挂载本地目录到容器WebDAV根目录
  -e WEBDAV_USER=admin \  # 访问用户名
  -e WEBDAV_PASSWORD=SecurePass123 \  # 访问密码
  -e WEBDAV_PATH=/files \  # 服务访问路径（如http://localhost:8080/files）
  your-image-name:tag

Docker Compose配置示例

yaml
version: '3'
services:
  webdav:
    image: your-image-name:tag
    container_name: webdav-server
    ports:
      - "8080:80"
      - "443:443"  # 如需启用HTTPS
    volumes:
      - ./webdav-data:/var/www/webdav  # 数据持久化
      - ./ssl:/etc/apache2/ssl  # 挂载SSL证书（可选）
      - ./custom.conf:/etc/apache2/conf-enabled/custom.conf  # 自定义配置（可选）
    environment:
      - WEBDAV_USER=teamuser
      - WEBDAV_PASSWORD_HASH=$apr1$hzE5...  # Apache htpasswd生成的密码哈希（推荐）
      - WEBDAV_ALLOW_OVERWRITE=On  # 允许覆盖文件
      - APACHE_LOG_LEVEL=info  # 日志级别
    restart: unless-stopped

核心配置参数（环境变量）

高级配置：启用SSL/TLS

1. 准备证书：将SSL证书文件（cert.pem）和私钥文件（key.pem）存放于本地目录（如./ssl）。

2. 挂载证书与配置：创建自定义Apache配置文件（custom-ssl.conf）：

   apache
   LoadModule ssl_module modules/mod_ssl.so
   Listen 443
   <VirtualHost *:443>
     SSLEngine on
     SSLCertificateFile /etc/apache2/ssl/cert.pem
     SSLCertificateKeyFile /etc/apache2/ssl/key.pem
     
     Alias ${WEBDAV_PATH} /var/www/webdav
     <Directory /var/www/webdav>
       Dav On
       AuthType Basic
       AuthName "WebDAV Secure Server"
       AuthUserFile /etc/apache2/webdav.htpasswd
       Require valid-user
     </Directory>
   </VirtualHost>
   

3. 启动容器：添加SSL配置挂载：

   bash
   docker run -d ... -v ./ssl:/etc/apache2/ssl -v ./custom-ssl.conf:/etc/apache2/conf-enabled/custom-ssl.conf your-image-name:tag
   

客户端访问示例

• Windows：资源管理器输入 \\server-ip:8080\webdav，输入用户名密码连接。

• macOS：Finder中「前往 > 连接服务器」，输入 http://server-ip:8080/webdav。

• 命令行：使用curl或cadaver工具：

  bash
  # 上传文件
  curl -u admin:SecurePass123 -T localfile.txt http://server-ip:8080/files/remotefile.txt
  # 下载文件
  curl -u admin:SecurePass123 -O http://server-ip:8080/files/remotefile.txt
  

注意事项

• 安全加固：生产环境必须启用SSL/TLS，避免明文传输；使用强密码并定期更新；通过配置限制访问IP。

• 数据备份：定期备份挂载的数据卷目录，防止数据丢失。

• 性能调优：高并发场景可调整Apache配置（如MaxClients、KeepAlive参数）或使用负载均衡。

• 版本控制：建议使用指定镜像标签（如:2.4）而非:latest，确保部署一致性。