gallery-dl Reddit: 이미지 다운로드, OAuth 사용 및 오류 해결

목표를 가장 작게 표현하는 URL부터 시작하세요. 공개 게시물, subreddit, 사용자 페이지 또는 설치된 추출기가 인식하는 다른 URL 유형이 될 수 있습니다. 일반 브라우저 주소 표시줄에서 정식 URL을 복사하고, 가능하면 추적 매개변수를 제거한 뒤 셸에서 URL을 따옴표로 감싸세요.

--simulate은 미디어를 쓰지 않고 추출기와 선택 결과를 확인합니다. 파일을 실제로 저장하기 전에 설치, URL 인식, 접근 권한, 설정, 대상 폴더를 분리해서 확인할 수 있습니다.

gallery-dl --config-ignore --simulate "https://www.reddit.com/r/SUBREDDIT/"

gallery-dl --simulate "https://www.reddit.com/comments/POST_ID/"

gallery-dl -E "https://www.reddit.com/r/SUBREDDIT/"

gallery-dl -K "https://www.reddit.com/comments/POST_ID/"

공식 지원 사이트 문서에는 Reddit이 추출기로 표시되어 있습니다. 그러나 목록에 도메인이 있다는 사실만으로 모든 페이지, 검색, 계정 상태 또는 지역에서 같은 결과가 보장되지는 않습니다. 공개 게시물과 subreddit은 좋은 출발점이며, 저장 항목·개인화 피드·비공개 커뮤니티는 OAuth와 별도의 접근 규칙이 필요할 수 있습니다.

지원 여부는 URL 유형, 설치 버전, 계정 접근 권한, 추출기 기능을 함께 보고 판단하세요. 공개 게시물 테스트가 성공해도 해당 콘텐츠를 재게시할 권한이 생기는 것은 아닙니다.

익명 접근은 계정에 연결된 Reddit 콘텐츠를 안정적으로 대신하지 못합니다. 추출기가 OAuth를 요구하면 공식 gallery-dl 설정 문서에 설명된 애플리케이션 자격 증명을 사용하고 client secret을 비공개로 유지하며 명확한 user-agent를 지정하세요. 이는 사용자가 관리하는 계정과 앱으로 로컬에서 요청하기 위한 설정이며 제한을 우회하는 방법이 아닙니다.

공개 URL의 첫 테스트와 인증을 분리하세요. 먼저 공개 URL 인식을 확인한 다음 최소 OAuth 설정을 추가하고 정확한 계정 URL을 --simulate으로 테스트합니다. 실패하면 client ID, secret, user-agent, 계정 권한을 한 번에 하나씩 확인하세요.

{
  "extractor": {
    "reddit": {
      "client-id": "YOUR_CLIENT_ID",
      "client-secret": "YOUR_CLIENT_SECRET",
      "user-agent": "gallery-dl/1.32.9 by YOUR_USERNAME"
    }
  }
}

gallery-dl --simulate "https://www.reddit.com/user/USERNAME/saved/"

gallery-dl --config-ignore --simulate "https://www.reddit.com/r/SUBREDDIT/"

시뮬레이션이 성공하면 예측 가능한 저장 위치를 정하고 첫 실제 실행을 의도적으로 작게 유지하세요. 범위를 제한하면 피드 전체를 처리하기 전에 파일 이름, 이미지 품질, 동영상 처리, 누락 게시물과 저장 공간을 검토할 수 있습니다. 반복 작업에는 안정적인 아카이브를 사용하세요. 아카이브는 성공한 추출 ID를 기록하지만 미디어 백업은 아닙니다.

명령줄 버전이 작동한 뒤에만 옵션을 설정 파일로 옮기세요. 파일 이름이나 필터 표현식을 작성하기 전에 -K로 메타데이터를 확인하고 저장 위치, 아카이브, 계정별 값을 공개 지원 예시에 넣지 마세요.

gallery-dl --range "1-10" --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"

gallery-dl --destination "D:/Media/Reddit" --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"

gallery-dl --write-metadata --download-archive "reddit.sqlite3" "https://www.reddit.com/r/SUBREDDIT/"

모든 Reddit 오류를 옵션 부족으로 보지 마세요. 400은 잘못되었거나 변경된 URL, 불완전한 OAuth 정보, 추출기가 더 이상 만들 수 없는 요청에서 발생할 수 있습니다. 403 또는 차단은 계정 접근, 요청 제한, 플랫폼 정책, 지역 동작 또는 추출기 변경 때문일 수 있습니다. 반복 요청을 중지하고 일반 브라우저에서 URL을 확인한 뒤 깨끗한 시뮬레이션을 실행하세요.

빈 결과는 제한적인 필터, 이미 해당 ID를 가진 아카이브, 삭제된 콘텐츠 또는 접근 가능한 미디어가 없는 URL 유형 때문에 생길 수도 있습니다. --config-ignore와 필터 없는 상태로 비교한 다음 OAuth, 범위, 아카이브, 대상 폴더, 필터를 하나씩 다시 추가하세요.

gallery-dl은 로컬 다운로더이지 권한을 부여하는 시스템이 아닙니다. 접근하고 사용할 권한이 있는 콘텐츠만 저장하고 사용하세요. Reddit 규칙, 커뮤니티 기대, 개인정보, 저작권, 계정 권한, 요청 제한을 존중해야 합니다. 기술적으로 열리는 URL이 재게시 허가를 의미하지 않으며 OAuth도 계정 권한을 넓혀 주지 않습니다.

이 페이지의 2026년 8월 10일 최신성 확인에서 공식 PyPI 메타데이터와 Codeberg의 Windows·Linux 릴리스 파일로 gallery-dl 1.32.9를 확인했습니다. 동작이 바뀌면 gallery-dl --version과 공식 지원·설정 문서를 다시 확인하세요.

• 첫 테스트는 공개 URL, 작은 범위, --simulate으로 유지하세요.
• client secret, 토큰, 쿠키, 비공개 URL, 원문 로그를 공유하지 마세요.
• 거부되었거나 제한된 엔드포인트에 병렬 재시도 루프를 사용하지 마세요.
• 대규모 실행 전에 저장 위치, 필터, 저장 공간과 권한을 검토하세요.