프로젝트 소개

CloudSaver는 오픈소스 클라우드 드라이브 리소스 검색 및 저장 도구로, 프론트엔드는 Vue 3 + TypeScript + Vite로, 백엔드는 Node.js + Express + SQLite3으로 구축되었으며, 전체 프로젝트는 MIT 라이선스로 오픈소스화되어 있습니다. 이 프로젝트는 개인 사용자를 대상으로 하며, '검색 + 저장' 통합 경험을 강조하고, Docker를 통한 프라이비트 배포로 클라우드 드라이브 쿠키 등 민감한 자격 증명을 보호하는 데 중점을 둡니다. 핵심 기능은 다음과 같습니다: 다중 소스 리소스 검색으로 여러 리소스 구독 소스, 키워드 검색 및 리소스 링크 분석을 지원하며 Douban 인기 순위를 표시합니다. 클라우드 드라이브 리소스 저장은 115 드라이브, Quark 드라이브, China Telecom 드라이브, 123 드라이브의 원클릭 저장을 지원하며 저장 시 폴더를 표시하고 선택할 수 있습니다. 다중 사용자 시스템은 사용자 등록 및 로그인을 지원하고 관리자와 일반 사용자 권한을 구분합니다. 반응형 디자인은 PC 버전에서 Element Plus를, 모바일 버전에서 Vant를 사용하여 적응형 레이아웃과 차별화된 상호작용을 구현합니다. 기술 스택 측면에서 프론트엔드는 Vue 3, TypeScript, Vite, Pinia, Vue Router, Axios 및 Element Plus / Vant 컴포넌트 라이브러리를 사용합니다. 백엔드는 데이터 저장을 위해 Node.js, Express 및 SQLite3를 사용합니다. 환경 요구 사항은 Node.js >= 18.x이며, pnpm >= 8.x 사용을 권장합니다. 배포 방식은 세 가지를 제공합니다: 로컬 개발(pnpm install 후 pnpm dev), 프로덕션 빌드(pnpm build:frontend 및 백엔드 빌드 후 pnpm start), 그리고 Docker 배포. Docker 이미지는 dockerhub(jiangrui1994/cloudsaver)와 ghcr.io 두 개의 소스를 제공하며 latest 안정 버전과 test 테스트 버전을 구분합니다. 단일 컨테이너 실행 및 docker-compose 오케스트레이션을 지원하며, 기본 포트는 8008입니다. /app/data 및 /app/config 디렉터리를 마운트해야 하며, config 디렉터리 내 env 파일은 JWT_SECRET, TELEGRAM_BASE_URL 및 채널 목록 등 환경 변수를 설정하는 데 사용됩니다. 사용 시 주의 사항: 리소스 검색에는 프록시 환경 설정이 필요합니다. 기본 등록 코드는 관리자용 230713, 일반 사용자용 9527입니다. 프로젝트 README에서는 보안 경고를 특별히 강조하며, 쿠키 유출로 인한 계정 및 파일의 악의적 접근을 방지하기 위해 사용자가 직접 Docker를 통해 프라이비트 배포할 것을 강력히 권장하고, 제3자 온라인 서비스 사용을 피하도록 합니다. 이 프로젝트는 학습 교류 및 개인 사용을 위한 것이며, 상업적 용도는 지원되지 않습니다. 검색된 리소스는 모두 제3자로부터 제공되며, 저자는 그 진실성과 합법성에 대해 책임을 지지 않습니다. 프로젝트는 공식 Telegram 그룹, QQ 교류 그룹, Yuque 업데이트 로그 및 FAQ 문서를 제공하며, Fork 및 Pull Request를 통한 기여를 환영합니다. CDN 가속 및 보안 보호는 Tencent EdgeOne가 후원합니다.