两种工具都是免费的命令行下载器,都能把你的 Instagram 帖子下载到本地磁盘。它们的区别在于登录方式、请求节奏以及获取的元数据多少。两者都无法把内容恢复回 Instagram。
简短结论
- Instaloader 专为 Instagram 设计。它可以下载公开和私密账号、话题标签、限时动态、动态流和已保存的媒体,以及评论、地理标签和说明文字,其文档称它适合作为定时任务运行,用于更新个人归档。
- gallery-dl 是通用下载器,支持多个图片托管网站的图库和合集。Instagram 只是其中之一,并通过 Cookie 登录。
如果你只需要 Instagram,Instaloader 更专注,也更合适。如果你已经在用 gallery-dl 下载其他网站,它也能覆盖 Instagram,功能列表同样很广。关于账号风险,我们找到的资料主要记录了 Instaloader 的行为,没有提供 gallery-dl 专属的封号证据,因此两者之间的风险比较只是推断。
不想维护脚本、会话文件或 Cookie?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 保存会话 Cookie,而非你的密码 | Cookies(cookies.txt,或从浏览器获取) |
| 匿名使用 | 公开账号无需登录即可使用 | 未说明:支持站点表将 Instagram 的认证方式列为“Cookies”,未提及匿名运行 |
| 请求节奏 | 自有速率控制器 | 默认 sleep-request 为 "6.0-12.0" 秒 |
| 增量更新 | --fast-update、--latest-stamps | archive 选项(默认关闭);skip 默认为 true |
| 额外元数据 | 每个帖子一个 JSON 文件,外加说明文字 txt 文件 | 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 格式,会在
~/.config/gallery-dl/config.json或%APPDATA%\gallery-dl\config.json等位置查找,依据项目 README。
登录与账号风险
**Instaloader 需要登录吗?**公开账号不需要。话题标签、位置、:stories、:feed、:saved,以及 --stories/--highlights/--comments/--geotags 都需要登录,而且要访问大部分私密账号的信息,你需要先关注该账号。
要登录,请传入 --login YOUR-USERNAME。保存到本地文件的是会话 Cookie,而不是你的密码(默认路径 ~/.config/instaloader/session-YOUR-USERNAME)。另外,--load-cookies BROWSER 可以从 Chrome、Firefox 或 Safari 等浏览器导入会话。不建议在命令行中使用 --password。
Instaloader 的文档提到,有用户在多个 issue 中报告登录问题。文档建议始终保留会话文件,因为存在会话文件时,--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,它会中止下载并保存恢复迭代器文件。
- 竞争厂商 instagrapi 称,如果激进抓取,登录状态下使用任一库都可能触发 challenge_required 或 feedback_required;并称匿名使用 Instaloader 不会有账号风险,因为并未登录任何账号。这只是厂商观点。该页面中的“任一库”指 Instaloader 和 instagrapi,不包括 gallery-dl。
- 另一家厂商博客称,像 Instaloader 这样的命令行下载器可能触发 Instagram 的自动化检测,后果从限速到账号受限不等,同时承认 Instaloader 用于归档自己的账号是合理的做法。
我们找到的资料中,没有任何一条提供 gallery-dl 专属的封号证据。因此我们的实用原则是一个推断,而非文档结论:任何登录或基于 Cookie 的运行都会将工具的行为与你的真实账号绑定,gallery-dl 的 Cookie 登录也不例外。
速率限制与 429 错误
Instaloader 保留自己的速率控制器。它假定自己是唯一的请求发起方,因此在短时间内频繁重启可能导致 429。当请求返回 429 时,它会在假定临时封禁已过期后重试一次。--max-connection-attempts 默认为 3,而 --abort-on=302,400,429 会让它在收到这些响应时直接停止。“短时间内查询过多”是提示通知,而非错误。
要避免 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 条目列出了头像、合集、粉丝、关注的用户、精选集、精选集封面、用户资料信息、照片、帖子、Reels、转发、已保存的帖子、限时动态、限时动态首页栏、标签搜索、被标记的帖子、用户主页。默认配置只包含“posts”,因此其他类型需要自行配置。
保持归档更新
Instaloader:--fast-update 会在遇到第一张已下载的图片时停止。--latest-stamps 会记录每个账号上次下载的时间,只获取更新的媒体,因此即使你移动或删除了已下载的媒体,仍能保持归档更新。
要将其设为定时任务,先用 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 为每个帖子保存一个 JSON 元数据文件(默认经过 xz 压缩)以及说明文字,gallery-dl 默认将文件保存到本地 ./gallery-dl/ 基础目录。它们的文档描述的是下载,而不是重新上传或重建账号。这是我们对其功能列表的理解,并非两个项目方的声明。之后你得到的是一个文件夹,需要自行存储、备份和整理。
何时更适合选择托管备份
在以下情况下,可以考虑托管工具:
- 你不想为真实账号交出会话 Cookie。Instaloader 获取限时动态和私密内容需要它,而 gallery-dl 也将其列为 Instagram 的认证方式。
- 你希望它每天自动运行,无需定时任务和会话文件,也不会因 Instagram 的变更而失效。
- 你需要的是比文件夹更接近“恢复”的功能。
SocialGuardian 只需要你的 @账号名,无需密码,无需登录。它会归档帖子、照片、视频、Reels、限时动态、说明文字和元数据,以及粉丝和关注列表和互动数据,每天自动备份,并且随时可以导出归档,没有锁定。三个步骤是:分享你的账号名、让它归档,然后一键下载或恢复。
把命令行留给实验,让托管备份保护最重要的账号。开始免费 30 天试用,无需 Instagram 密码