gigantuar/webdav

镜像概述

本镜像基于官方httpd镜像构建，提供易于配置的WebDAV服务器，支持多种认证方式、SSL加密及多用户管理，适用于个人或团队的文件存储与共享场景。

核心功能

1. 支持Basic（HTTPS推荐）和Digest（HTTP推荐）两种认证方式
2. 单用户（通过环境变量配置）或多用户（通过绑定认证文件）登录管理
3. 自签名SSL证书生成或自定义证书绑定
4. ***访问配置（指定允许的HTTP方法或完全开放）
5. 可配置服务器域名、WebDAV路径及认证领域

使用场景

• 个人文件云存储与跨设备同步
• 团队内部文件协作与共享
• 小型项目的文件分发服务

配置说明

环境变量

所有环境变量均为可选，建议至少配置USERNAME和PASSWORD（或绑定自定义认证文件）：

• SERVER_NAMES：逗号分隔的域名列表（如example.com,www.example.com），默认localhost
• LOCATION：WebDAV的URL路径（如/webdav），默认/
• AUTH_TYPE：认证类型（Basic/Digest），默认Basic
• REALM：认证领域名称，默认WebDAV
• USERNAME：单用户登录用户名（绑定自定义文件时忽略）
• PASSWORD：单用户登录密码（绑定自定义文件时忽略）
• ANONYMOUS_METHODS：允许访问的HTTP方法（如GET,OPTIONS），默认禁止
• SSL_CERT：设置为selfsigned生成自签名证书，启用SSL

多用户认证文件生成

Basic认证

bash
touch user.passwd
htpasswd -B user.passwd alice
htpasswd -B user.passwd bob

Digest认证（默认领域为WebDAV）

bash
touch user.passwd
htdigest user.passwd WebDAV alice
htdigest user.passwd WebDAV bob

部署示例

基础WebDAV服务（HTTP+Digest认证）

bash
docker run --restart always -v /srv/dav:/var/lib/dav \
    -e AUTH_TYPE=Digest -e USERNAME=alice -e PASSWORD=secret1234 \
    --publish 80:80 -d gigantuar/webdav

Docker Compose配置

yaml
version: '3'
services:
  webdav:
    image: gigantuar/webdav
    restart: always
    ports:
      - "80:80"
    environment:
      AUTH_TYPE: Digest
      USERNAME: alice
      PASSWORD: secret1234
    volumes:
      - /srv/dav:/var/lib/dav

带自签名SSL的WebDAV服务

bash
docker run --restart always -v /srv/dav:/var/lib/dav \
    -e AUTH_TYPE=Basic -e USERNAME=test -e PASSWORD=test \
    -e SSL_CERT=selfsigned --publish 443:443 -d gigantuar/webdav

绑定自定义SSL证书

bash
docker run --restart always -v /srv/dav:/var/lib/dav \
    -v /path/to/cert.pem:/cert.pem -v /path/to/privkey.pem:/privkey.pem \
    -e AUTH_TYPE=Basic -e USERNAME=test -e PASSWORD=test \
    --publish 443:443 -d gigantuar/webdav

多用户认证部署

bash
docker run --restart always -v /srv/dav:/var/lib/dav \
    -v /path/to/user.passwd:/user.passwd \
    --publish 80:80 -d gigantuar/webdav