server: cheroot

# 配置服务提供程序，默认是 Cheroot （前述通过 pip 进行安装，Windows 的 MSI 安装包中已附带了）
# 其他参数:
#     max: -1
#     numthreads: 10
#     request_queue_size: 5
#     shutdown_timeout: 5
#     timeout: 10

# 基础配置
host: 0.0.0.0  # 监听的 IP
port: 19999  # 监听的端口
block_size: 8192  # 传输块大小
add_header_MS_Author_Via: true  # 为 MS Office 添加的头部数据（默认 true）

# 补丁，请参见官方说明
hotfixes:
    emulate_win32_lastmod: false
    re_encode_path_info: true
    unquote_path_info: false
    treat_root_options_as_asterisk: false

# SSL 支持
ssl_certificate: '/wsgidav.pem'  # SSL 证书
ssl_private_key: '/wsgidav.key'  # SSL 密钥
# ssl_certificate_chain: null  # SSL 公钥链
ssl_adapter: 'builtin'  # SSL 服务插件，可选 builtin 和 pyopenssl ，默认 builtin

# 中间件，参见官方说明
middleware_stack:
    - wsgidav.mw.cors.Cors
    - wsgidav.error_printer.ErrorPrinter
    - wsgidav.http_authenticator.HTTPAuthenticator
    - wsgidav.dir_browser.WsgiDavDirBrowser
    - wsgidav.request_resolver.RequestResolver  # RequestResolver 必须是最后一个中间件

# 文件共享
mount_path: null  # 挂载路径 <mount_path>/<share_name>/<res_path>
provider_mapping:  # 地址转换
    '/': '/'
    '/pub':  # 访问路径
        root: '/path/to/share2'  # 目标路径
        readonly: true  # 只读

# 身份认证
http_authenticator:
    accept_basic: true  # Basic 认证
    accept_digest: true  # Digest 认证
    default_to_digest: true  # 默认认证方式，true 为 Digest，false 为 Basic
    trusted_auth_header: null  # 信任的请求头
    domain_controller: null  # 认证控制模块，与之后的 xx_dc 对应，可选：
		# * wsgidav.dc.simple_dc.SimpleDomainController
		# * wsgidav.dc.pam_dc.PAMDomainController
		# * wsgidav.dc.nt_dc.NTDomainController

simple_dc:
    # DC参数
    user_mapping:
        '*':  # 允许访问的资源
            'username':  # 用户名
                password: 'password'  # 密码
                roles: ['editor']  # 角色
nt_dc:
    preset_domain: null
    preset_server: null
pam_dc:
    service: 'login'
    encoding: 'utf-8'
    resetcreds: true

# CORS 防护，参见官方说明
cors:
    allow_origin: null
    allow_methods:
    allow_headers:
    expose_headers:
    allow_credentials: false
    max_age: 600
    add_always:

# 属性管理器，默认为空，即不使用，配置参见官方说明
property_manager: null
mutable_live_props:
    - '{DAV:}getlastmodified'

# 资源锁管理
lock_storage: true  # 默认 true 使用 wsgidav.lock_man.lock_storage.LockStorageDict，null 为不使用

# 调试信息
verbose: 3  # 调试信息等级
logging:  # 日志信息
    logger_date_format: '%H:%M:%S'
    logger_format: '%(asctime)s.%(msecs)03d - %(levelname)-8s: %(message)s'
    debug_methods: []
    debug_litmus: []

# Wsgi 路径管理模块
dir_browser:
    enable: true  # 允许路径索引
    ignore:  # 忽略路径
        - '.DS_Store'
        - 'Thumbs.db'
        - '._*'
		- 'wsgidav.pem'
		- 'wsgidav.key'
    icon: false  # 显示 WsgiDAV 图标在 Web 页面顶端
    response_trailer: true  # 页脚信息，true 为默认
    show_user: true  # 在 Web 页面上显示用户名
    show_logout: true  # 在 Web 页面上显示 Logout
    davmount: true
    davmount_links: false
    ms_sharepoint_support: true  # MS Office 编辑链接
    libre_office_support: true # Libre Office 编辑链接
    htdocs_path: null