subzeroid/insta-dl

# insta-dl [](https://pypi.org/project/instagram-dl/) [](https://pypi.org/project/instagram-dl/) [](LICENSE) [](https://github.com/subzeroid/insta-dl/actions/workflows/tests.yml) [](https://codecov.io/gh/subzeroid/insta-dl) [](https://subzeroid.github.io/insta-dl/) Instagram 的异步命令行下载器。支持下载个人主页、帖子、Reels、快拍、精选、话题标签和评论——保存到磁盘时保留原始时间戳。 ``` pip install instagram-dl # pip pipx install instagram-dl # or as an isolated CLI app export HIKERAPI_TOKEN=your_token insta-dl instagram ``` 或者无需安装 Python 直接运行： ``` docker run --rm -v "$PWD/out:/data" -e HIKERAPI_TOKEN \ ghcr.io/subzeroid/insta-dl:latest instagram ``` 在 [hikerapi.com](https://hikerapi.com/p/18j4ib4j) 获取免费的 HikerAPI token —— **前 100 次请求免费**，无需信用卡。一次请求 ≈ 一篇帖子或信息流的一页。 **insta-dl** - 下载 **个人主页、话题标签、单个帖子、Reels、快拍、精选和评论**， - 保留 **原始 `taken_at` 时间戳** 作为文件的 mtime，以便 Photos/Finder 正确排序， - 在每篇帖子旁边写入 **JSON 元数据附属文件**（说明文字、点赞数、位置、所有者）， - 支持 `--fast-update` 和 `--latest-stamps` 进行 **增量更新**， - 接受个人主页名称、`#话题标签`、帖子短代码以及完整的 `instagram.com` URL， - 提供 **两个可互换的后端**：付费商业 API（HikerAPI，无需 Instagram 会话，无封号风险）和开源私有 API 库（aiograpi，使用你自己的登录信息）。 ``` insta-dl [--backend hiker|aiograpi] [--dest DIR] [--fast-update] [--latest-stamps FILE] [--stories] [--highlights] [--comments] profile | "#hashtag" | post:SHORTCODE | https://instagram.com/... ``` 📖 **[完整文档](https://subzeroid.github.io/insta-dl/)** — 安装、CLI 参考、后端对比、Python API、故障排除。 ## 如何下载 Instagram 个人主页 ``` export HIKERAPI_TOKEN=$(cat ~/.config/hikerapi-token) insta-dl --dest ./out instagram ``` 这会抓取每一篇帖子，将文件命名为 `2026-04-21_16-04-15_DXZlTiKEpxw.mp4`，并在每个文件旁边写入元数据附属文件。 ## 如何保持本地归档同步 ``` insta-dl --fast-update --latest-stamps ./stamps.ini --dest ./out instagram ``` `--fast-update` 会在遇到第一个已存在于磁盘上的帖子时停止；`--latest-stamps` 会记录每个个人主页最新的 `taken_at`，这样即使本地副本被删除也能恢复下载。 ## 如何下载单个帖子或 Reels ``` insta-dl post:DXZlTiKEpxw insta-dl https://www.instagram.com/p/DXZlTiKEpxw/ insta-dl https://www.instagram.com/reel/DXZlTiKEpxw/ ``` ## 如何下载话题标签 ``` insta-dl '#sunset' --dest ./out ``` 将该标签的最近信息流拉取到 `./out/#sunset/`。 ## 如何抓取快拍和精选 ``` insta-dl --stories --highlights --dest ./out instagram ``` 快拍和精选会存放在 `//stories/` 和 `//highlights/_