استقرار WebDAV در Debian 10 با استفاده از WsgiDAV

• معرفی
• پیش نیازها
• نصب و راه اندازی
• بیشتر خواندن

معرفی

نوشتن وب توزیع و انتشار (WebDAV) یک پسوند HTTP است که چارچوبی را برای ایجاد و تغییر پرونده های از راه دور در سرور فراهم می کند. WsgiDAV یک سرور WebDAV است که به زبان پایتون نوشته شده است. این راهنما از طریق نصب نسخه WsgiDAV نسخه 3.0 روی سرور Vultr که Debian 10 را اجرا می کند به شما کمک می کند. همچنین یک SSL گواهینامه برای تهیه یک اتصال ایمن و همچنین تأیید هویت PAM دریافت خواهیم کرد.

پیش نیازها

• سیستم Debian 10 که به شما دسترسی ممتازی داده اید (از طریق کاربر اصلی یا هر کاربر سودو.)
• $EDITORمتغیر محیطی باید به یک ویرایشگر متن انتخابی خود را تنظیم کنید.
• یک نام دامنه ثبت شده لازم است. سرورهای نام آن باید با Aسابقه ای که به آدرس IPv4 سرور شما نشان می دهد ، تنظیم شوند و به صورت اختیاری یک AAAAرکورد با اشاره به آدرس IPv6.
• آشنایی با نحوی YAML توصیه می شود.

از مکان یاب dav.example.comبرای نام دامنه سرور شما استفاده می شود.

نصب و راه اندازی

گواهی SSL

ما با به روز کردن سیستم و دریافت گواهینامه رایگان SSL از Let 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

ابتدا مدیر بسته بندی پایتون را نصب کنید pip:

sudo apt update
sudo apt install -y python3-pip

WsgiDAV به سرور HTTP نیاز دارد که WSGI را پشتیبانی می کند. گزینه پیش فرض را که Cheroot است نصب خواهیم کرد. ما همچنین کتابخانه lxml python را نصب خواهیم کرد ، که تمایل دارد عملکرد بهتری را نسبت به کتابخانه XML که به طور پیش فرض نصب شده ، انجام دهد. کتابخانه PAM (ماژول تأیید هویت Pluggable) 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موجود در بخش "SHARES" را پیدا کنید:

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 را برطرف می کند و به کاربران سیستم اجازه می دهد تا با استفاده از اعتبار معمول خود وارد سیستم شوند.

در بخش "AUTENTICATION" این خطوط را پیدا کنید:

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

ذخیره و خارج شوید ، سپس از دستورات زیر برای ایجاد پرونده log استفاده کنید:

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

سرانجام ، قبل از شروع 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