Развертывание WebDAV в Debian 10 с использованием WsgiDAV

• Вступление
• Предпосылки
• Установка
• дальнейшее чтение

Вступление

Web Distributed Authoring and Versioning (WebDAV) - это расширение HTTP, которое обеспечивает основу для удаленного создания и изменения файлов на сервере. WsgiDAV - это сервер WebDAV, написанный на python. Это руководство поможет вам в установке WsgiDAV версии 3.0 на сервере Vultr под управлением Debian 10. Мы также получим SSL-сертификат для обеспечения безопасного соединения и аутентификации PAM.

Предпосылки

• Система Debian 10, к которой у вас есть привилегированный доступ (через пользователя root или любого пользователя sudo.)
• $EDITORПеременная среды должны быть установлены в текстовом редакторе по вашему выбору.
• Требуется зарегистрированное доменное имя. Его серверы имен должны быть настроены с Aзаписью, указывающей на адрес IPv4 вашего сервера, и, необязательно, с AAAAзаписью, указывающей на адрес IPv6.
• Рекомендуется знакомство с синтаксисом YAML.

Заполнитель dav.example.comбудет использоваться для доменного имени вашего сервера.

Установка

SSL сертификат

Мы начнем с обновления системы и получения бесплатного SSL-сертификата от Let's Encrypt . Для этого сначала обновите систему и установите certbotутилиту:

 sudo apt update
 sudo apt upgrade -y
 sudo apt install -y certbot

В приведенной ниже команде замените dav.example.comи email@domain.tldна свое доменное имя и адрес электронной почты соответственно перед выполнением:

sudo certbot certonly --standalone --agree-tos -m email@domain.tld -d dav.example.com

На ваш сервер будет отправлен запрос на проверку того, что вы контролируете указанное доменное имя. В случае успеха сертификат будет выпущен и сохранен вместе с другими файлами, такими как закрытый ключ, в разделе /etc/letsencrypt/live/dav.example.com/.

Установка WsgiDAV

Сначала установите менеджер пакетов python pip:

sudo apt update
sudo apt install -y python3-pip

WsgiDAV требует HTTP-сервер, который поддерживает WSGI. Мы установим опцию по умолчанию, которая называется Cheroot. Мы также установим библиотеку lxml python, которая работает лучше, чем библиотека XML, установленная по умолчанию. Также необходима библиотека python3 PAM (Pluggable Authentication Module). Установите необходимые пакеты с помощью pipинструмента:

sudo pip3 install wsgidav cheroot lxml python-pam

Настройка WsgiDAV

Исполняемый файл WsgiDAV хранится в файле /usr/local/bin, поэтому мы поместим файл конфигурации в /usr/local/etcкаталог. Загрузите образец файла конфигурации с помощью следующих команд:

sudo mkdir -p /usr/local/etc
sudo wget https://github.com/mar10/wsgidav/raw/master/sample_wsgidav.yaml -O /usr/local/etc/wsgidav.yaml

Откройте его в вашем редакторе:

sudo $EDITOR /usr/local/etc/wsgidav.yaml

Найдите следующие строки в разделе «Поддержка SSL»:

# ssl_certificate: "wsgidav/server/sample_bogo_server.crt"
# ssl_private_key: "wsgidav/server/sample_bogo_server.key"
# ssl_certificate_chain: null

Замените их следующим:

ssl_certificate: "/etc/letsencrypt/live/dav.example.com/cert.pem"
ssl_private_key: "/etc/letsencrypt/live/dav.example.com/privkey.pem"
ssl_certificate_chain: "/etc/letsencrypt/live/dav.example.com/chain.pem"

Далее мы настроим пути общего доступа, сопоставив пути HTTP (например, /) с соответствующими местоположениями в файловой системе (например, /var/www/dir1). В демонстрационных целях мы поделимся двумя каталогами, один из которых будет доступен только для чтения. Найдите provider_mappingблок в разделе «АКЦИИ»:

provider_mapping:
    "/": "/path/to/share1"
    "/pub":
        root: "/path/to/share2"
        readonly: true
    "/share3":
        provider: path.to.CustomDAVProviderClass
        args: ["/path/to/share3", "second_arg"]
        kwargs: {"another_arg": 42}

Замени это:

provider_mapping:
    "/":
    root: "/var/www/html/documents"
    readonly: false
"/reports":
    root: "/var/www/html/reports"
    readonly: true

С этими сопоставлениями https://dav.example.com:8080/будет соответствовать /var/www/html/documentsкаталог на сервере, в то время как https://dav.example.com:8080/reportsбудет сопоставлен /var/www/html/reportsбез доступа для записи.

Для аутентификации мы будем использовать драйвер PAM. Это устраняет необходимость в отдельных учетных записях WebDAV и позволяет системным пользователям входить в систему, используя свои обычные учетные данные.

В разделе «АУТЕНТИФИКАЦИЯ» найдите следующие строки:

accept_basic: true
accept_digest: true
default_to_digest: true
domain_controller: null

Замените их следующим:

accept_basic: true
accept_digest: false
default_to_digest: false
domain_controller: wsgidav.dc.pam_dc.PAMDomainController

Теперь вы можете проверить свой сервер:

sudo wsgidav -c /usr/local/etc/wsgidav.yaml

Откройте https://dav.example.com:8080/в своем веб-браузере. Поскольку мы настроили PAM-аутентификацию, вам нужно будет войти под своей учетной записью Linux. Используйте CTRL+, Cчтобы остановить сервер, прежде чем продолжить.

Установка в качестве службы

Чтобы запустить сервер WebDAV в качестве системной службы, управляемой systemd, создайте файл модуля:

sudo $EDITOR /etc/systemd/system/wsgidav.service

Введите следующее:

[Unit]
Description=WsgiDAV WebDAV server
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/wsgidav -c /usr/local/etc/wsgidav.yaml
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=wsgidav_service

[Install]
WantedBy=multi-user.target

Затем создайте файл конфигурации для службы регистрации системы:

sudo $EDITOR /etc/rsyslog.d/wsgidav_service.conf

Заполните файл следующим:

 if $programname == 'wsgidav_service' then /var/log/wsgidav.log
 & stop

Сохраните и выйдите, затем используйте команды ниже, чтобы создать файл журнала:

sudo touch /var/log/wsgidav.log
sudo chown root:adm /var/log/wsgidav.log

Наконец, загрузите новый файл модуля systemd и перезапустите службу журналов перед запуском WsgiDAV:

sudo systemctl daemon-reload
sudo systemctl restart rsyslog.service
sudo systemctl start wsgidav.service

Теперь вы можете использовать systemctlдля запуска, остановки и перезапуска вашего сервера WebDAV. Стандартные выходные данные и ошибки WsgiDAV будут регистрироваться /var/log/wsgidav.log, а также могут быть доступны с помощью sudo journalctl -u wsgidav.service.

Если вы хотите, чтобы сервер WebDAV запускался автоматически во время загрузки системы, выполните:

 sudo systemctl enable wsgidav.service

дальнейшее чтение

• Как настроить сервер WebDAV с помощью Apache на CentOS 7
• WsgiDAV Документация