两种工具都是免费的命令行下载器,都能把你的 Instagram 帖子下载到本地磁盘。它们的区别在于登录方式、请求节奏以及获取的元数据多少。两者都无法把内容恢复回 Instagram。

简短结论

如果你只需要 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

  1. 安装 Python 后,运行 pip3 install instaloader。
  2. 运行 instaloader profile [profile ...]。

这两步均出自Instaloader 官网首页。

gallery-dl

  1. 使用 python -m pip install -U gallery-dl 安装。它需要 Python 3.8+ 和 Requests(也提供独立可执行文件)。
  2. 使用你要下载的 URL 调用:gallery-dl [OPTIONS]... URLS...。
  3. 配置文件为 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 内容。

**两者会导致账号被封吗?**项目方没有公布封号率数据,因此我们不会编造数字。以下是有文档记载的信息:

我们找到的资料中,没有任何一条提供 gallery-dl 专属的封号证据。因此我们的实用原则是一个推断,而非文档结论:任何登录或基于 Cookie 的运行都会将工具的行为与你的真实账号绑定,gallery-dl 的 Cookie 登录也不例外。

速率限制与 429 错误

Instaloader 保留自己的速率控制器。它假定自己是唯一的请求发起方,因此在短时间内频繁重启可能导致 429。当请求返回 429 时,它会在假定临时封禁已过期后重试一次。--max-connection-attempts 默认为 3,而 --abort-on=302,400,429 会让它在收到这些响应时直接停止。“短时间内查询过多”是提示通知,而非错误。

要避免 Instaloader 出现 429:

  1. 一次只运行一个实例,并避免反复重启。
  2. 保留会话文件,避免重复登录。
  3. 如果你宁可停止也不愿重试,可以考虑使用 --abort-on。

gallery-dl 的做法更简单。其默认 Instagram 配置在请求之间休眠 6.0-12.0 秒,并设置通用的 sleep-429 为 60 秒,重试 4 次。

即便有节奏控制,一篇 WFDownloader 博客仍警告,一次排队大量 Instagram 账号可能会被封锁。

限时动态、精选集与其他内容

保持归档更新

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 密码

常见问题