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

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

소개

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

전제 조건

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

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

설치

1. 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/에 발급되고 저장됩니다.

2. WsgiDAV 설치

먼저 Python 패키지 관리자를 설치합니다:

sudo apt update
sudo apt install -y python3-pip

WsgiDAV는 WSGI를 지원하는 HTTP 서버가 필요하며, 기본 옵션인 Cheroot를 설치합니다. 또한, lxml Python 라이브러리와 PAM (Pluggable Authentication Module) Python3 라이브러리를 설치합니다.

sudo pip3 install wsgidav cheroot lxml python-pam

3. 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: "/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 경로를 파일 시스템의 해당 위치에 매핑하여 공유 경로를 설정합니다:

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: 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를 누릅니다.

4. 서비스로 설치

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

이제 systemctl을 사용하여 WebDAV 서버를 시작, 중지 및 다시 시작할 수 있습니다. WsgiDAV의 출력 및 오류는 /var/log/wsgidav.log에 기록됩니다.

시스템 부팅 시 WebDAV 서버가 자동으로 시작되도록 하려면 다음 명령어를 실행합니다:

sudo systemctl enable wsgidav.service

추가 자료

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