ugeek/webdav

ugeek/webdav 镜像文档

镜像概述

ugeek/webdav是一个基于Debian 11.5-slim和Alpine Linux构建的WebDAV服务器镜像，集成nginx/1.19.7作为Web服务器。该镜像支持多架构部署（ARM、amd64、i386），提供简单易用的文件共享服务，适用于个人或小型团队的文件访问与同步需求。

核心功能与特性

• 多架构支持：提供ARM（适用于树莓派）、amd64、i386架构版本，满足不同硬件环境需求
• 灵活配置：通过环境变量自定义用户名、密码、时区、用户ID（UID）和组ID（GID）
• 持久化存储：支持本地目录挂载，确保文件数据持久化
• 反向代理集成：可与Traefik等反向代理工具配合使用，实现域名访问和安全配置
• 多用户支持：通过挂载htpasswd文件实现多用户认证
• 轻量级选项：提供Alpine Linux版本，镜像体积更小，资源占用更低

使用场景

• 个人文件共享与跨设备访问
• 家庭网络文件服务
• 开发环境中的文件同步
• 小型团队的简易文件协作平台

使用方法

环境变量说明

快速部署（Docker Run）

基础版本

Raspberry Pi/ARM架构

bash
docker run --name webdav \
  --restart=unless-stopped \
  -p 80:80 \
  -v $HOME/docker/webdav:/media \
  -e USERNAME=webdav \
  -e PASSWORD=webdav \
  -e TZ=Europe/Madrid \
  -e UID=1000 \
  -e GID=1000 \
  -d docker.xuanyuan.run/ugeek/webdav:arm

amd64架构

bash
docker run --name webdav \
  --restart=unless-stopped \
  -p 80:80 \
  -v $HOME/docker/webdav:/media \
  -e USERNAME=webdav \
  -e PASSWORD=webdav \
  -e TZ=Europe/Madrid \
  -e UID=1000 \
  -e GID=1000 \
  -d docker.xuanyuan.run/ugeek/webdav:amd64

i386架构

bash
docker run --name webdav \
  --restart=unless-stopped \
  -p 80:80 \
  -v $HOME/docker/webdav:/media \
  -e USERNAME=webdav \
  -e PASSWORD=webdav \
  -e TZ=Europe/Madrid \
  -e UID=1000 \
  -e GID=1000 \
  -d docker.xuanyuan.run/ugeek/webdav:i386

Alpine Linux版本（轻量级）

amd64架构

bash
docker run -d \
  --name=webdav \
  -v $HOME/Download:/data/download \
  -v /media:/data/media \
  -e USERNAME=webdav \
  -e PASSWORD=webdav \
  -p 80:80 \
  --restart=unless-stopped \
  docker.xuanyuan.run/ugeek/webdav:amd64-alpine

Raspberry Pi/ARM架构

bash
docker run -d \
  --name=webdav \
  -v $HOME/Download:/data/download \
  -v /media:/data/media \
  -e USERNAME=webdav \
  -e PASSWORD=webdav \
  -p 80:80 \
  --restart=unless-stopped \
  docker.xuanyuan.run/ugeek/webdav:arm-alpine

i386架构

bash
docker run -d \
  --name=webdav \
  -v $HOME/Download:/data/download \
  -v /media:/data/media \
  -e USERNAME=webdav \
  -e PASSWORD=webdav \
  -p 80:80 \
  --restart=unless-stopped \
  docker.xuanyuan.run/ugeek/webdav:i386-alpine

Docker Compose配置

基础配置

yaml
version: "2"
services:
  webdav:
    container_name: webdav
    image: docker.xuanyuan.run/ugeek/webdav:arm  # 根据架构选择arm/amd64/i386
    ports:
      - 80:80
    volumes:
      - $HOME/docker/webdav:/media
    environment:
      - USERNAME=webdav
      - PASSWORD=webdav
      - UID=1000
      - GID=1000
      - TZ=Europe/Madrid
    restart: unless-stopped

带Traefik反向代理配置

yaml
version: '2'
services:
  webdav:
    container_name: webdav
    image: docker.xuanyuan.run/ugeek/webdav:arm  # 根据架构选择
    ports:
      - 80:80
    volumes:
      - $HOME/docker/webdav:/media
    environment:
      - USERNAME=webdav
      - PASSWORD=webdav
      - UID=1000
      - GID=1000
      - TZ=Europe/Madrid
    networks:
      - web
    labels:
      - traefik.backend=webdav
      - traefik.frontend.rule=Host:webdav.your_domain.duckdns.org
      - traefik.docker.network=web
      - traefik.port=80
      - traefik.enable=true
      # 安全头配置
      - traefik.http.middlewares.securedheaders.headers.forcestsheader=true
      - traefik.http.middlewares.securedheaders.headers.sslRedirect=true
      - traefik.http.middlewares.securedheaders.headers.STSPreload=true
      - traefik.http.middlewares.securedheaders.headers.ContentTypeNosniff=true
      - traefik.http.middlewares.securedheaders.headers.BrowserXssFilter=true
      - traefik.http.middlewares.securedheaders.headers.STSIncludeSubdomains=true
      - traefik.http.middlewares.securedheaders.headers.stsSeconds=63072000
      - traefik.http.middlewares.securedheaders.headers.frameDeny=true
      - traefik.http.middlewares.securedheaders.headers.browserXssFilter=true
      - traefik.http.middlewares.securedheaders.headers.contentTypeNosniff=true
networks:
  web:
    external: true

启动命令：

bash
docker-compose up -d

多用户配置

通过挂载htpasswd文件实现多用户认证：

bash
docker run -d \
  --name=webdav \
  -v $HOME/Download:/data/download \
  -v /media:/data/media \
  -v $HOME/docker/webdav/htpasswd:/opt/nginx/conf/htpasswd:ro \
  -p 8001:80 \
  --restart=unless-stopped \
  docker.xuanyuan.run/ugeek/webdav:amd64-alpine

新增用户

使用htpasswd命令添加用户（需先安装apache2-utils）：

bash
htpasswd -nb 用户名 密码 >> $HOME/docker/webdav/htpasswd

日志与维护

查看访问日志

bash
docker exec -it webdav cat /var/log/nginx/webdav_access.log

实时查看访问日志

bash
docker exec -it webdav tail -f /var/log/nginx/webdav_access.log

查看错误日志

bash
docker exec -it webdav cat /var/log/nginx/webdav_error.log

进入容器

bash
docker exec -it webdav bash

参考链接

• WebDAV官方网站
• https://ugeek.github.io

最后更新: 2020年12月12日

Fork来源:

• https://github.com/duxlong/webdav
• https://github.com/docker-projects/docker-webdav-alpine