Að setja upp WebDAV á Debian 10 með WsgiDAV

• Kynning
• Forkröfur
• Uppsetning
• Frekari lestur

Kynning

Web Distributed Authoring and Versioning (WebDAV) er HTTP viðbót sem veitir ramma til að búa til og breyta skrám á netþjóni með fjarstýringu. WsgiDAV er WebDAV þjónn skrifaður í python. Þessi handbók mun hjálpa þér í gegnum uppsetningu WsgiDAV útgáfu 3.0 á Vultr netþjóni sem keyrir Debian 10. Við munum einnig fá SSL vottorð til að veita örugga tengingu sem og PAM auðkenningu.

Forkröfur

• Debian 10 kerfi sem þú hefur forréttindaaðgang að (með rótnotandanum eða hvaða sudo notanda sem er.)
• The $EDITORumhverfisbreytan verður að vera stillt á textaritli að eigin vali.
• Skráð lén er krafist. Nafnaþjónar þess verða að vera stilltir með Askrá sem bendir á IPv4 vistfang netþjónsins þíns og mögulega AAAAskrá sem bendir á IPv6 vistfangið.
• Mælt er með því að þekkja YAML setningafræði.

Staðgjafinn dav.example.comverður notaður fyrir lén netþjónsins þíns.

Uppsetning

SSL vottorð

Við byrjum á því að uppfæra kerfið og fá ókeypis SSL vottorð frá Let's Encrypt . Til að gera það skaltu fyrst uppfæra kerfið þitt og setja upp certbottólið:

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

Í skipuninni hér að neðan skaltu skipta út dav.example.comog email@domain.tldmeð léninu þínu og netfangi áður en þú framkvæmir það:

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

Þjónninn þinn mun fá send áskorun til að staðfesta að þú stjórnar léninu sem tilgreint er. Ef það tekst verður vottorðið gefið út og vistað ásamt öðrum skrám eins og einkalyklinum undir /etc/letsencrypt/live/dav.example.com/.

Setur upp WsgiDAV

Settu fyrst upp python pakkastjórann pip:

sudo apt update sudo apt install -y python3-pip

WsgiDAV krefst HTTP netþjóns sem styður WSGI. Við munum setja upp sjálfgefna valmöguleikann, sem er Cheroot. Við munum einnig setja upp lxml python bókasafnið, sem hefur tilhneigingu til að skila betri árangri en XML bókasafnið sem er sjálfgefið uppsett. PAM (Pluggable Authentication Module) python3 bókasafnið er líka nauðsynlegt. Settu upp nauðsynlega pakka með því að nota piptólið:

sudo pip3 install wsgidav cheroot lxml python-pam

Stillir WsgiDAV

WsgiDAV keyrslan er geymd í /usr/local/bin, þannig að við munum setja stillingarskrána í /usr/local/etcmöppuna. Sæktu sýnishorn af stillingarskrá með eftirfarandi skipunum:

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

Opnaðu það með ritlinum þínum:

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

Finndu eftirfarandi línur í hlutanum „SSL Support“:

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

Skiptu þeim út fyrir eftirfarandi:

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"

Næst munum við stilla deilingarslóðirnar með því að kortleggja HTTP slóðir (eins og /) við samsvarandi staði á skráarkerfinu (svo sem /var/www/dir1). Í sýnikennsluskyni munum við deila tveimur möppum, önnur þeirra verður skrifvarinn. Finndu provider_mappingkubbinn í hlutanum „DEIL“:

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}

Skiptu um það:

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

Með þessum kortlagningum, https://dav.example.com:8080/mun samsvara /var/www/html/documentsmöppunni á þjóninum, en https://dav.example.com:8080/reportsmun korta til /var/www/html/reportsán skrifa aðgangs.

Til auðkenningar munum við nota PAM bílstjórinn. Þetta fjarlægir þörfina fyrir aðskilda WebDAV notendareikninga og gerir kerfisnotendum kleift að skrá sig inn með venjulegum skilríkjum sínum.

Finndu þessar línur í hlutanum „AÐVÖNNUN“:

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

Skiptu þeim út fyrir eftirfarandi:

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

Þú getur nú prófað netþjóninn þinn:

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

Opnaðu https://dav.example.com:8080/í vafranum þínum. Þar sem við stilltum PAM auðkenningu þarftu að skrá þig inn með Linux notandareikningnum þínum. Notaðu CTRL+ Ctil að stöðva þjóninn áður en þú heldur áfram.

Uppsetning sem þjónusta

Til að keyra WebDAV netþjóninn þinn sem kerfisþjónustu sem stjórnað er af systemd, búðu til einingaskrá:

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

Skráðu Eftirfarandi:

[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

Búðu síðan til stillingarskrá fyrir kerfisskráningarþjónustuna:

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

Fylltu skrána með eftirfarandi:

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

Vista og hætta, notaðu síðan skipanirnar hér að neðan til að búa til annálaskrána:

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

Að lokum skaltu hlaða nýju systemd einingaskránni og endurræsa skráningarþjónustuna áður en þú byrjar WsgiDAV:

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

Þú getur nú notað systemctltil að ræsa, stöðva og endurræsa WebDAV netþjóninn þinn. Staðlað úttak og villu WsgiDAV verða skráð á /var/log/wsgidav.log, og einnig er hægt að nálgast þær með sudo journalctl -u wsgidav.service.

Ef þú vilt að WebDAV þjónninn ræsist sjálfkrafa við ræsingu kerfisins skaltu framkvæma:

sudo systemctl enable wsgidav.service

Frekari lestur

• Hvernig á að setja upp WebDAV netþjón með Apache á CentOS 7
• WsgiDAV skjöl