RepoThread Logo
RepoThread
요금제

빠른 시작

관련 소스 파일

이 페이지의 내용은 다음 소스 파일을 기반으로 생성되었습니다:

res-downloader는 Go 언어와 Wails 프레임워크를 기반으로 제작된 크로스 플랫폼 리소스 다운로드 도구입니다. 이 도구는 프록시 방식을 통해 네트워크 패킷을 캡처하고, 비디오, 오디오, 이미지, m3u8, 라이브 스트림 등 다양한 리소스를 감지하고 다운로드할 수 있습니다. (README.md:17-28)

다운로드 및 설치

시스템 요구사항

res-downloader는 Windows, macOS, Linux를 지원하는 크로스 플랫폼 애플리케이션입니다. 각 운영체제별 설치 파일은 GitHub Releases 페이지 또는 지정된 다운로드 링크에서 제공됩니다. (README.md:21-28)

운영체제지원 버전설치 파일 형식비고
WindowsWin10 이상.exe (설치형), x64-installer.exeWin7 사용자는 2.3.0 버전 사용 권장
macOS최신 버전.dmg-
LinuxUbuntu 등.deb, 실행 파일배포판에 따라 적절한 패키지 선택

주의: Windows 7 사용자는 최신 버전 대신 2.3.0 버전을 다운로드해야 합니다. (README.md:36-41)

다운로드 경로

소프트웨어는 다음 경로에서 다운로드할 수 있습니다:

플랫폼별 설치 방법

Windows 설치

  1. 다운로드한 .exe 파일을 더블 클릭하여 실행
  2. 설치 마법사를 따라 설치 진행
  3. 중요: 설치 시 인증서 파일 설치를 반드시 허용해야 합니다
  4. 중요: 네트워크 접근을 허용해야 합니다
  5. 설치 완료 후, 반드시 관리자 권한으로 실행 (마우스 우클릭 → 관리자 권한으로 실행) (docs/installation.md:1-11)

macOS 설치

  1. 다운로드한 .dmg 파일을 더블 클릭
  2. 나타난 창에서 res-downloader를 Applications 폴더로 드래그
  3. 설치 시 인증서 파일 설치 및 네트워크 접근을 허용해야 합니다 (docs/installation.md:1-11)

Linux 설치

Ubuntu/Debian 계열 (deb 패키지):

bash
1sudo apt install res-downloader_3.0.2_linux_x64.deb

실행 파일 방식:

bash
1chmod +x ./res-downloader_3.0.2_linux_x64
2sudo ./res-downloader_3.0.2_linux_x64

(docs/installation.md:13-21)

기본 사용 설정

필수 설정 사항

소프트웨어를 처음 실행하기 전에 다음 사항을 반드시 확인해야 합니다:

  1. 인증서 설치 허용: 설치 과정에서 인증서 파일 설치를 반드시 허용해야 HTTPS 트래픽을 캡처할 수 있습니다
  2. 네트워크 접근 허용: 방화벽에서 네트워크 접근을 차단하지 않도록 설정합니다
  3. 관리자 권한 실행: Windows의 경우首次 실행 시 반드시 관리자 권한으로 실행해야 시스템 프록시 설정이 정상적으로 적용됩니다 (docs/getting-started.md:7-18)

프록시 설정

res-downloader는 시스템 프록시를 통해 네트워크 트래픽을 캡처합니다. 기본 설정은 다음과 같습니다:

설정 항목기본값설명
프록시 주소127.0.0.1로컬 프록시 서버 주소
프록시 포트8899기본 리스닝 포트
호스트 바인딩0.0.0.0모든 네트워크 인터페이스에서 수신

(frontend/src/stores/index.ts:17-38, README.md:76-85)

macOS 추가 설정

macOS에서 방화벽이 활성화되어 있는 경우, 리소스 캡처가 실패할 수 있습니다. 이 경우 방화벽을 비활성화하거나 res-downloader에 대한 네트워크 접근을 허용하도록 설정해야 합니다. (docs/getting-started.md:14-18)

리소스 캡처 및 다운로드

기본 사용 흐름

正在加载图表渲染器...

단계별 실행 가이드

  1. 소프트웨어 실행: Windows는 관리자 권한으로 실행, macOS/Linux는 일반 실행
  2. 프록시 활성화: 소프트웨어 좌측 상단의 "프록시 시작" 버튼 클릭 (README.md:48-57)
  3. 리소스 유형 선택: 캡처할 리소스 유형을 선택 (기본값: 전체 유형)
  4. 외부 리소스 접근: 캡처하려는 리소스가 있는 웹페이지, 미니프로그램, 앱 등을 엽니다
  5. 캡처 확인: 소프트웨어 메인 화면에서 캡처된 리소스 목록 확인

