From 88c342b3b60a878c6d389a9fe7398285f49a6e60 Mon Sep 17 00:00:00 2001 From: projectdx Date: Tue, 30 Dec 2025 21:15:30 +0900 Subject: [PATCH] docs: add README for anime_downloader plugin --- README.md | 67 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) diff --git a/README.md b/README.md index e69de29..26c3382 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,67 @@ +# Anime Downloader for FlaskFarm + +**Anime Downloader**는 FlaskFarm 플랫폼에서 동작하는 애니메이션 자동 다운로드 플러그인입니다. +국내 주요 스트리밍 사이트(Ohli24, Linkkf, Anilife)를 지원하며, 강력한 보안 우회 기능을 탑재하여 안정적인 다운로드를 보장합니다. + +--- + +## 🚀 주요 기능 (Key Features) + +* **다중 사이트 지원**: Ohli24, Anilife, Linkkf 등 다양한 소스에서 영상 검색 및 다운로드. +* **강력한 우회 기술 (Anti-Bot Bypass)**: + * **TLS Fingerprint 변조**: `curl_cffi`를 사용하여 실제 Chrome 브라우저처럼 위장, Cloudflare 및 각종 봇 차단을 무력화합니다. + * **CDN 자동 감지**: 스트리밍 서버(CDN)의 도메인이 수시로 변경되더라도 자동으로 감지하여 대응합니다. (예: 14B 가짜 파일 문제 해결) +* **스마트 다운로드 큐**: `ffmpeg` 및 `yt-dlp` 기반의 큐 시스템으로 안정적인 이어받기 및 재시도를 지원합니다. +* **사용자 편의성**: + * **Proxy 설정**: IP 차단 시 손쉽게 우회할 수 있도록 웹 설정 UI에서 프록시 서버를 지정할 수 있습니다. + * **반응형 UI**: 데스크탑과 모바일 모두에 최적화된 Glassmorphism 디자인. + +--- + +## 📺 지원 사이트 (Supported Sites) + +### 1. Ohli24 (애니24) +* **특징**: 가장 강력한 보안(Cloudflare)이 적용된 사이트. +* **기술**: `curl_cffi`를 이용한 Full Browser Impersonation 적용. +* **기능**: 검색, 목록 조회, 자동 다운로드. + +### 2. Linkkf (링크애니) +* **특징**: 빠른 업데이트 속도. +* **기능**: 검색 및 다운로드. + +### 3. Anilife (애니라이프) +* **특징**: 다양한 화질 제공. +* **기술**: Playwright 등을 활용한 브라우저 에뮬레이션(필요 시). + +--- + +## 🛠 설치 및 문제 해결 (Troubleshooting) + +### 필수 요구 사항 +* **Python 패키지**: `curl_cffi`, `lxml`, `requests`, `yt-dlp` +* **시스템 도구**: `ffmpeg` (시스템 경로에 설치되어 있어야 함) + +### 자주 묻는 질문 (FAQ) + +#### Q1. 설정 페이지 접근 시 404 오류가 뜹니다. +* **원인**: 플러그인 초기화 파일(`plugin.py`)이 누락되었기 때문입니다. +* **해결**: `plugin.py` 파일이 존재하는지 확인하고, 없다면 복구 후 서버를 재시작하세요. + +#### Q2. 검색 시 결과가 없거나 "Document is empty" 오류가 발생합니다. +* **원인**: 사이트의 보안 정책에 의해 접속이 차단된 경우입니다. +* **해결**: + 1. 최신 버전으로 업데이트하세요. (`curl_cffi` 적용 버전) + 2. 설정 페이지에서 **Proxy URL**을 비워두거나, 작동하는 유효한 프록시 IP를 입력하세요. + +#### Q3. 다운로드된 파일 용량이 매우 작습니다 (14 Byte 등). +* **원인**: CDN 서버에서 봇 접근을 감지하고 가짜 파일을 보낸 것입니다. +* **해결**: 플러그인 자체적으로 이를 감지하고 우회하는 패치가 적용되었습니다. 최신 버전 사용 시 자동으로 해결됩니다. + +--- + +## ⚙️ 설정 가이드 + +1. **FlaskFarm 웹 > 플러그인 > Anime Downloader > 설정**으로 이동합니다. +2. **Proxy URL**: 필요한 경우 `http://IP:PORT` 형식으로 입력 (기본값: 공란). +3. **저장 경로**: 다운로드된 파일이 저장될 경로 설정. +4. **다운로드 방법**: `ffmpeg` (기본) 추천.