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

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
# 服务器地址和端口配置
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