PanSou: 고성능 클라우드 디스크 리소스 검색 API 서비스 95

학습 자료나 영화를 찾을 때 클라우드 저장소는 좋은 채널이지만, 종종 여러 클라우드 저장소 사이를 오가며 검색해야 하고 일부 자료는 이미 만료된 경우가 많습니다.

PanSou 오픈소스 프로젝트는 이러한 문제를 해결해 주며, 여러 검색 소스를 하나의 API로 통합하여 한 번에各大 클라우드 저장소 플랫폼을 모두 검색할 수 있게 해줍니다.

PanSou는 고성능 클라우드 저장소 리소스 검색 API 서비스로, TG 채널 검색과 사용자 정의 플러그인 검색을 지원합니다. 시스템 설계는 성능과 확장성을 핵심으로 하며, 다채널·다플러그인 동시 검색이 가능하고, 결과를 지능적으로 정렬하며 클라우드 저장소 유형별로 분류할 수 있습니다.

PanSou 기능 특징

✅ 고성능 검색: 여러 TG 채널과 비동기 플러그인 검색을 동시에 실행하여 검색 속도가 더 빠릅니다.

✅ 클라우드 저장소 유형별 분류: 다양한 클라우드 저장소 링크를 자동으로 인식하여 유형별로 분류해 보여줍니다.

✅ 지능적 정렬: 플러그인 등급, 최신성, 우선 키워드 등 여러 요소를 종합적으로 고려하여 정렬합니다.

✅ 비동기 플러그인 시스템: 플러그인을 통해 검색 소스를 늘릴 수 있으며, "최대한 빨리 응답하고 계속 처리하는" 비동기 검색 모드를 지원합니다.

✅ 2단계 캐시: 분할 메모리 + 분할 디스크 캐시를 사용하여 반복 조회 속도와 동시 처리 성능이 눈에 띄게 향상됩니다.

지원되는 클라우드 저장소 유형

바이두 넷디스크, 알리윤판, 쿼크 넷디스크, 天翼云盘, UC 넷디스크, 移动云盘, 115 넷디스크, PikPak, 迅雷网盘, 123 넷디스크, 마그넷 링크, eDonkey 링크 등이 있습니다.

PanSou 기술 아키텍처

✅도구 계층 (util/): 2단계 캐시 시스템(cache/), 작업 풀(pool/), HTTP 클라이언트, 파싱 도구 등이 있습니다.

✅ 플러그인 시스템 계층(plugin/): 플러그인 인터페이스와 비동기 플러그인 기본 클래스를 정의하며, jikepan, pan666, hunhepan 등 다양한 구체적인 플러그인이 있습니다.

✅ 서비스 계층(service/): 캐시 통합, 검색 서비스 등을 포함합니다.

✅ 모델 계층(model/): 플러그인 결과, 요청, 응답 등 데이터 구조를 정의합니다.

✅ API 계층(api/): 핸들러, 미들웨어, 라우트 등이 있습니다.

✅ 캐시 시스템: 분할 메모리 캐시와 분할 디스크 캐시를 포함한 2단계 캐시를 사용하며, GOB 직렬화를 사용하고, 일부 플러그인은 자체 캐시 메커니즘(검색 결과 캐시, 상세 페이지 캐시 등)을 갖추고 있습니다.

✅ 동시성 제어: util/pool을 통해 작업 풀 관리를 구현하여 동시 작업을 제어합니다.

배포 및 사용

✅ Docker 배포를 지원하며(프런트엔드와 백엔드 통합 버전 및 순수 백엔드 API 버전), Docker 명령 또는 Docker Compose를 사용하여 빠르게 시작할 수 있습니다.

✅ 소스코드로부터 설치할 수도 있으며, Go 1.18+ 환경이 필요하고, 선택적으로 SOCKS5 프록시(Telegram 사이트 접속용)를 사용할 수 있습니다.

플러그인 시스템

PanSou는 플러그인을 통해 검색 소스를 늘릴 수 있으며, 플러그인 개발 가이드가 있습니다. 현재 huban, pan666, hdr4k 등 여러 플러그인이 있으며, 플러그인은 자체적으로 검색 로직과 캐시 전략 등을 구현할 수 있습니다.

또한 작성자는 PanSou의 상세한 시스템 개발 설계 문서도 공유하고 있으니, 관심 있는 개발자는 원리를 살펴볼 수 있습니다.