WsgiDAV를 사용하여 Debian 10에 WebDAV 배포

• 소개
• 전제 조건
• 설치
• 추가 자료

소개

WebDAV (Web Distributed Authoring and Versioning)는 서버에서 파일을 원격으로 작성하고 수정하기위한 프레임 워크를 제공하는 HTTP 확장입니다. WsgiDAV는 Python으로 작성된 WebDAV 서버입니다. 이 안내서는 데비안 10을 실행하는 Vultr 서버에 WsgiDAV 버전 3.0을 설치하는 데 도움이됩니다. 또한 SSL 연결을 통해 PAM 인증뿐만 아니라 보안 연결을 제공합니다.

전제 조건

• (루트 사용자 또는 sudo 사용자를 통해) 접근 권한이있는 데비안 10 시스템.
• $EDITOR환경 변수를 원하는 텍스트 편집기로 설정해야합니다.
• 등록 된 도메인 이름이 필요합니다. 이름 서버는 A서버의 IPv4 주소를 AAAA가리키는 레코드 와 선택적으로 IPv6 주소를 가리키는 레코드 로 구성해야합니다 .
• YAML 구문에 익숙 할 것을 권장합니다.

자리 표시 dav.example.com자는 서버의 도메인 이름으로 사용됩니다.

설치

SSL 인증서

시스템을 업데이트하고 Let 's Encrypt 에서 무료 SSL 인증서를 얻는 것으로 시작 하겠습니다 . 이렇게하려면 먼저 시스템을 업데이트하고 certbot유틸리티를 설치하십시오 .

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

아래 명령에서 dav.example.com및 [email protected]실행하기 전에 도메인 이름과 이메일 주소를 각각 바꾸 십시오.

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

지정된 도메인 이름을 제어하는지 확인하기 위해 서버에 챌린지가 전송됩니다. 성공하면 개인 키와 같은 다른 파일과 함께 인증서가 발급 및 저장됩니다 /etc/letsencrypt/live/dav.example.com/.

WsgiDAV 설치

먼저 python package manager를 설치하십시오 pip:

sudo apt update
sudo apt install -y python3-pip

WsgiDAV에는 WSGI를 지원하는 HTTP 서버가 필요합니다. 기본 옵션 인 Cheroot를 설치합니다. 또한 lxml python 라이브러리를 설치합니다.이 라이브러리는 기본적으로 설치된 XML 라이브러리보다 성능이 우수합니다. PAM (Pluggable Authentication Module) 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"공유"섹션에서 블록을 찾으십시오 .

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 사용자 계정이 필요하지 않으며 시스템 사용자는 일반적인 자격 증명을 사용하여 로그인 할 수 있습니다.

"인증"섹션에서 다음 행을 찾으십시오.

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를 사용 하여 서버를 중지하십시오.

서비스로 설치

systemd가 관리하는 시스템 서비스로 WebDAV 서버를 실행하려면 유닛 파일을 작성하십시오.

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

저장하고 종료 한 다음 아래 명령을 사용하여 로그 파일을 작성하십시오.

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

이제 systemctlWebDAV 서버를 시작, 중지 및 다시 시작 하는 데 사용할 수 있습니다 . WsgiDAV의 표준 출력 및 오류는에 기록되며을 /var/log/wsgidav.log사용하여 액세스 할 수도 있습니다 sudo journalctl -u wsgidav.service.

시스템 부팅시 WebDAV 서버가 자동으로 시작되도록하려면 다음을 실행하십시오.

 sudo systemctl enable wsgidav.service

추가 자료

• CentOS 7에서 Apache를 사용하여 WebDAV 서버를 설정하는 방법
• WsgiDAV 설명서