高效全平台命令行图片下载工具：gallery-dl从入门到精通

gallery-dl是一款功能强大的命令行图片下载工具，支持从数十个主流图像托管平台批量下载图片和相册。无论是社交媒体相册、艺术作品展示还是摄影分享站点，它都能帮助用户快速获取高质量媒体内容，是内容创作者、设计师和摄影爱好者的必备工具。

核心功能解析

如何用基础命令实现多平台图片批量下载？

要开始使用gallery-dl，只需掌握最基础的命令格式：gallery-dl [URL]。这个简洁的指令能自动识别目标平台并下载所有可获取的媒体文件。例如，下载一个Instagram用户的所有公开相册，只需执行：gallery-dl https://www.instagram.com/example_user/。该工具会自动处理分页加载，无需用户手动翻页，真正实现一键批量获取。

如何通过内置提取器支持80+平台？

gallery-dl的强大之处在于其丰富的平台支持，这得益于项目精心设计的提取器架构。在gallery_dl/extractor/目录下，每个平台都有专门的提取器模块（如instagram.py、pinterest.py），这些模块负责解析特定网站的页面结构和媒体链接。当检测到新的URL时，系统会自动匹配对应的提取器，确保在不同平台上都能高效工作。

🎯 无论是需要保存Twitter上的图片推文，还是下载DeviantArt上的插画集，gallery-dl都能提供一致的使用体验，无需为每个平台学习不同的操作方法。

高效使用指南

3步快速上手gallery-dl

第一步：安装工具
通过pip命令快速安装：pip install gallery-dl，或从源码安装：git clone https://gitcode.com/GitHub_Trending/ga/gallery-dl && cd gallery-dl && python setup.py install

第二步：基本下载操作
直接指定目标URL即可开始下载：gallery-dl https://www.pinterest.com/example_board/，文件会默认保存到当前目录的gallery-dl文件夹中。

第三步：查看帮助信息
通过gallery-dl --help获取完整命令选项，或查阅[docs/options.md]了解所有可用参数。

5个实用参数组合提升下载效率

参数组合	效果描述	适用场景
-d ~/Pictures	指定下载目录	整理不同平台的下载文件
-r 5	设置5秒请求间隔	避免对服务器造成压力
-i urls.txt	从文件读取多个URL	批量下载多个资源
--limit 20	限制下载数量	快速预览内容质量
--username user --password pass	提供账号认证	下载需要登录的私有内容

🛠️ 使用这些参数组合可以大幅提升下载效率，例如：gallery-dl -d ~/Instagram -r 3 https://www.instagram.com/example_user/将以3秒间隔下载内容到指定目录。

进阶配置技巧

如何通过配置文件实现自定义下载规则？

虽然gallery-dl支持命令行参数配置，但对于复杂需求，建议创建配置文件。在用户主目录下创建.gallery-dl.conf文件，即可定义默认下载路径、代理设置、文件名格式等高级选项。例如：

{
  "base-directory": "~/Downloads/Images",
  "filename-format": "{title}_{id}.{extension}",
  "extractor": {
    "instagram": {
      "include_videos": false
    }
  }
}

典型场景：定时备份Pinterest画板

结合系统定时任务工具（如cron），可以实现定期自动备份。编辑crontab：crontab -e，添加如下任务：

0 1 * * * gallery-dl -q https://www.pinterest.com/example_board/ >> ~/pinterest_backup.log 2>&1

这将每天凌晨1点自动备份指定画板，并记录日志。

📌 对于需要频繁下载的用户，还可以利用gallery_dl/job.py模块编写自定义下载任务脚本，实现更复杂的下载逻辑和错误处理机制。

通过掌握这些核心功能和高级技巧，gallery-dl能成为你日常工作流中高效的媒体获取工具。无论是内容备份、素材收集还是数据归档，它都能以命令行的简洁方式，提供强大而灵活的解决方案。