접속
- 브라우저 열기:
https://<SERVER-IP> - 설치 시 자체 서명 TLS 인증서를 사용하므로 브라우저의 인증서 경고를 수락하세요.
- 인증이 필요합니다 (Basic Auth 팝업)
- 인증 방식: HTTP Basic Auth
- 로그인 자격 증명은 다음 위치에 안전하게 저장됩니다:
/root/.cloudzy-creds
파일 추가
- 공유하려는 파일과 폴더를 다음 위치에 두세요:
/root/directory-lister/files - Directory Lister는 이 디렉터리를 직접 읽으므로 새로 추가한 파일은 애플리케이션을 다시 시작하지 않아도 자동으로 표시됩니다.
중요한 파일 및 디렉토리
- 설치 경로:
/root/directory-lister - 표시되는 파일:
/root/directory-lister/files - Docker Compose 파일:
/root/directory-lister/docker-compose.yml - 환경 파일:
/root/directory-lister/.env - 자격 증명:
/root/directory-lister/.credentials - Nginx 설정:
/etc/nginx/sites-available/directory-lister - Basic Auth 파일:
/etc/nginx/.htpasswd-directory-lister - TLS 인증서:
/etc/nginx/ssl/directory-lister.crt - TLS 개인 키:
/etc/nginx/ssl/directory-lister.key
서비스 관리
실행 중인 컨테이너 보기:
docker compose -f /root/directory-lister/docker-compose.yml ps
Directory Lister 재시작:
docker compose -f /root/directory-lister/docker-compose.yml restart
Directory Lister 로그 보기:
cd /root/directory-lister && docker compose logs -f
Directory Lister 중지:
docker compose -f /root/directory-lister/docker-compose.yml stop
Directory Lister 시작:
docker compose -f /root/directory-lister/docker-compose.yml start
Directory Lister 다시 생성:
docker compose -f /root/directory-lister/docker-compose.yml up -d
Nginx 상태 확인:
systemctl status nginx
Nginx 재시작:
systemctl restart nginx
Nginx 다시 로드:
systemctl reload nginx
Nginx 구성을 검증하세요:
nginx -t
도메인으로 HTTPS 활성화하기
1. 도메인을 서버 IP로 지정하세요.
2. 편집 /etc/nginx/sites-available/directory-lister 그리고 둘 다 교체하세요: server_name _; 지시문을 도메인으로 (예: server_name yourdomain.com;).
3. Certbot 설치:
apt install -y certbot python3-certbot-nginx
4. Let's Encrypt 인증서를 발급받으세요:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. 편집하세요: /etc/nginx/sites-available/directory-lister 그리고 다음을 업데이트하세요: ssl_certificate 와 ssl_certificate_key Let's Encrypt 인증서를 사용하도록 지시문을.
Before:
ssl_certificate /etc/nginx/ssl/directory-lister.crt;
ssl_certificate_key /etc/nginx/ssl/directory-lister.key;
After:
ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. 변경 사항을 적용하려면 Nginx를 다시 로드합니다:
systemctl reload nginx
7. 다음 주소에서 Directory Lister에 접속하세요 https://yourdomain.com.
Nginx에서 HTTP Basic Auth 비활성화 (선택 사항)
인증 없이 Directory Lister를 공개하려면 아래 단계에 따라 HTTP Basic Auth를 비활성화하세요.
Nginx 사이트 파일을 편집하세요: /etc/nginx/sites-available/directory-lister
다음 줄을 삭제하거나 주석 처리하세요:
auth_basic "Directory Lister";
auth_basic_user_file /etc/nginx/.htpasswd-directory-lister;
Nginx 다시 로드:
systemctl restart nginx
참고
- Directory Lister는 NGINX 뒤의 Docker에서 실행됩니다.
- 공개 접근은 HTTP Basic Authentication으로 보호됩니다.
- 표시되는 파일은 다음 위치에 저장됩니다
/root/directory-lister/files. - 애플리케이션 컨테이너는 파일 디렉터리에 대해 읽기 권한만 가집니다.
