모든 항목이 다시 다운로드됨
옵션, 절대 경로, 운영체제 계정, 예약 작업의 작업 디렉터리를 확인하세요. 두 번째 실행이 첫 번째와 같은 파일을 사용하는지 확인합니다.
- 전체 명령 비교
- 읽기 및 쓰기 권한 확인
- 임시 파일이 아카이브를 대체하지 않았는지 확인
gallery-dl 다운로드 아카이브: 반복 다운로드 방지
gallery-dl 다운로드 아카이브는 반복 작업이 확인할 수 있는 지속적인 기록을 보관합니다. 이 글에서 “gallery-dl 다운로드 아카이브”는 다음 실행이 참조하는 로컬 기록 파일을 뜻합니다. 같은 경로를 사용하면 이미 알려진 항목은 건너뛰고 새로 처리할 항목을 받을 수 있습니다. 이 안내에서는 안전한 명령, 적용 범위, 관리 방법과 문제 해결 순서를 설명합니다.
gallery-dl 다운로드 아카이브는 --download-archive FILE에 안정적인 경로를 지정해 사용합니다. 이후 실행에서도 같은 경로를 전달하세요. 지원되는 URL 하나와 작은 범위로 시험해 파일이 읽히고 갱신되는지 확인한 뒤 별도 백업을 보관합니다. 이 파일은 다운로드 처리 기록일 뿐 미디어 사본이나 파일 무결성 검사는 아닙니다.
기록의 역할 이해하기
gallery-dl 다운로드 아카이브가 하는 일
“gallery-dl 다운로드 아카이브”를 설정할 때는 --download-archive 옵션으로 로컬 파일을 연결합니다. 명령줄 옵션 문서에 따르면 처리한 항목을 기록하고 이미 아카이브에 있는 항목은 건너뜁니다. 같은 파일을 재사용하면 이후 프로필, 갤러리 또는 예약 작업이 모든 항목을 새것으로 취급하는 대신 이전 기록을 확인할 수 있습니다.
아카이브는 다운로더의 처리 기록이지 미디어, 저장 위치 목록 또는 체크섬이 아닙니다. 삭제한 파일을 복원하거나 파일이 여전히 열리는지 확인하지 못합니다. 파일 이름 템플릿은 새 파일의 이름만 정하므로 아카이브를 대체하지 않으며, 서로 다른 URL의 이미지 데이터를 비교하지도 않습니다.
- 다음 실행에서도 같은 아카이브 파일에 접근할 수 있어야 합니다.
- 다운로드한 미디어와 별도로 아카이브를 백업하세요.
- 항목이 기록되어 있다는 사실만으로 로컬 파일의 존재나 무결성이 보장되지는 않습니다.
파일 위치를 한 번 정하기
아카이브 파일의 안정적인 경로 선택
gallery-dl을 실행하는 계정과 컴퓨터에서 계속 사용할 수 있는 위치를 고르세요. 예약 작업에서는 상대 경로가 작업 디렉터리에 따라 달라지므로 절대 경로가 확인하기 쉽습니다. 자주 이름을 바꾸거나 정리하거나 교체하는 폴더는 피하세요.
작업을 설명하는 파일 이름을 정하고 명령과 함께 경로를 기록하세요. 내부 형식을 추측해 파일 이름을 바꾸거나 편집하지 마세요. 작업을 옮길 때는 파일을 의도적으로 복사하고 새 명령이 그 복사본을 가리키게 합니다.
macOS 또는 Linux 예시
gallery-dl --download-archive "$HOME/.local/share/gallery-dl/archives/creator-a.archive" "URL"Windows 예시
gallery-dl --download-archive "C:\Users\you\AppData\Local\gallery-dl\archives\creator-a.archive" "URL"경로도 작업 설정의 일부입니다
반복 작업의 컴퓨터, 셸 또는 예약 설정이 바뀌면 기록이 함께 이동했다고 가정하지 말고 실제 아카이브 경로를 다시 확인하세요.
반복 흐름 테스트
첫 실행과 다음 실행을 시험하기
접근 권한이 있는 지원 URL을 사용하세요. 익숙하지 않은 URL이라면 먼저 아카이브 없이 시뮬레이션합니다. 다음으로 전용 아카이브 경로와 제한된 범위를 사용해 소량을 실제로 처리하고 저장 위치와 반복 실행 동작을 확인하세요.
같은 URL과 범위, 같은 아카이브 경로로 다시 실행합니다. 기록된 항목은 건너뛰어야 합니다. 테스트 결과를 이해한 뒤 더 많은 항목을 처리하려는 경우에만 범위 제한을 제거하세요. 예약 작업이라면 검증한 옵션과 경로를 명령과 함께 저장하고 실행 환경도 기록합니다.
- 두 테스트 실행에서 같은 아카이브 파일을 사용하세요.
- 첫 결과를 이해하기 전에는 범위를 늘리지 마세요.
- 테스트가 끝난 뒤 더 많은 항목을 처리할 때만 범위를 제거하세요.
작은 범위로 시작하기
gallery-dl --range "1-5" --download-archive "$HOME/.local/share/gallery-dl/archives/creator-a.archive" "URL"같은 테스트 반복하기
gallery-dl --range "1-5" --download-archive "$HOME/.local/share/gallery-dl/archives/creator-a.archive" "URL"
사용 범위 정하기
어떤 작업이 아카이브를 공유할지 결정하기
반복해서 확인하는 프로필이나 컬렉션은 안정적인 아카이브 경로 하나로 관리하면 파악하기 쉽습니다. 담당자, 저장 위치 또는 일정이 다르면 파일을 분리하는 편이 문제를 찾기 쉽습니다. 여러 URL 유형을 하나의 흐름으로 관리하려는 의도가 있고 함께 테스트한 경우에만 공유하세요.
아카이브가 실행 대상 자체를 선택하지는 않습니다. 범위, 날짜 필터 또는 추출기 설정이 대상 항목을 정하고 아카이브는 그 처리에 기록을 제공합니다. 작업이 일찍 끝나거나 순서가 달라지면 항목 제외 기준을 추가하기 전에 선택 설정과 아카이브 동작을 모두 확인하세요.
| 작업 패턴 | 실용적인 아카이브 선택 | 확인할 내용 |
|---|---|---|
| 같은 프로필을 반복 확인 | 해당 작업에 안정적인 경로 하나 사용 | 예약 명령도 같은 경로를 찾는지 확인 |
| 서로 다른 제작자나 저장 위치 | 이름이 분명한 별도 파일 사용 | 각 명령이 의도한 파일을 가리키는지 확인 |
| 의도적으로 합친 하나의 컬렉션 | 작은 테스트 뒤에만 공유 | URL 유형과 기록이 기대대로 동작하는지 확인 |
기대 범위 정하기
아카이브로 알 수 없는 것
다운로드 아카이브는 바이트 단위로 중복 파일을 찾는 도구가 아닙니다. 서로 다른 URL의 같은 미디어를 합치거나 변경된 파일 내용을 감지한다고 가정하지 마세요. 콘텐츠 비교가 필요하면 별도의 로컬 파일 관리 절차를 사용하세요.
미디어 파일을 옮기거나 삭제한 뒤에도 기록은 남을 수 있으므로 아카이브로 해당 파일을 복구할 수 없습니다. 기록을 초기화하기 전 복사본을 보관하세요. 계속 바뀌는 컬렉션이라면 범위 또는 날짜 필터가 여전히 원하는 항목을 선택하는지도 확인해야 합니다.
필터를 바꾸기 전에 지원 URL 확인
gallery-dl --config-ignore --simulate "URL"명령 옵션 확인
gallery-dl --help
기록 보존하기
아카이브 백업과 이전을 신중하게 하기
어떤 작업이 사용하는 파일인지 메모를 붙여 미디어 저장 위치와 별도로 아카이브를 백업하세요. 작업을 옮기기 전 파일을 복사하고 새 명령이 그 복사본을 사용하도록 합니다. 전체 작업을 예약하기 전에 권한이 있는 소규모 테스트로 새 경로를 확인할 수 있습니다.
작업을 재설정할 때는 새 설정이 작은 테스트를 통과할 때까지 이전 기록을 보관하세요. 다른 컴퓨터에 있는 두 아카이브 사본이 자동으로 동기화된다고 가정하지 말고, 형식을 확인하지 않은 파일을 편집하지 마세요.
- 임시 다운로드 폴더나 정리 대상 폴더 밖에 보관하세요.
- 작업, URL 유형, 아카이브 경로, 테스트한 명령을 함께 기록하세요.
- 컴퓨터를 바꾸거나 기록을 의도적으로 초기화하기 전에 파일을 복사하세요.
- 복원하거나 옮긴 파일은 권한이 있는 작은 실행으로 시험하세요.
입력과 설정 확인
같은 항목이 다시 다운로드될 때
항목이 다시 다운로드되면 실제로 실행된 명령을 확인하세요. --download-archive 옵션이 있는지, 경로가 일치하는지, 프로세스가 파일에 접근할 수 있는지 살펴봅니다. 예약 작업은 다른 계정이나 작업 디렉터리를 사용할 수 있으므로 테스트한 명령의 환경과 비교하세요.
그다음 URL, 범위, 필터, 설정을 비교합니다. 권한이 있는 URL 하나씩 확인하고 아카이브 경로가 불확실한 동안 대량 실행은 피하세요. 예상한 항목이 건너뛰어지면 먼저 선택 설정을 점검하고, 무엇이든 초기화하기 전에 복사본을 보관하세요.
예상한 항목이 계속 건너뛰어짐
아카이브를 변경하기 전에 선택한 URL, 범위, 필터를 확인하세요. 새 상태를 확인해야 한다면 복사본을 보관하고 별도의 테스트 아카이브를 사용합니다.
- 현재 명령 옵션 확인
- 권한이 있는 URL 하나 테스트
- 형식을 모르는 아카이브 파일을 편집하지 않기
반복 가능한 절차
신뢰할 수 있는 gallery-dl 아카이브 사용 절차
지원되는 URL, 검토한 명령, 예측 가능한 저장 위치, 작업과 함께 유지되는 아카이브 경로를 사용하세요. 작은 범위로 시험하고 같은 명령을 다시 실행한 뒤 아카이브 동작을 이해했을 때만 범위를 넓힙니다. 기록은 미디어와 별도로 백업하세요. 결과가 달라지면 초기화하기 전에 경로, URL, 범위, 필터, 설정을 비교합니다.
자주 묻는 질문
gallery-dl 다운로드 아카이브 FAQ
gallery-dl이 같은 항목을 다시 다운로드하지 않게 하려면?
--download-archive에 안정적인 로컬 파일 경로를 지정하고 이후 실행에서도 같은 경로를 전달하세요. 먼저 작은 테스트를 하고 다음 실행이 해당 파일을 확인하는지 살펴봅니다.
아카이브 파일에 어떤 경로를 사용해야 하나요?
gallery-dl 계정과 작업에서 계속 접근할 수 있는 위치를 고르세요. 예약 작업에서는 작업 디렉터리에 따라 달라지는 상대 경로보다 절대 경로가 확인하기 쉽습니다.
다운로드 아카이브에 내가 받은 이미지가 들어 있나요?
아니요. 반복 실행에서 사용하는 기록이며 미디어 저장 위치와 별개입니다. 백업이나 파일 무결성 검사는 아닙니다.
여러 URL에 아카이브 하나를 사용할 수 있나요?
작업이 기록을 공유하도록 정했고 구체적인 URL 유형을 함께 시험한 경우에만 사용하세요. 담당자, 저장 위치 또는 일정이 다르면 파일을 나누는 편이 문제를 확인하기 쉽습니다.
아카이브를 사용해도 항목이 다시 다운로드되는 이유는 무엇인가요?
옵션이 포함되어 있고 실행이 같은 접근 가능한 파일을 사용하는지 확인하세요. URL, 범위, 필터, 계정, 예약 작업의 작업 디렉터리를 비교합니다.
기록된 항목을 일부러 다시 다운로드하려면 어떻게 하나요?
현재 아카이브를 보관하고 별도의 테스트 아카이브나 최신 공식 문서에서 확인한 의도적인 방법을 사용하세요. 형식을 확인하지 않은 파일은 편집하지 마세요.
공식 자료
다음 단계