Разгръщане на 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 библиотеката, инсталирана по подразбиране. PAM (Pluggable Authentication Module) библиотеката python3 също е необходима. Инсталирайте необходимите пакети с помощта на 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 Support":

# 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 unit и рестартирайте услугата за регистриране, преди да стартирате 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 документация