gallery-dl Tumblr를 사용할 때는 URL 범위, 접근 권한, 반복 실행 관리를 분리하면 이해하기 쉽습니다. 이 가이드에서는 공개 블로그를 먼저 테스트하고, 태그나 게시물을 좁은 범위로 저장하며, 필요한 경우에만 쿠키를 추가하고, 예측 가능한 로컬 아카이브를 만드는 방법을 다룹니다.
블로그 URL태그와 검색쿠키중복 없는 아카이브
Tumblr 작업은 작은 URL 테스트로 시작해 확인된 로컬 아카이브로 마무리합니다.빠른 답변
Tumblr 공개 블로그, 태그, 게시물 또는 검색 URL을 입력으로 사용하세요. 먼저 gallery-dl --simulate를 실행해 파일을 쓰지 않고 결과를 확인한 뒤, 같은 URL을 작은 범위와 알려진 저장 위치로 실행합니다. Tumblr가 로그인 세션을 요구할 때만 브라우저 쿠키를 추가하고, 반복 작업이라면 아카이브 파일을 유지하세요.
범위
gallery-dl Tumblr가 처리하는 범위
gallery-dl Tumblr Extractor는 단일 이미지 주소보다 블로그 형식의 URL을 처리하도록 설계되었습니다. Tumblr 블로그 이름, 사용자 지정 서브도메인, 게시물 링크와 컬렉션에 가까운 경로를 인식합니다. 사진, 동영상, 오디오, 인용, 링크, 답변, 채팅, 검색 결과 같은 게시물 유형도 구분합니다. 한 블로그에 글과 미디어가 섞여 있을 수 있으므로 저장하려는 유형을 먼저 정해야 합니다.
gallery-dl Tumblr를 통제된 아카이브 작업으로 생각하면 좋습니다. URL이 대상을 정하고 Extractor가 메시지와 미디어로 변환하며, 설정이 저장 위치, 파일 이름과 이미 처리한 항목의 처리를 결정합니다. 명령은 비공개 게시물에 권한을 주거나 로그인 과정을 우회하지 않으며, 다른 사람의 작품을 보관할 권리도 판단하지 않습니다.
이 페이지는 지원 사이트 목록보다 구체적이고 일반 사용 가이드보다 Tumblr에 집중합니다. 설치, 쿠키 내보내기, 파일 이름 키워드와 아카이브 관리는 연결된 페이지에서 확인하고, 여기서는 Tumblr에 특화된 선택을 정리합니다.
유용한 기준
Tumblr URL을 검색 범위의 경계로 취급하세요. 블로그 URL은 넓고, 태그 URL은 주제에 맞으며, 게시물 URL은 한 항목 확인에 좋고, 검색 URL은 계속 바뀝니다. 페이지 매김, 필터 또는 장기 아카이브를 추가하기 전에 그 경계를 기록하세요.
URL 범위가 Extractor가 찾는 대상을 결정합니다.
시뮬레이션으로 실제 기록 전 결과를 확인합니다.
설정으로 경로, 이름, 지연 시간과 아카이브를 관리합니다.
보관 가능 여부는 권리와 Tumblr 규칙에 따릅니다.
URL 선택
Tumblr URL 유형을 올바르게 선택하기
질문에 필요한 가장 작은 URL부터 시작하세요. 게시물 URL은 특정 항목을 분석할 수 있는지 확인하는 데 좋습니다. 블로그 URL은 작성자의 미디어를 계속 정리할 때 사용합니다. 태그나 검색 URL은 새 결과가 생기므로 넓고 불안정합니다. 모바일 공유 URL에 추적 매개변수가 있어도 같은 범위를 가리키는지 확인한 뒤 정리하세요.
Tumblr 블로그는 여러 형태로 나타납니다. `tumblr.com/blog/name`, `name.tumblr.com`, 게시물 퍼머링크가 같은 블로그를 가리킬 수 있지만 테스트 편의성은 다릅니다. 짧고 정식 형태에 가까운 URL을 우선하고 원래 주소도 메모하세요.
테마에 표시된 모든 이미지가 게시물 미디어인 것은 아닙니다. 아바타, 추천, 외부 삽입물과 장식 리소스가 섞일 수 있습니다. 필터를 만들기 전에 시뮬레이션 결과에서 ID, 미디어 URL과 게시물 유형을 확인하세요.
URL 범위
첫 사용 목적
주의점
단일 게시물
분석과 권한 확인
다운로드할 미디어가 없을 수 있음
블로그
작성자 또는 컬렉션 아카이브
작업이 매우 커질 수 있음
태그
주제 샘플
결과가 변함
검색
후보 발견
재현하기 어려움
사용자 지정 서브도메인
직접 블로그 작업
Tumblr 소유인지 확인
URL 하나로 시작
한 게시물을 시뮬레이션하는 편이 테마 리소스와 리블로그까지 섞는 큰 명령보다 올바른 대상을 확인하기 쉽습니다.
첫 실행
안전한 첫 테스트 설치와 실행
Python 또는 패키지 환경에 맞는 방식으로 gallery-dl을 설치하세요. 설치 가이드의 선택지를 확인하고 `gallery-dl --version`이 응답하면 Tumblr의 첫 실행을 작게 유지합니다. 시뮬레이션은 미디어를 저장하지 않고 Extractor 메시지를 보여 주므로 잘못된 URL, 로그인 화면, 너무 넓은 범위를 미리 발견할 수 있습니다.
아래 명령 형태를 사용하되 확인 권한이 있는 공개 Tumblr URL로 바꾸세요. 출력은 다음 결정을 위한 증거이지 모든 게시물에 파일이 있다는 보장은 아닙니다.
시뮬레이션이 예상과 같으면 빈 테스트 폴더에서 `--simulate`를 제거하고 실행하세요. 처음에는 기존 아카이브와 분리해 메시지와 파일 수를 비교하고 테스트 결과만 삭제할 수 있게 합니다.
재현 가능한 Tumblr 작업은 URL을 고르고 결과를 시뮬레이션한 뒤 작은 샘플을 저장합니다.
시뮬레이션 출력 읽기
Extractor 이름, 블로그 또는 게시물 ID, 미디어 URL, 인증 경고를 확인하세요. 빈 결과가 나와도 곧바로 쿠키를 추가하거나 설정을 많이 바꾸지 않습니다. URL 형식, 블로그 공개 여부, 설치된 버전이 현재 응답을 처리하는지부터 확인하세요.
블로그 전체 저장은 흔하지만 모든 작업의 기본값은 아닙니다. 특정 이미지 하나가 필요하면 게시물 URL을 사용하세요. 주제를 모으려면 태그와 작은 범위를 사용하세요. 낯선 주제를 탐색할 때는 검색으로 후보를 찾은 뒤 반복 가능한 게시물 또는 블로그 작업으로 바꾸세요.
Extractor는 사진 외에도 여러 유형을 만날 수 있습니다. 동영상과 오디오는 다르게 처리될 수 있고, 텍스트·인용·답변 게시물은 파일을 만들지 않을 수 있으며, 리블로그 메타데이터가 파일 이름에 들어갈 수 있습니다. 필터를 쓰기 전에 시뮬레이션에서 유형을 확인하세요.
큰 블로그는 확인 지점으로 나누세요. 첫 범위를 실행하고 폴더와 아카이브를 확인한 뒤 확장합니다. 네트워크 오류가 나도 안정적인 이름과 아카이브가 있으면 이전 항목을 새 항목으로 보지 않고 재개할 수 있습니다.
실용적인 순서
먼저 게시물 하나를 검증하고 블로그 또는 태그 범위를 검증합니다. 그다음 쿠키가 필요한지 판단하고 저장 위치와 아카이브를 추가합니다. 샘플을 이해한 뒤에만 반복하세요. 이렇게 하면 분석 문제와 접근 문제를 분리할 수 있습니다.
게시물 URL: 한 항목 분석 확인.
블로그 URL: 작성자 또는 컬렉션 아카이브.
태그 URL: 제한된 주제 샘플.
검색 URL: 발견용이며 고정 아카이브 키로는 부적합.
좋은 결과의 기준
좋은 결과는 설명할 수 있습니다. 어떤 URL에서 나왔는지, 파일 수가 왜 타당한지, 어떤 유형이 포함됐는지, 어디에 저장됐는지를 알아야 합니다. 반복과 검증이 불가능한 대량 저장은 안전한 흐름이 아닙니다.
반복성
설정, 파일 이름과 아카이브 제어
테스트 명령을 이해한 뒤 안정적인 선택을 gallery-dl 설정으로 옮기세요. Tumblr 디렉터리, 이름 필드, 다운로드 아카이브와 적절한 지연 시간을 한 곳에서 관리하면 수동 실행과 예약 실행의 차이가 줄어듭니다.
Tumblr 파일 이름에는 블로그, 게시물 또는 ID, 여러 미디어를 구분하는 번호가 드러나는 것이 좋습니다. 필드 이름을 추측하지 말고 파일 이름 가이드에서 키워드를 확인하세요. 게시물 유형에 없는 필드는 읽기 쉬운 대체값을 사용합니다.
아카이브는 처리한 ID의 기록이며 미디어 백업이 아닙니다. 설정 옆에 보관하고 백업하며 URL 정보가 포함될 수 있다면 공개하지 마세요. 폴더나 이름 형식을 바꾼 뒤에도 같은 논리 항목을 건너뛰고 싶을 때만 같은 아카이브를 유지하세요.
폴더 이름을 바꿔도 아카이브의 정체성은 바뀌지 않습니다. 파일을 옮기기 전에 같은 게시물을 계속 건너뛸지 결정하세요.
접근
Tumblr가 요구할 때만 쿠키 사용
공개 Tumblr 페이지를 첫 테스트로 삼으세요. 브라우저에서는 보이는데 gallery-dl이 접근 오류를 반환한다면 세션 쿠키, 동의 상태 또는 브라우저 로딩 뒤 달라진 응답이 원인일 수 있습니다. 사이트 쿠키 도우미에서 로컬로 내보내고, 값을 명령이나 공개 이슈에 붙이지 말고 gallery-dl이 지원하는 옵션으로 파일을 전달하세요.
쿠키는 비공개 페이지를 공개로 만들지 않으며 저장 권한을 보장하지 않습니다. 만료되고 계정 권한을 반영하며 복사하면 접근 정보가 노출될 수 있습니다. 파일 권한을 제한하고 공개 폴더 밖에 보관하며 테스트가 끝나면 지우세요.
쿠키를 사용한 실행이 실패하면 공개 URL 시뮬레이션과 비교하세요. 공개 테스트도 실패한다면 인증보다 URL 분석, 버전, 네트워크 또는 속도 문제일 가능성이 큽니다.
신중한 접근 확인
공개 URL을 확인하고 필요한 쿠키만 내보낸 뒤 게시물 하나를 시뮬레이션하세요. 쿠키 파일을 저장소나 공개 위치에 두지 말고 필요 없어지면 세션을 삭제합니다.
쿠키 헤더를 문서, 로그, 이슈에 붙이지 않습니다.
허가 없이 인증된 콘텐츠를 공개하지 않습니다.
작업에 필요한 최소 인증 범위만 사용합니다.
제어
필터, 지연 시간과 책임 있는 경계 추가
Tumblr 아카이브는 원하는 내용을 명령에 표현할 때 관리하기 쉽습니다. 첫 샘플에는 범위를 사용하고, 메타데이터가 지원하면 날짜나 게시물 필터를 쓰며, 혼합 콘텐츠가 필요 없으면 유형 조건을 추가합니다. 일치 항목이 없는 필터는 고장처럼 보이므로 시뮬레이션으로 확인하세요.
짧은 지연, 적당한 범위, 중지 조건은 여러 전체 블로그 프로세스를 동시에 실행하는 것보다 안전합니다. Tumblr가 제한이나 일시 오류를 반환하면 멈추고 로그를 보관한 뒤 나중에 작은 범위와 느린 속도로 재시도하세요. 계정을 바꾸거나 공격적으로 요청해 차단을 우회하지 않습니다.
파일을 저장할 기술적 능력이 재게시 권한을 뜻하지는 않습니다. 작성자 조건, Tumblr 정책, 라이선스와 저작권을 확인하세요. 비공개 또는 민감한 자료를 공개 아카이브에 넣지 말고 출처가 필요하면 원본 URL을 기록합니다.
제어
도움
확인할 내용
작은 범위
첫 기록을 제한
예상 순서와 일치
게시물 유형
불필요한 내용 제외
시뮬레이션에서 일치
지연
접속 급증 완화
느린 실행도 실용적
아카이브
알려진 ID 건너뜀
안정적이고 백업됨
분리된 저장 위치
기존 자료 보호
테스트 폴더 삭제 가능
복구
Tumblr에서 흔한 오류 해결
명령을 바꾸기 전에 오류 종류를 분류하세요. 404나 빈 결과는 URL 복사 오류, 블로그 이동, 지원하지 않는 경로일 수 있습니다. 403이나 로그인 메시지는 접근, 동의, 쿠키 또는 정책 응답을 가리킵니다. 타임아웃이나 429는 속도, 네트워크 또는 일시 제한을 가리킵니다.
URL 문제라면 브라우저에서 페이지를 열어 정식 주소를 복사하고 `--simulate --verbose`로 게시물 하나를 테스트하세요. 접근 문제라면 공개 게시물과 인증 세션을 비교하고 필요할 때만 쿠키 도우미를 사용합니다. 제한 문제라면 멈추고 기다린 뒤 범위를 줄이고 병렬 작업을 피하세요. 파일 수가 예상과 다르면 아카이브를 삭제하기 전에 유형, 리블로그, 테마 리소스와 필터를 확인합니다.
도움을 요청할 때 원래 오류 문구를 보존하세요. gallery-dl 버전, 운영체제, 비밀을 제거한 명령, 비공개 토큰을 뺀 URL 형태, 공개 시뮬레이션 결과를 전달합니다. 쿠키 파일이나 비공개 미디어는 첨부하지 않습니다.
설정이나 인증 정보를 바꾸기 전에 URL, 접근, 제한 오류를 분리합니다.
빠른 진단 순서
URL 형태를 확인하고 게시물 하나를 테스트한 뒤 공개와 인증 접근을 비교하고 마지막으로 필터나 출력을 바꾸세요. 형식 오류를 복잡한 설정 실험으로 만들지 않는 순서입니다.
URL: 정식 경로, 블로그, 게시물 ID, 리디렉션.
접근: 공개 여부, 동의, 쿠키, 계정 범위.
대기: 403/429, 타임아웃, 지연과 재시도 시간.
출력: 저장 위치, 이름 필드, 아카이브와 중복 수.
질문
gallery-dl Tumblr FAQ
아래 답변은 반복 가능한 Tumblr 작업에 필요한 결정을 다룹니다. 플랫폼과 무관한 문제는 연결된 일반 가이드에서 더 자세히 확인할 수 있습니다.
자주 묻는 질문
gallery-dl Tumblr 질문
gallery-dl로 Tumblr 블로그 전체를 저장할 수 있나요?
지원되는 공개 블로그 URL을 처리할 수 있지만 먼저 시뮬레이션과 작은 범위를 사용하세요. 게시물 유형, 리블로그와 기록이 많을 수 있으므로 안정적인 저장 위치와 아카이브를 준비한 뒤 확장합니다.
Tumblr에서는 블로그 URL과 태그 URL 중 무엇을 쓰나요?
작성자나 컬렉션은 블로그, 주제 샘플은 태그, 한 항목 확인은 게시물을 사용하세요. 검색 URL은 결과가 바뀌므로 발견 단계에 적합합니다.
gallery-dl Tumblr 결과가 비어 있는 이유는 무엇인가요?
URL 형식, 공개 여부, 버전과 시뮬레이션 출력을 확인하세요. 잘못된 경로, 지원하지 않는 상태, 일치하지 않는 필터 또는 접근 요구가 원인일 수 있습니다.
Tumblr 다운로드에 쿠키가 필요한가요?
모든 공개 페이지에 필요한 것은 아닙니다. 공개 비교와 오류가 세션을 요구할 때만 사용하고 파일을 비공개로 보관하세요. 쿠키는 비공개 콘텐츠 권한을 주지 않습니다.
같은 Tumblr 게시물을 두 번 저장하지 않으려면?
안정적인 아카이브를 설정하고 작업과 함께 보관하세요. 폴더나 이름을 바꿀 때는 별도 테스트로 어떤 ID를 건너뛰는지 확인합니다.
Tumblr에서 429나 타임아웃이 발생하면?
작업을 멈추고 로그를 보관한 다음 기다린 뒤 범위를 줄이고 적절한 지연으로 다시 실행하세요. 병렬 재시도나 계정 변경으로 제한을 우회하지 않습니다.