gallery-dl로 Instagram 사용하기

확인하려는 URL 유형을 먼저 정합니다. 일반 주소 표시줄에서 복사한 공개 게시물, 프로필 또는 미디어 URL을 사용하고, 짧은 링크, 추적 매개변수, 모바일 리디렉션, 비공개 메시지 링크는 처음 진단할 때 피하세요.

첫 명령은 보통 시뮬레이션이어야 합니다. 미디어를 쓰지 않고 설치, URL 인식, 접근, 파일 선택을 나눠 확인할 수 있습니다. 셸이 특수 문자를 해석하지 않도록 URL을 따옴표로 감싸세요.

gallery-dl --simulate "https://www.instagram.com/p/POST_ID/"

gallery-dl --simulate "https://www.instagram.com/USERNAME/"

gallery-dl -K "https://www.instagram.com/p/POST_ID/"

upstream 지원 사이트 목록에는 Instagram이 포함되어 있고 표시된 인증 방법에 Cookies가 있습니다. 이는 계획을 위한 참고 자료이지 모든 페이지, 계정, 지역 또는 URL 변형의 작동을 보장하지 않습니다. 실제 판단은 설치된 버전과 정확한 URL로 합니다.

공개 게시물 하나는 가장 작은 진단 단위입니다. 프로필, 릴스, 스토리, 개인화된 영역은 유효한 세션과 다른 접근 조건을 요구할 수 있으므로 정확한 URL을 시뮬레이션하세요.

Instagram이 익명 요청을 거부하면 직접 관리하는 브라우저 프로필에서 정상적으로 로그인하고, 같은 프로필로 대상 페이지가 열리는지 확인하세요. 그 다음 gallery-dl에 로컬 브라우저 프로필을 지정합니다. 쿠키 원문을 사이트나 공개 포럼에 붙여 넣을 필요는 없습니다.

쿠키 데이터베이스가 잠겨 있으면 브라우저를 완전히 닫고 활성 세션이 있는 프로필을 선택하세요. 만료된 세션, 추가 인증, 비공개 계정, 지역별 동작과 요청 규칙 변경도 별도의 원인일 수 있습니다.

gallery-dl --cookies-from-browser firefox --simulate "https://www.instagram.com/USERNAME/"

gallery-dl --cookies-from-browser chrome --simulate "https://www.instagram.com/USERNAME/"

gallery-dl --cookies-from-browser edge --simulate "https://www.instagram.com/USERNAME/"

시뮬레이션이 성공해도 첫 실제 실행은 작게 유지하세요. 프로필이나 컬렉션에는 --range를 사용하고, 예측 가능한 기본 폴더를 선택하며, 처음 생성되는 경로를 확인합니다. 영상, 중복 미디어 또는 의도하지 않은 범위를 저장량이 커지기 전에 발견할 수 있습니다.

반복 작업에는 안정적인 로컬 경로의 --download-archive를 추가하세요. 성공한 추출기 ID를 기록해 다음 실행에서 같은 항목을 건너뛰지만 미디어 백업은 아닙니다.

gallery-dl --range "1-10" --destination "D:/Media/Instagram" "https://www.instagram.com/USERNAME/"

gallery-dl --range "1-25" --download-archive "instagram.sqlite3" "https://www.instagram.com/USERNAME/"

gallery-dl -K --simulate "https://www.instagram.com/p/POST_ID/"

실험적인 값은 보기 쉽고 제거하기 쉬운 명령줄에 두세요. 기본 폴더, 파일 이름, 아카이브, 쿠키 선택과 요청 간격은 제한된 명령이 예상대로 작동한 뒤 검토한 설정으로 옮깁니다.

설정 파일은 일치하는 모든 요청에 영향을 줍니다. 추출기가 다른 메타데이터를 제공하면 복사한 필터가 아무것도 선택하지 않을 수 있습니다. -K로 필드를 확인하고 결과가 다르면 --config-ignore로 비교하세요.

{
  "extractor": {
    "base-directory": "D:/Media/Instagram",
    "archive": "D:/Media/Instagram/archive.sqlite3"
  }
}

gallery-dl --config-ignore --simulate "https://www.instagram.com/USERNAME/"

gallery-dl --config-status

Instagram 오류를 단순히 다른 플래그가 필요한 문제로 취급하지 마세요. 먼저 일반 브라우저에서 정확한 URL을 확인한 뒤 설정을 무시한 깨끗한 시뮬레이션을 실행합니다. 깨끗한 요청만 성공한다면 설정, 필터, 아카이브와 브라우저 프로필을 하나씩 확인하세요.

잠겼거나 만료된 쿠키 저장소는 요청 제한과 다릅니다. 제한 응답에는 시간과 적은 반복 요청이 필요하며 병렬 재시도 루프가 필요하지 않습니다. 빈 결과는 잘못된 URL, 접근할 수 없는 콘텐츠, 제한적인 필터 또는 이미 채워진 아카이브 때문일 수 있습니다.

gallery-dl은 로컬 다운로드 도구이지 권한 시스템이 아닙니다. 접근하고 사용할 권한이 있는 미디어만 다운로드하고 개인정보, 저작권, 플랫폼 약관, 계정 권한과 요청 제한을 존중하세요. 기술적으로 접근 가능하다는 사실은 재게시 허가가 아닙니다.

Instagram이 웹사이트나 요청 규칙을 바꾸면 버전에 민감한 추출기 동작도 바뀔 수 있습니다. 이 페이지는 2026년 8월 6일 공식 PyPI 메타데이터와 upstream 릴리스 파일을 확인했으며 gallery-dl 1.32.9를 검증했습니다. 동작이 바뀌면 공식 릴리스와 설치된 버전을 다시 확인하세요.

• 지원 범위는 공식 upstream 목록을 기준으로 삼기
• 첫 테스트는 공개·소량·시뮬레이션으로 진행하기
• 쿠키, 토큰, 비공개 아카이브와 정리하지 않은 로그를 공유하지 않기
• 실행 전 경로, 범위, 필터, 저장소와 권한 검토하기