두 도구 모두 무료 명령줄 다운로더이며, Instagram 게시물을 디스크로 내려받을 수 있습니다. 로그인 방식, 요청 간격을 조절하는 방식, 가져오는 메타데이터의 양에서 차이가 있습니다. 어느 쪽도 Instagram에 아무것도 되돌려 복원하지 않습니다.
간단 요약
- Instaloader는 Instagram에 맞춰 만들어졌습니다. 공개 및 비공개 프로필, 해시태그, 스토리, 피드, 저장된 미디어를 댓글, 지오태그, 캡션과 함께 다운로드할 수 있으며, 공식 문서에 따르면 개인 아카이브를 업데이트하기 위해 cronjob으로 실행하기에 적합합니다.
- gallery-dl은 여러 이미지 호스팅 사이트의 이미지 갤러리와 컬렉션을 다루는 범용 다운로더입니다. Instagram은 지원 사이트 중 하나이며 쿠키로 로그인합니다.
Instagram만 필요하다면 Instaloader가 더 집중된 선택입니다. 이미 다른 사이트에서 gallery-dl을 쓰고 있다면 Instagram도 폭넓은 기능 목록으로 지원합니다. 계정 위험에 대해서는 저희가 확인한 자료가 주로 Instaloader의 동작만 문서화하고 gallery-dl에 대한 차단 근거는 제시하지 않으므로, 두 도구의 위험을 비교한 내용은 추론입니다.
스크립트, 세션 파일, 쿠키를 직접 관리하고 싶지 않으신가요? SocialGuardian은 공개 @핸들만 필요합니다. 비밀번호도 로그인도 필요 없습니다. 30일 무료 체험 시작
항목별 비교
| Instaloader | gallery-dl | |
|---|---|---|
| 설치 | pip3 install instaloader; MIT 라이선스 | python -m pip install -U gallery-dl, 독립 실행 파일, Snap, Chocolatey, Scoop, Homebrew, MacPorts, Docker, Nix도 제공; GPL-2.0 |
| 기본 명령 | instaloader profile [profile ...] | gallery-dl [OPTIONS]... URLS... |
| 로그인 방식 | --login USERNAME은 비밀번호가 아니라 세션 쿠키를 저장합니다 | 쿠키 (cookies.txt 파일 또는 브라우저에서 가져오기) |
| 익명 사용 | 공개 프로필은 로그인 없이 사용할 수 있습니다 | 명시되어 있지 않습니다. 지원 사이트 표는 Instagram 인증 방식을 "Cookies"로 적고 있으며 익명 실행에 대해서는 언급하지 않습니다 |
| 요청 간격 | 자체 속도 제어기 | 기본값은 요청 사이 6.0-12.0초 대기(sleep-request) |
| 증분 업데이트 | --fast-update, --latest-stamps | archive 옵션(기본값 꺼짐); skip 기본값은 true |
| 추가 메타데이터 | 게시물마다 JSON 파일과 캡션 텍스트 파일 | metadata 기본값은 false (선택 사용) |
설치 및 첫 실행
Instaloader
- Python이 설치되어 있다면
pip3 install instaloader를 실행합니다. instaloader profile [profile ...]를 실행합니다.
두 단계는 Instaloader 홈페이지에서 확인한 내용입니다.
gallery-dl
python -m pip install -U gallery-dl로 설치합니다. Python 3.8 이상과 Requests가 필요합니다 (독립 실행 파일도 제공됩니다).- 원하는 URL을 넣어 실행합니다:
gallery-dl [OPTIONS]... URLS.... - 설정은 JSON 파일이며, 프로젝트 README에 따라
~/.config/gallery-dl/config.json또는%APPDATA%\gallery-dl\config.json같은 위치에서 찾습니다.
로그인과 계정 위험
Instaloader는 로그인이 필요한가요? 공개 프로필은 필요하지 않습니다. 해시태그, 위치, :stories, :feed, :saved, 그리고 --stories/--highlights/--comments/--geotags 옵션은 로그인이 필요하며, 비공개 계정의 대부분 정보를 보려면 해당 계정을 팔로우해야 합니다.
로그인하려면 --login YOUR-USERNAME을 사용합니다. 비밀번호가 아니라 세션 쿠키가 로컬 파일에 저장됩니다 (기본 경로 ~/.config/instaloader/session-YOUR-USERNAME). 또는 --load-cookies BROWSER로 Chrome, Firefox, Safari 같은 브라우저의 세션을 가져올 수 있습니다. 명령줄에 --password를 넣는 방식은 권장되지 않습니다.
Instaloader 문서에는 여러 이슈에서 사용자들이 로그인 문제를 겪었다는 내용이 있습니다. 세션 파일이 있으면 --login이 실패하기 쉬운 로그인 절차를 건너뛰므로, 세션 파일을 항상 보관하라고 권장합니다.
gallery-dl은 로그인이 필요한가요? 지원 사이트 표는 Instagram의 인증 방식을 Cookies로 적고 있습니다. README에는 두 가지 방법이 나옵니다. extractor.instagram.cookies에 cookies.txt 경로를 지정하거나, gallery-dl --cookies-from-browser firefox "URL"을 실행하는 방식입니다. 저희가 확인한 자료에는 gallery-dl이 Instagram을 익명으로 가져올 수 있는지 나와 있지 않습니다.
두 도구 중 하나로 계정이 차단될 수 있나요? 두 프로젝트 모두 차단 비율을 공개하지 않으므로, 저희가 수치를 만들어 말씀드리지는 않겠습니다. 문서로 확인되는 내용은 다음과 같습니다.
- Instaloader는 자신이 독립적인 비공식 프로젝트이며 사용자 책임 하에 사용해야 한다고 밝히고 있습니다.
- Instaloader 4.15는 안전장치를 추가했습니다. 요청에 feedback_required, checkpoint_required 또는 challenge_required 응답이 오면, 다운로드를 중단하고 재개용 iterator 파일을 저장합니다.
- 경쟁 업체인 instagrapi는 공격적으로 스크래핑하면 로그인 상태에서 두 라이브러리 모두 challenge_required 또는 feedback_required에 걸릴 수 있다고 말하며, 로그인하지 않은 익명 Instaloader 사용은 로그인된 계정이 없으므로 계정 위험이 없다고 설명합니다. 이는 업체의 의견으로 보아야 합니다. 여기서 "두 라이브러리"는 Instaloader와 instagrapi를 뜻하며 gallery-dl은 포함하지 않습니다.
- 다른 업체 블로그는 Instaloader 같은 CLI 다운로더가 Instagram의 자동화 탐지를 유발할 수 있다며, 속도 제한부터 계정 제한까지 결과가 다양할 수 있다고 말합니다. 동시에 자신의 계정을 아카이빙하는 용도로는 Instaloader가 합리적인 방법이라고 인정합니다.
저희가 확인한 어떤 자료도 gallery-dl의 차단에 대한 근거를 제시하지 않습니다. 따라서 저희의 실무 원칙은 문서화된 결과가 아니라 추론입니다. 로그인 상태나 쿠키를 사용하는 실행은 도구의 동작을 실제 계정과 연결하며, 여기에는 gallery-dl의 쿠키 로그인도 포함됩니다.
요청 속도 제한과 429 오류
Instaloader는 자체 속도 제어기를 사용합니다. 자신이 요청의 유일한 사용자라고 가정하므로, 짧은 시간 안에 자주 재시작하면 429가 발생하기 쉽습니다. 429 응답을 받으면 일시적 차단이 풀렸다고 보고 한 번 재시도합니다. --max-connection-attempts의 기본값은 3이며, --abort-on=302,400,429를 사용하면 재시도 대신 해당 응답에서 중단합니다. "Too many queries in the last time"은 오류가 아니라 안내 메시지입니다.
Instaloader에서 429를 피하려면 다음과 같이 합니다.
- 한 번에 하나의 인스턴스만 실행하고, 반복해서 재시작하지 않습니다.
- 세션 파일을 보관해 로그인을 반복하지 않도록 합니다.
- 재시도보다 중단을 선호한다면
--abort-on을 고려합니다.
gallery-dl은 더 단순한 방식을 사용합니다. 기본 Instagram 설정은 요청 사이에 6.0-12.0초를 대기하며, 일반 설정으로 sleep-429는 60초, 재시도는 4회입니다.
속도 조절을 해도, 한 WFDownloader 블로그는 많은 Instagram 계정 목록을 한꺼번에 대기열에 넣으면 차단될 수 있다고 경고합니다.
스토리, 하이라이트 및 기타 콘텐츠
- Instaloader: 스토리, 하이라이트, 댓글, 지오태그는 모두 로그인과 명시적인 플래그가 필요합니다. --stories, --highlights, --comments, --geotags는 로그인이 필요하므로, 로그인 없는 일반
instaloader profile실행에는 포함되지 않습니다. 저장된 미디어, 피드, 해시태그도 로그인이 필요합니다. Instaloader 홈페이지는 다운로드할 수 있는 항목으로 각 게시물의 댓글, 지오태그, 캡션을 나열합니다. - gallery-dl: Instagram 항목은 아바타, 컬렉션, 팔로워, 팔로우한 사용자, 하이라이트, 하이라이트 커버, 사용자 프로필 정보, 사진, 게시물, 릴스, 리포스트, 저장된 게시물, 스토리, 스토리 홈 트레이, 태그 검색, 태그된 게시물, 사용자 프로필을 나열합니다. 기본 설정은 "posts"만 포함하므로, 다른 유형은 설정을 추가해야 합니다.
아카이브 최신 상태 유지
Instaloader: --fast-update는 이미 다운로드된 첫 사진에서 멈춥니다. --latest-stamps는 각 프로필을 마지막으로 다운로드한 시간을 저장하고 더 새로운 미디어만 가져옵니다. 따라서 다운로드한 미디어를 옮기거나 삭제해도 아카이브를 계속 업데이트할 수 있습니다.
cronjob으로 예약하려면 instaloader --login=your_username으로 세션을 만든 뒤, instaloader --login=your_username --quiet target을 실행합니다. 종료 코드 4는 치명적인 다운로드 오류, 3은 로그인 오류, 1은 치명적이지 않은 오류를 뜻합니다.
gallery-dl: archive 옵션은 기본적으로 null이므로, 이미 다운로드한 파일을 건너뛰려면 아카이브 파일을 지정해야 합니다. skip의 기본값은 true입니다.
Instaloader는 유지보수도 필요합니다. 릴리스 기록을 보면 Instagram 변경에 맞춘 수정이 반복되었습니다. v4.15.1은 새로운 GraphQL 엔드포인트로 옮겨갔고, v4.16은 로그인 여부와 관계없이 Profile.get_posts()를 고쳤습니다.
두 백업 중 하나에서 복원할 수 있나요?
Instagram으로 복원할 수는 없습니다. Instaloader는 기본적으로 xz로 압축된 게시물별 JSON 메타데이터 파일과 캡션을 저장하고, gallery-dl은 기본적으로 로컬 ./gallery-dl/ 기본 디렉터리에 파일을 저장합니다. 두 도구의 문서는 다운로드를 설명할 뿐, 다시 업로드하거나 계정을 재구성하는 기능은 설명하지 않습니다. 이는 기능 목록을 저희가 해석한 것이며, 두 프로젝트의 공식 설명은 아닙니다. 실행 후 남는 것은 직접 저장하고, 백업하고, 정리해야 하는 파일 폴더입니다.
관리형 백업이 더 안전한 경우
다음과 같은 경우에는 관리형 도구를 고려하세요.
- 실제 계정의 세션 쿠키를 넘기고 싶지 않은 경우입니다. Instaloader는 스토리와 비공개 콘텐츠에 세션이 필요하고, gallery-dl은 Instagram 인증 방식으로 쿠키를 나열합니다.
- cron 작업, 세션 파일, 또는 Instagram 변경 후의 오류 없이 매일 자동으로 실행되기를 원하는 경우입니다.
- 파일 폴더보다 복원에 가까운 기능이 필요한 경우입니다.
SocialGuardian은 @핸들만 요구합니다. 비밀번호도, 로그인도 필요 없습니다. 게시물, 사진, 동영상, 릴스, 스토리, 캡션, 메타데이터와 팔로워 및 팔로잉 목록, 참여 데이터를 보관하며, 매일 자동으로 백업이 실행되고 언제든 잠금 없이 내보낼 수 있는 아카이브를 제공합니다. 과정은 세 단계입니다. 핸들을 공유하고, 아카이빙을 맡기고, 한 번의 클릭으로 다운로드하거나 복원합니다.
실험은 명령줄에서 하고, 중요한 계정은 관리형 백업으로 보호하세요. 30일 무료 체험 시작 - 비밀번호 불필요