WebDAV 服务器搭建教程：使用 Docker 快速部署文件共享服务#

前言#

WebDAV (Web Distributed Authoring and Versioning) 是 HTTP 协议的扩展，允许客户端对 Web 服务器上的内容进行在线编辑和管理。本教程将介绍如何使用 Docker 快速搭建一个安全的 WebDAV 服务器。

项目地址#

hacdias

webdav

A simple and standalone WebDAV server.

—

MIT

环境要求#

Docker 环境
一台 Linux/Windows/MacOS 服务器或个人电脑

步骤一：创建配置文件#

首先创建一个工作目录并进入：

1
mkdir webdav
2
cd webdav

创建配置文件 config.yml：

1
# 服务器地址和端口配置
2
address: 0.0.0.0
3
port: 6065
4

5
# 基础配置
6
tls: false
7
prefix: /
8
debug: false
9
noSniff: false
10
behindProxy: false
11
directory: .
12

13
# 权限配置（完整读写权限）
14
permissions: CRUD
15

16
# CORS配置（允许网页访问）
17
cors:
18
  enabled: true
19
  credentials: true
20
  allowed_headers:
21
    - Depth
22
    - Authorization
23
    - Content-Type
24
    - Content-Length
25
  allowed_hosts:
26
    - "*"
27
  allowed_methods:
28
    - GET
29
    - PUT
30
    - POST
31
    - DELETE
32
    - PROPFIND
33
    - MKCOL
34
    - COPY
35
    - MOVE
36
  exposed_headers:
37
    - Content-Length
38
    - Content-Range
39

40
# 用户认证配置
41
users:
42
  - username: 你的用户名
43
    password: 你的密码

步骤二：创建数据目录#

1
mkdir data

步骤三：启动 Docker 容器#

1
docker run \
2
  -p 6065:6065 \
3
  -v $(pwd)/config.yml:/config.yml:ro \
4
  -v $(pwd)/data:/data \
5
  ghcr.io/hacdias/webdav -c /config.yml

配置说明#

1. 端口配置#

address: 0.0.0.0 允许所有网络接口访问
port: 6065 服务监听端口

2. 权限设置#

权限类型包括：

C：Create（创建）
R：Read（读取）
U：Update（更新）
D：Delete（删除）

3. CORS 配置#

enabled: true 启用跨域访问
allowed_hosts: "*" 允许所有域名访问
allowed_methods 配置允许的 HTTP 方法

4. 安全性考虑#

建议修改默认用户名和密码
如果不需要网页访问，可以禁用 CORS
生产环境建议启用 TLS 加密

进阶配置#

反向代理配置#

如果你使用 Nginx 作为反向代理，需要正确转发头信息以避免 502 错误：

1
location / {
2
  proxy_pass http://127.0.0.1:6065;
3
  proxy_set_header X-Real-IP $remote_addr;
4
  proxy_set_header REMOTE-HOST $remote_addr;
5
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
6
  proxy_set_header Host $host;
7
  proxy_redirect off;
8
}

访问方式#

1. 网页访问#

1
http://服务器IP:6065

2. WebDAV 客户端#

MacOS: Cyberduck

常见问题#

1. 403 权限错误#

检查：

permissions 是否配置为 CRUD
用户权限是否正确
目录权限是否正确

2. CORS 错误#

检查：

allowed_hosts 配置
allowed_methods 是否包含需要的方法
allowed_headers 是否完整

总结#

通过 Docker 部署 WebDAV 服务器具有以下优势：

部署简单快速
配置灵活
易于维护
支持多平台

附录：官方配置文件示例#

1
# 服务器地址和端口配置
2
address: 0.0.0.0
3
port: 6065
4

5
# TLS 相关设置（如果你想直接启用 TLS）
6
tls: false
7
cert: cert.pem
8
key: key.pem
9

10
# WebDAV 路径的前缀。默认为 '/'
11
prefix: /
12

