Розгортання WebDAV на Debian 10 за допомогою WsgiDAV

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

Вступ

Веб-розподілена розробка та керування версіями (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»:

# 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