WebDAV diegimas Debian 10 naudojant WsgiDAV

• Įvadas
• Būtinos sąlygos
• Montavimas
• Papildoma literatūra

Įvadas

Žiniatinklio paskirstytas kūrimas ir versijų kūrimas (WebDAV) yra HTTP plėtinys, suteikiantis pagrindą nuotoliniu būdu kurti ir keisti failus serveryje. WsgiDAV yra WebDAV serveris, parašytas python. Šis vadovas padės įdiegti WsgiDAV 3.0 versiją Vultr serveryje, kuriame veikia Debian 10. Taip pat gausime SSL sertifikatą, užtikrinantį saugų ryšį ir PAM autentifikavimą.

Būtinos sąlygos

• Debian 10 sistema, prie kurios turite privilegijuotą prieigą (per root arba bet kurį sudo vartotoją).
• $EDITORAplinkos kintamąjį turi būti nustatytas į teksto redaktoriumi savo pasirinkimą.
• Reikalingas registruotas domeno vardas. Jo vardų serveriuose turi būti sukonfigūruotas Aįrašas, nurodantis jūsų serverio IPv4 adresą, ir pasirinktinai AAAAįrašas, nukreipiantis į IPv6 adresą.
• Rekomenduojama susipažinti su YAML sintaksė.

Rezervuota vieta dav.example.combus naudojama jūsų serverio domeno pavadinimui.

Montavimas

SSL sertifikatas

Pradėsime nuo sistemos atnaujinimo ir nemokamo SSL sertifikato iš Let's Encrypt gavimo . Norėdami tai padaryti, pirmiausia atnaujinkite sistemą ir įdiekite certbotprogramą:

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

Žemiau esančioje komandoje pakeiskite dav.example.comir email@domain.tldatitinkamai savo domeno pavadinimu ir el. pašto adresu prieš ją vykdydami:

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

Jūsų serveriui bus išsiųstas iššūkis patvirtinti, kad valdote nurodytą domeno pavadinimą. Jei tai pavyks, sertifikatas bus išduotas ir išsaugotas kartu su kitais failais, pvz., privačiuoju raktu, skiltyje /etc/letsencrypt/live/dav.example.com/.

WsgiDAV diegimas

Pirmiausia įdiekite python paketų tvarkyklę pip:

sudo apt update sudo apt install -y python3-pip

WsgiDAV reikalingas HTTP serveris, palaikantis WSGI. Įdiegsime numatytąją parinktį, kuri yra „Cheroot“. Taip pat įdiegsime lxml python biblioteką, kuri paprastai veikia geriau nei XML biblioteka, įdiegta pagal numatytuosius nustatymus. Taip pat reikalinga PAM (Pluggable Authentication Module) python3 biblioteka. Įdiekite reikiamus paketus naudodami pipįrankį:

sudo pip3 install wsgidav cheroot lxml python-pam

WsgiDAV konfigūravimas

WsgiDAV vykdomasis failas yra saugomas /usr/local/bin, todėl konfigūracijos failą įdėsime į /usr/local/etckatalogą. Atsisiųskite konfigūracijos failo pavyzdį naudodami šias komandas:

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

Atidarykite jį naudodami redaktorių:

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

Skiltyje „SSL palaikymas“ raskite šias eilutes:

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

Pakeiskite juos šiais:

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"

Tada sukonfigūruosime bendrinimo kelius susiedami HTTP kelius (pvz., /) su atitinkamomis failų sistemos vietomis (pvz., /var/www/dir1). Demonstraciniais tikslais pasidalinsime dviem katalogais, iš kurių vienas bus tik skaitomas. Raskite provider_mappingbloką skiltyje „DALINOS“:

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}

Pakeisti tai:

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

Su šiais atvaizdais https://dav.example.com:8080/atitiks /var/www/html/documentsserverio katalogą, o https://dav.example.com:8080/reportsbus susietas /var/www/html/reportssu be rašymo prieigos.

Autentifikavimui naudosime PAM tvarkyklę. Tai pašalina atskirų WebDAV vartotojo abonementų poreikį ir leidžia sistemos naudotojams prisijungti naudojant įprastus kredencialus.

Skiltyje „ATUTITIKTAVIMAS“ raskite šias eilutes:

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

Pakeiskite juos šiais:

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

Dabar galite išbandyti savo serverį:

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

Atidarykite https://dav.example.com:8080/savo žiniatinklio naršyklėje. Kadangi sukonfigūravome PAM autentifikavimą, turėsite prisijungti naudodami savo Linux vartotojo abonementą. Norėdami sustabdyti serverį prieš tęsdami, naudokite CTRL+ C.

Diegimas kaip paslauga

Norėdami paleisti WebDAV serverį kaip sistemos paslaugą, kurią valdo systemd, sukurkite vieneto failą:

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

Įveskite:

[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

Tada sukurkite sistemos registravimo paslaugos konfigūracijos failą:

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

Užpildykite failą taip:

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

Išsaugokite ir išeikite, tada naudokite toliau pateiktas komandas, kad sukurtumėte žurnalo failą:

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

Galiausiai, prieš paleisdami WsgiDAV, įkelkite naują sistemos vieneto failą ir iš naujo paleiskite registravimo paslaugą:

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

Dabar galite naudoti systemctlnorėdami paleisti, sustabdyti ir iš naujo paleisti savo WebDAV serverį. Standartinė WsgiDAV išvestis ir klaida bus užregistruota /var/log/wsgidav.logir taip pat gali būti pasiekiama naudojant sudo journalctl -u wsgidav.service.

Jei norite, kad WebDAV serveris paleistų automatiškai sistemos įkrovos metu, vykdykite:

sudo systemctl enable wsgidav.service

Papildoma literatūra

• Kaip nustatyti WebDAV serverį naudojant „Apache“ „CentOS 7“.
• WsgiDAV dokumentacija