Question 1

Kapowarr에서 GetComics를 검색할 때 발생하는 HTTP 403 오류를 해결하는 방법

Accepted Answer

GetComics는 Kapowarr의 경로 기반 페이지네이션 URL(`/page/1?s=query`, `/page/2?s=query`)을 HTTP 403으로 거부할 수 있으며, 루트 쿼리 URL은 HTTP 200을 반환합니다. 이 문제는 PR #394(V1.3.2 이후)에서 검색 엔드포인트를 사이트 루트로 전환하여 수정되었습니다. 첫 번째 페이지는 `/?s=query`를 사용하고, 이후 페이지는 `/?s=query&paged=2`, `&paged=3` 등을 사용합니다. PR #394가 포함된 빌드로 Kapowarr를 업데이트하거나, 소스에서 실행하는 경우 `backend/implementations/indexer_clients/ddl/GetComics.py`를 편집하여 `s` 및 `paged` 쿼리 매개변수와 함께 루트 URL을 사용하도록 변경하세요. 결과 파싱, 매칭, 요청 페이싱, RSS 처리 및 속도 제한은 변경되지 않았습니다.

Question 2

Kapowarr FlareSolverr "Timeout after 60.0 seconds", GetComics "No links found" 오류 및 NoneType .encode() 크래시를 해결하는 방법?

Accepted Answer

기본 `mrcas/kapowarr:latest` 이미지에서는 issue #335가 업스트림에서 수정될 때까지 이러한 오류를 해결하기 위해 로컬 패치가 필요할 수 있습니다:

1. **FlareSolverr 타임아웃 늘리기.** 모든 FlareSolverr `request.get` 페이로드에 `maxTimeout`을 추가합니다. 값은 밀리초 단위입니다:
   ```python
   payload["maxTimeout"] = 300000  # 300초
   ```
   또한 HTTP 클라이언트가 FlareSolverr이 완료되기 전에 중단하지 않도록, FlareSolverr에 대한 Kapowarr의 HTTP 타임아웃을 300초보다 약간 더 긴 310~320초 정도로 늘립니다.

2. **GetComics 컬렉션/인덱스 페이지 처리.** 일치하는 페이지가 `No links found on webpage that match to volume and are not blocklisted`를 반환하면, 해당 페이지에서 내부 GetComics 아티클 링크를 찾고, 일치하는 볼륨/제목으로 필터링한 다음, 포기하기 전에 해당 아티클 페이지를 재귀적으로 가져옵니다. 중첩된 아티클 페이지에서 일반적인 호스터 링크 추출을 실행합니다. 루프를 방지하기 위해 재귀 제한을 추가합니다.

3. **빈 FlareSolverr 응답 방어 처리.** `.encode("utf-8")`를 호출하기 전에 `None`이거나 빈 본문은 끊어진 링크로 처리합니다:
   ```python
   body = fs_result.get("response")
   if not body:
       # 이 후보를 실패로 표시하고 계속 진행
       continue
   response._body = body.encode("utf-8")
   ```

4. **끊어진 호스터 링크를 건너뛰고 계속 진행.** null/빈 본문이나 실패한 다운로드는 해당 후보만 거부해야 하며, 전체 다운로드 작업을 중단시켜서는 안 됩니다.

변경 사항을 적용한 후 패치된 Kapowarr 이미지를 다시 빌드하거나 실행하고 컨테이너를 재시작합니다. 예시:
```bash
docker restart kapowarr flaresolverr
```
그러면 패치된 흐름이 GetComics 페이지를 처리하고, 중첩된 아티클 링크를 따라가고, 작동하는 호스터를 선택하고, 다운로드 및 가져오기를 수행한 후 라이브러리 데이터베이스를 업데이트합니다.

Question 3

GetComics에서 429 요청 제한 오류로 인해 차단된 URL을 수정하는 방법?

Accepted Answer

대량 검색을 빠르게 트리거하지 않도록 주의하십시오. 이는 429 오류를 유발하여 잘못된 블록리스트에 등록될 수 있습니다. 해결 방법으로는 수동으로 검색하거나 요청 간에 지연을 두는 방법이 있습니다. 영구적인 수정(HTTP 429와 실제 실패를 구분하고 속도 제한 오류에 대해 블록리스트를 건너뛰는 것)은 이 이슈에서 추적 중입니다.

Question 4

완료된 다운로드를 가져올 때 Kapowarr에서 발생하는 SQLite 'database is locked' 오류(DELETE FROM download_queue)를 해결하는 방법

Accepted Answer

원인: Kapowarr V1.3.2에서 `backend/features/download_queue.py`의 `DownloadHandler.__prepare_downloads_for_queue()`가 삽입 트랜잭션을 먼저 커밋하지 않은 채 큐 행을 삽입하고 다운로드 워커를 시작합니다. 여러 릴리스를 추가할 때 네트워크 기반 링크 준비가 해당 쓰기 트랜잭션을 계속 열어 두므로, 다른 다운로드가 완료되어 `DELETE FROM download_queue`를 실행할 때 해당 행이 여전히 잠겨 있어 SQLite가 'database is locked' 오류를 발생시킵니다. 임시 해결 방법(소스 패치): 큐 행을 삽입한 직후, 다운로드 워커를 준비/시작하기 전에 명시적 커밋을 추가하여, 추가 네트워크 작업이 시작되기 전에 새로 삽입된 큐 행이 다른 연결에 보이도록 하세요. 보고자는 두 개의 연결을 사용하는 WAL 모드 재현으로 이를 로컬에서 확인했습니다: 조기 커밋이 없으면 두 번째 연결이 행을 삭제하지 못하지만, 커밋을 추가하면 삭제에 성공하고 이후 대량 다운로드도 잠금 오류 없이 임포트되었습니다. 참고: (1) 이 수정은 issue #389를 위해 커밋 594defb에서 후처리 단계 사이에 추가된 명시적 커밋을 대체하는 것이 아니라 보완합니다. (2) 프로젝트의 기존 커밋 헬퍼를 사용하되, 연결을 커밋하면 해당 연결에 있는 다른 대기 중인 쓰기도 함께 커밋된다는 점에 유의하세요. (3) 데이터베이스 타임아웃을 늘리거나 재시도를 추가하여 문제를 가리지 마세요. (4) 보고 시점 기준으로 이 수정 사항은 아직 업스트림에 병합되지 않았으므로, 적용하기 전에 최신 개발 브랜치를 확인하세요.

Kapowarr

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트