13
# 启用或禁用调试日志。默认为 'false'
14
debug: false
15

16
# 禁用文件内容类型嗅探。默认为 'false'
17
noSniff: false
18

19
# 服务器是否运行在受信任的代理后面。当设置为 true 时，
20
# 将使用 X-Forwarded-For 头部来记录访问尝试的远程地址（如果可用）
21
behindProxy: false
22

23
# 用户连接时可以访问的目录。
24
# 除非用户有自己的 'directory' 定义，否则将使用此目录。
25
# 默认为 '.'（当前目录）
26
directory: .
27

28
# 用户的默认权限。这是一个不区分大小写的选项。可能的权限包括：
29
# C（创建）、R（读取）、U（更新）、D（删除）。
30
# 你可以组合多个权限。例如，要允许读取和创建，设置为 "RC"。默认为 "R"
31
permissions: R
32

33
# 用户的默认权限规则。默认为空。规则从后向前应用，
34
# 即从末尾开始匹配请求的第一条规则将被应用
35
rules: []
36

37
# 重新定义用户规则的行为。可以是：
38
# - overwrite: 当用户有规则定义时，这些规则将覆盖任何已定义的全局规则。
39
#   即全局规则不适用于该用户。
40
# - append: 当用户有规则定义时，这些规则将附加到已定义的全局规则之后。
41
#   即对于该用户，首先检查其特定规则，然后是全局规则。
42
# 默认为 'overwrite'
43
rulesBehavior: overwrite
44

45
# 日志配置
46
log:
47
  # 日志格式（'console' 或 'json'）。默认为 'console'
48
  format: console
49
  # 启用或禁用颜色。默认为 'true'。仅在 format 为 'console' 时适用
50
  colors: true
51
  # 日志输出。可以有多个输出。默认仅为 'stderr'
52
  outputs:
53
    - stderr
54

55
# CORS 配置
56
cors:
57
  # 是否应用 CORS 配置。默认为 'false'
58
  enabled: true
59
  credentials: true
60
  allowed_headers:
61
    - Depth
62
  allowed_hosts:
63
    - http://localhost:8080
64
  allowed_methods:
65
    - GET
66
  exposed_headers:
67
    - Content-Length
68
    - Content-Range
69

70
# 用户列表。如果列表为空，则不会有身份验证。
71
# 否则，将自动配置基本身份验证。
72
#
73
# 如果你将身份验证委托给其他服务，你可以使用基本身份验证代理用户名，
74
# 然后使用以下选项禁用 webdav 的密码检查：
75
#
76
# noPassword: true
77
users:
78
  # 示例 'admin' 用户，使用明文密码
79
  - username: admin
80
    password: admin
81
  # 示例 'john' 用户，使用 bcrypt 加密密码，具有自定义目录。
82
  # 你可以使用 'webdav bcrypt' 命令行工具生成 bcrypt 加密密码
83
  - username: john
84
    password: "{bcrypt}$2y$10$zEP6oofmXFeHaeMfBNLnP.DO8m.H.Mwhd24/TOX2MWLxAExXi4qgi"
85
    directory: /another/path
86
  # 示例用户，其详细信息将从环境变量中获取
87
  - username: "{env}ENV_USERNAME"
88
    password: "{env}ENV_PASSWORD"
89
  - username: basic
90
    password: basic
91
    # 覆盖默认权限
92
    permissions: CRUD
93
    rules:
94
      # 通过此规则，用户不能访问 /some/files
95
      - path: /some/file
96
        permissions: none
97
      # 通过此规则，用户可以在 /public/access 中创建、读取、更新和删除
98
      - path: /public/access/
99
        permissions: CRUD
100
      # 通过此规则，用户可以读取和更新所有以 .js 结尾的文件。使用正则表达式
101
      - regex: "^.+.js$"
102
        permissions: RU

使用docker在Linux上搭建Webdav服务端