Distribuera WebDAV på Debian 10 med WsgiDAV

• Introduktion
• Förutsättningar
• Installation
• Vidare läsning

Introduktion

Web Distributed Authoring and Versioning (WebDAV) är ett HTTP-tillägg som tillhandahåller ett ramverk för att på distans skapa och modifiera filer på en server. WsgiDAV är en WebDAV-server skriven i python. Den här guiden hjälper dig genom installationen av WsgiDAV version 3.0 på en Vultr-server som kör Debian 10. Vi kommer också att skaffa ett SSL-certifikat för att tillhandahålla en säker anslutning samt PAM-autentisering.

Förutsättningar

• Ett Debian 10-system som du har privilegierad åtkomst till (via root-användaren eller vilken sudo-användare som helst.)
• Den $EDITORMiljövariabeln måste ställas in på en textredigerare som du väljer.
• Ett registrerat domännamn krävs. Dess namnservrar måste konfigureras med en Apost som pekar på din servers IPv4-adress, och eventuellt en AAAApost som pekar på IPv6-adressen.
• Bekantskap med YAML-syntaxen rekommenderas.

Platshållaren dav.example.comkommer att användas för din servers domännamn.

Installation

SSL-certifikat

Vi börjar med att uppdatera systemet och skaffa ett gratis SSL-certifikat från Let's Encrypt . För att göra det, uppdatera först ditt system och installera certbotverktyget:

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

I kommandot nedan, ersätt dav.example.comoch [email protected]med ditt domännamn respektive din e-postadress innan du kör det:

sudo certbot certonly --standalone --agree-tos -m [email protected] -d dav.example.com

Din server kommer att skickas en utmaning för att verifiera att du kontrollerar det angivna domännamnet. Om det lyckas kommer certifikatet att utfärdas och sparas, tillsammans med andra filer som den privata nyckeln, under /etc/letsencrypt/live/dav.example.com/.

Installerar WsgiDAV

Installera först python-pakethanteraren pip:

sudo apt update sudo apt install -y python3-pip

WsgiDAV kräver en HTTP-server som stöder WSGI. Vi kommer att installera standardalternativet, som är Cheroot. Vi kommer också att installera lxml python-biblioteket, som tenderar att fungera bättre än XML-biblioteket som är installerat som standard. PAM (Pluggable Authentication Module) python3-biblioteket behövs också. Installera de nödvändiga paketen med hjälp av pipverktyget:

sudo pip3 install wsgidav cheroot lxml python-pam

Konfigurera WsgiDAV

Den körbara WsgiDAV-filen lagras i /usr/local/bin, så vi kommer att placera konfigurationsfilen i /usr/local/etckatalogen. Ladda ner exempel på konfigurationsfilen med följande kommandon:

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

Öppna den med din editor:

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

Hitta följande rader i avsnittet "SSL Support":

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

Ersätt dem med följande:

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"

Därefter kommer vi att konfigurera delade sökvägarna genom att mappa HTTP-sökvägar (som /) till motsvarande platser i filsystemet (som /var/www/dir1). För demonstrationsändamål kommer vi att dela två kataloger, varav en kommer att vara skrivskyddad. provider_mappingLeta reda på blocket i avsnittet "AKTIER":

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}

Ersätt den:

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

Med dessa mappningar https://dav.example.com:8080/kommer den att motsvara /var/www/html/documentskatalogen på servern, medan den https://dav.example.com:8080/reportskommer att mappas till /var/www/html/reportsutan skrivåtkomst.

För autentisering kommer vi att använda PAM-drivrutinen. Detta tar bort behovet av separata WebDAV-användarkonton och tillåter systemanvändare att logga in med sina vanliga referenser.

I avsnittet AUTENTICERING hittar du dessa rader:

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

Ersätt dem med följande:

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

Du kan nu testa din server:

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

Öppna https://dav.example.com:8080/i din webbläsare. Eftersom vi konfigurerade PAM-autentisering måste du logga in med ditt Linux-användarkonto. Använd CTRL+ för Catt stoppa servern innan du fortsätter.

Installera som en tjänst

För att köra din WebDAV-server som en systemtjänst som hanteras av systemd, skapa en enhetsfil:

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

Skriv följande:

[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

Skapa sedan en konfigurationsfil för systemloggningstjänsten:

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

Fyll filen med följande:

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

Spara och avsluta, använd sedan kommandona nedan för att skapa loggfilen:

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

Slutligen, ladda den nya systemd-enhetsfilen och starta om loggningstjänsten innan du startar WsgiDAV:

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

Du kan nu använda för systemctlatt starta, stoppa och starta om din WebDAV-server. WsgiDAVs standardutgång och fel kommer att loggas till /var/log/wsgidav.logoch kan även nås med sudo journalctl -u wsgidav.service.

Om du vill att WebDAV-servern ska starta automatiskt vid systemets starttid, kör:

sudo systemctl enable wsgidav.service

Vidare läsning

• Hur man ställer in en WebDAV-server med Apache på CentOS 7
• WsgiDAV-dokumentation