WebDAV juurutamine Debian 10-s WsgiDAV-i abil

• Sissejuhatus
• Eeltingimused
• Paigaldamine
• Lisalugemist

Sissejuhatus

Web Distributed Authoring and Versioning (WebDAV) on HTTP laiendus, mis pakub raamistikku serveris failide kaugloomiseks ja muutmiseks. WsgiDAV on pythonis kirjutatud WebDAV-server. See juhend aitab teil installida WsgiDAV-i versiooni 3.0 Vultr-serverisse, kus töötab Debian 10. Samuti hangime SSL-sertifikaadi, mis tagab turvalise ühenduse ja PAM-i autentimise.

Eeltingimused

• Debian 10 süsteem, millele teil on privilegeeritud juurdepääs (juurkasutaja või mis tahes sudo kasutaja kaudu).
• $EDITORKeskkonnamuutuja tuleb seada tekstiredaktor oma valik.
• Vaja on registreeritud domeeninime. Selle nimeserverid peavad olema konfigureeritud Akirjega, mis osutab teie serveri IPv4-aadressile, ja soovi korral AAAAkirjega, mis osutab IPv6-aadressile.
• Soovitatav on YAML-i süntaksi tundmine.

Kohatäidet dav.example.comkasutatakse teie serveri domeeninime jaoks.

Paigaldamine

SSL-sertifikaat

Alustuseks uuendame süsteemi ja hankime Let's Encryptilt tasuta SSL-sertifikaadi . Selleks värskendage esmalt oma süsteemi ja installige certbotutiliit:

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

Enne selle täitmist asendage allolevas käsus dav.example.comja email@domain.tldvastavalt oma domeeninime ja e-posti aadressiga:

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

Teie serverile saadetakse väljakutse, et kontrollida, kas te kontrollite määratud domeeninime. Kui see õnnestub, väljastatakse ja salvestatakse sertifikaat koos muude failidega, nagu privaatvõti, alla /etc/letsencrypt/live/dav.example.com/.

WsgiDAV installimine

Esmalt installige pythoni paketihaldur pip:

sudo apt update sudo apt install -y python3-pip

WsgiDAV nõuab HTTP-serverit, mis toetab WSGI-d. Installime vaikevaliku, milleks on Cheroot. Installime ka lxml pythoni teegi, mis tavaliselt töötab paremini kui vaikimisi installitud XML-teek. Vaja on ka PAM-i (Pluggable Authentication Module) python3 teeki. Installige vajalikud paketid piptööriista abil:

sudo pip3 install wsgidav cheroot lxml python-pam

WsgiDAV-i seadistamine

WsgiDAV-i käivitatav fail on salvestatud kataloogi /usr/local/bin, seega paigutame konfiguratsioonifaili /usr/local/etckataloogi. Laadige alla konfiguratsioonifaili näidis järgmiste käskudega:

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

Avage see oma redaktoriga:

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

Otsige jaotisest "SSL-i tugi" üles järgmised read:

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

Asendage need järgmistega:

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"

Järgmisena konfigureerime jagamisteed, vastendades HTTP-teed (nt /) failisüsteemi vastavatesse asukohtadesse (nt /var/www/dir1). Demonstratsiooni eesmärgil jagame kahte kataloogi, millest üks on kirjutuskaitstud. Leidke provider_mappingblokk jaotisest "JAGAMISED":

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}

Asenda see:

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

Nende kaardistamisel, https://dav.example.com:8080/mis vastavad /var/www/html/documentskataloog serveris, samas https://dav.example.com:8080/reportskaardistatakse, et /var/www/html/reportsilma kirjutamise õigus.

Autentimiseks kasutame PAM-draiverit. See eemaldab vajaduse eraldi WebDAV-i kasutajakontode järele ja võimaldab süsteemikasutajatel sisse logida oma tavalisi mandaate kasutades.

Leidke jaotisest „AUTENTIMINE” järgmised read:

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

Asendage need järgmistega:

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

Nüüd saate oma serverit testida:

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

Avage https://dav.example.com:8080/oma veebibrauseris. Kuna me konfigureerisime PAM-i autentimise, peate oma Linuxi kasutajakontoga sisse logima. Kasutage serveri peatamiseks enne jätkamist CTRL+ C.

Paigaldamine teenusena

WebDAV-serveri käitamiseks süsteemiteenusena, mida haldab systemd, looge üksusfail:

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

Sisestage järgmised:

[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

Seejärel looge süsteemi logimisteenuse konfiguratsioonifail:

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

Täitke fail järgmisega:

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

Salvestage ja väljuge, seejärel kasutage logifaili loomiseks allolevaid käske:

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

Lõpuks laadige uus systemd-üksuse fail ja taaskäivitage logimisteenus enne WsgiDAV-i käivitamist:

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

Nüüd saate kasutada systemctloma WebDAV-serveri käivitamiseks, peatamiseks ja taaskäivitamiseks. WsgiDAV-i standardväljund ja tõrketeave logitakse sisse /var/log/wsgidav.logja sellele pääseb juurde ka kasutades sudo journalctl -u wsgidav.service.

Kui soovite, et WebDAV-server käivituks automaatselt süsteemi alglaadimise ajal, käivitage:

sudo systemctl enable wsgidav.service

Lisalugemist

• WebDAV-serveri seadistamine Apache'i abil CentOS 7-s
• WsgiDAV-i dokumentatsioon