지원 리소스 유형

res-downloader는 다음과 같은 리소스 유형을 지원합니다:

  • 비디오: 일반 비디오 파일, 스트리밍 비디오
  • 오디오: 음악 파일, 팟캐스트 등
  • 이미지: 정적 이미지, 움짤 등
  • m3u8: HLS 스트리밍 비디오
  • 라이브 스트림: 실시간 방송 스트림 (README.md:21-28)

지원 플랫폼

이 도구는 다음 플랫폼의 리소스 캡처를 지원합니다:

  • 위챗 비디오 계정(视频号)
  • 미니프로그램
  • Douyin(抖音)
  • Kuaishou(快手)
  • Xiaohongshu(小红书)
  • Kugou Music(酷狗音乐)
  • QQ Music
  • 일반 웹페이지 (README.md:21-28)

프록시 제어 메커니즘

소프트웨어 내부적으로 프록시는 다음과 같이 제어됩니다:

typescript
1// 프록시 활성화
2const openProxy = async () => {
3    return appApi.openSystemProxy().then(handleProxy)
4}
5
6// 프록시 비활성화
7const unsetProxy = async () => {
8    return appApi.unsetSystemProxy().then(handleProxy)
9}

(frontend/src/stores/index.ts:72-86)

실행 검증

정상 실행 확인 방법

소프트웨어가 정상적으로 실행되었는지 확인하는 방법:

  1. UI 로드 확인: 메인 화면이 정상적으로 표시되는지 확인
  2. 프록시 상태 확인: 좌측 상단의 프록시 버튼이 활성화 상태인지 확인
  3. 캡처 테스트: 간단한 웹페이지를 열어 리소스가 캡처되는지 확인

시스템 프록시 확인

소프트웨어 실행 후 시스템 프록시가 올바르게 설정되었는지 확인:

애플리케이션 정보 확인

소프트웨어 시작 시 다음 정보가 콘솔에 출력됩니다:

version: [버전 번호]
lockfile: [락 파일 경로]

(main.go:64-67)

문제 해결

일반적인 문제와 해결 방법

1. 리소스가 캡처되지 않는 경우

증상: 소프트웨어를 실행하고 웹페이지를 방문했지만 리소스가 캡처되지 않음

해결 방법:

2. 소프트웨어 종료 후 인터넷 연결 불가

증상: res-downloader를 종료한 후 웹 브라우저에서 인터넷 접속 불가

원인: 소프트웨어가 종료될 때 시스템 프록시 설정이 자동으로 해제되지 않음

해결 방법: 시스템 설정에서 수동으로 프록시 설정을 비활성화 (docs/troubleshooting.md:40-45, README.md:82-85)

3. macOS에서 "손상됨, 열 수 없음" 오류

증상: macOS에서 앱 실행 시 "손상되었거나 확인할 수 없음" 오류 발생

해결 방법: 터미널에서 다음 명령 실행:

bash
1sudo xattr -d com.apple.quarantine /Applications/res-downloader.app

(docs/troubleshooting.md:32-34)

4. 인증서 설치 후에도 설치 프롬프트 표시

증상: 인증서를 설치했음에도 불구하고 계속해서 설치 프롬프트가 표시됨

해결 방법:

  1. 명령줄로 소프트웨어 실행
  2. lockfile: 뒤에 표시되는 경로 확인
  3. 해당 경로에 빈 파일 생성:
bash
1# macOS 예시
2touch /Users/[사용자명]/Library/Preferences/res-downloader/install.lock

(docs/troubleshooting.md:73-77)

5. 다운로드 속도가 느리거나 대용량 파일 다운로드 실패

해결 방법: 외부 다운로드 도구 사용 권장:

설정 파일 위치

문제 발생 시 설정 파일을 삭제하여 초기화할 수 있습니다:

운영체제설정 파일 경로
macOS/Users/[사용자명]/Library/Preferences/res-downloader
WindowsC:\Users\[사용자명]\AppData\Roaming\res-downloader
Linux/home/user/.config/res-downloader

(docs/troubleshooting.md:11-21)

다음 단계

고급 기능 탐색

기본 사용법을 익힌 후, 다음 기능들을 탐색해 볼 수 있습니다:

  1. 리소스 필터링: 특정 유형의 리소스만 캡처하도록 설정
  2. 프록시 고급 설정: 업스트림 프록시 설정으로 제한된 네트워크 환경에서 사용
  3. 다운로드 최적화: 동시 다운로드 수, 다운로드 프록시 등의 설정 조정

m3u8 및 라이브 스트림 처리

추가 지원

더 많은 도움이 필요한 경우: