gallery-dl：多站点图片画廊下载的命令行利器

大家好，我是贝克街的捉虫师呀！

作为一名常年和代码打交道的开发者，我发现我们日常工作中除了敲代码，还得处理各种各样的资源。比如，从一些图片分享站点下载素材，或者整理自己喜欢的画廊内容。你是不是也遇到过这样的情况：看到一个特别棒的图片合集，但是网站没有提供打包下载功能？又或者，不同网站下载下来的文件命名方式五花八门，整理起来简直要命？每次只能右键“另存为”，点到手软，最后电脑里还是一堆杂乱无章的图片。

我以前也经常被这些问题困扰，直到我找到了一个特别好用的工具，它简直就是为解决这些痛点而生的。今天，我就来给大家介绍一个GitHub上非常受欢迎的开源项目——gallery-dl。

项目概述

gallery-dl，顾名思义，它就是一个专门用来下载图片画廊和集合的命令行程序。你可以把它想象成一个“网络图片收藏家”的专属助手，或者更贴切地说，它就像你的数字内容“快递员”，能够帮你把散落在互联网上各种图片托管网站的精美图片，规规整整地送到你的本地硬盘上。它不是那种简单的网页截图工具，而是能深入解析网站结构，智能抓取图集内容的高级工具。

这个项目是一个完全开源的跨平台工具，核心由Python语言编写。它不仅提供了非常多的配置选项，还能支持高度灵活的文件命名规则，帮你自动整理下载好的文件，让你的数字收藏变得井井有条。

项目数据

gallery-dl 在 GitHub 上人气不低，目前已经累计收揽了14417颗星，而且今天也新增了14颗星，这足以说明它在开发者社区中的活跃度和受欢迎程度。项目的核心开发语言是 Python，这让它拥有了良好的跨平台特性和广泛的生态支持。

从其更新频率和依赖项列表来看，这个项目维护得相当活跃。Readme里提到了“Nightly Builds”和从GitHub直接安装最新开发版的方式，这都表明开发团队在持续地迭代和完善功能。它的依赖库包含了像 yt-dlp（一个强大的视频下载工具）、FFmpeg（用于多媒体处理）、PySocks（支持SOCKS代理）等，这些都暗示了 gallery-dl 不仅仅能处理图片，在多媒体内容下载和网络访问方面也有着强大的扩展能力。社区反馈也比较积极，不然不会有这么多的星标和持续的贡献者。

功能亮点

在使用 gallery-dl 的过程中，我体验到了一些非常实用的功能，这里给大家挑几个亮点聊聊：

💡 广泛的站点支持

gallery-dl 最大的亮点之一就是它支持非常多的图片托管网站。无论是常见的社交媒体、艺术社区，还是各种图站，它都有专门的“提取器”（extractor）来解析内容。这意味着你不再需要为每个网站寻找不同的下载工具，一个 gallery-dl 就能搞定大部分需求，省去了很多麻烦。我个人在下载一些特定艺术站点的作品集时，用它比浏览器插件稳定多了。

⚙️ 丰富的配置选项与命名规则

你下载下来的图片，是不是经常文件名乱七八糟？gallery-dl 在这方面做得特别好。它提供了非常细致的配置选项，你可以自定义下载路径、文件名格式，甚至可以根据图片自身的元数据（比如作者、标题、日期、标签等）来动态生成文件名和目录结构。这对于有强迫症、喜欢把文件整理得整整齐齐的朋友来说，简直是福音。你可以轻松实现“按作者分类、按日期归档”之类的复杂需求。

🔐 灵活多样的认证方式

很多网站为了防止恶意抓取，都要求登录才能查看或下载完整内容。gallery-dl 考虑到了这一点，支持多种登录认证方式，包括传统的用户名密码、从浏览器导入 Cookies，甚至还支持 OAuth 认证（比如针对 Pixiv、DeviantArt 等）。这大大提高了下载的成功率和便利性，尤其是在处理需要登录才能访问的私有内容时，显得尤为重要。

🚀 跨平台与多种安装方式

无论你是在 Windows、Linux 还是 macOS 系统上工作，gallery-dl 都能很好地运行。而且，它的安装方式也异常丰富：可以通过 pip 包管理器安装，有预编译的独立可执行文件，也支持 Snap、Chocolatey、Scoop、Homebrew、MacPorts 等主流的包管理器，甚至提供了 Docker 镜像。这意味着无论你的技术栈和使用习惯如何，都能找到适合自己的安装方式。

🎞️ 不仅仅是图片，还支持多媒体

虽然名字叫 gallery-dl，但它并不仅仅局限于图片下载。借助像 yt-dlp 这样的依赖，它也能很好地处理视频内容。特别是，它支持 Pixiv 的 Ugoira（动图）转换，如果你是 Pixiv 用户，这个功能会让你惊喜，可以将Ugoira直接转换为常见的视频格式，方便播放和管理。这让它成为一个更全面的数字内容下载工具。

📊 高级内容过滤与搜索

你可能只需要图集中的部分内容，或者想通过关键词搜索并下载。gallery-dl 提供了强大的过滤功能，比如你可以根据章节号、语言来过滤漫画内容，或者通过特定的标签来下载图片。它甚至支持从远程资源（如Pastebin）解析 URL 列表并批量下载，这在处理一些大型或者分散的资源列表时，非常高效。

安装与使用

gallery-dl 的安装过程是比较友好的，尤其是通过 Python 的包管理器 pip。

环境要求与前置条件：

你需要安装 Python 3.8 或更高版本。Requests 库是其核心依赖，一般通过 pip 安装 gallery-dl 时会自动安装。其他像 yt-dlp、FFmpeg 等是可选依赖，如果你需要处理视频或特殊格式，才需要额外安装它们。

分步骤安装指南：

最简单也是最推荐的安装方式是使用 pip：

# 确保你的 pip 和相关工具是最新的
python3 -m pip install --upgrade pip setuptools wheel

# 安装稳定版 gallery-dl
python3 -m pip install -U gallery-dl

# 如果你想尝试最新的开发版（不推荐在生产环境使用）
# python3 -m pip install -U --force-reinstall https://github.com/mikf/gallery-dl/archive/master.tar.gz

对于 Windows 用户，记得把 python3 换成 py -3。此外，如果不想安装 Python 环境，也可以直接下载其提供的独立可执行文件，对于日常使用来说非常方便。

基础配置与快速入门：

安装完成后，你就可以直接在命令行里使用 gallery-dl 命令了。它的基本用法非常直观：

# 下载指定 URL 的图片
gallery-dl "https://some-image-site.com/gallery/123"

# 从 Danbooru 下载标签为 'bonocho' 的图片
gallery-dl "https://danbooru.donmai.us/posts?tags=bonocho"

# 获取图片的直接下载链接，而不是下载文件本身（常用于调试）
gallery-dl -g "https://twitter.com/i/web/status/604341487988576256"

# 带有用户名和密码的认证下载示例
# 请注意，直接在命令行输入密码可能不安全，更推荐使用配置文件
gallery-dl -u "<username>" -p "<password>" "https://some-auth-required-site.com/gallery/abc"

# 过滤下载 Mangadex 上某部漫画的10到20章节，并且语言为法语的章节
gallery-dl --chapter-filter "10 <= chapter < 20" -o "lang=fr" "https://mangadex.org/title/59793dd0-a2d8-41a2-9758-8197287a8539"

gallery-dl 的配置通过 JSON 格式的文件进行，你可以在官方文档找到默认的 gallery-dl.conf 示例，里面包含了所有可配置的选项。通过配置文件，你可以设置默认的下载目录、文件名格式、代理、认证信息等，这样就不用每次都在命令行里输入一大串参数了。配置文件通常放在用户目录下的 .config/gallery-dl/config.json 或类似的路径。

常见问题提示：

如果你在使用过程中遇到下载失败或者缺少功能的情况，多半是以下原因：

缺少必要的依赖：比如下载视频时提示 yt-dlp 未安装，或者转换 Ugoira 时缺少 FFmpeg。可以根据提示进行安装。
网站结构变化：网站更新了，旧的提取器可能暂时失效。这种时候可以尝试更新 gallery-dl 到最新版本，或者等待项目更新。
认证问题：登录信息过期或者不正确。尝试更新 Cookies 或重新进行 OAuth 认证。

使用场景与推荐理由

gallery-dl 不仅仅是一个下载工具，它更像是一个“数字内容管家”，能够大大提升你获取和管理网络资源时的效率。

个人数字内容归档：如果你是一个数字内容的收藏爱好者，喜欢收集各种高清壁纸、漫画、插画或者特定的艺术作品集，gallery-dl 能帮你轻松地将这些内容从不同的网站批量下载到本地，并按照你设定的规则进行自动归档。比如，你可以设置下载 Pixiv 的作品时，自动创建以作者ID命名的文件夹，再在里面创建以作品ID命名的文件夹，文件名为作品标题，这样找起来就方便多了。
研究与素材收集：对于从事设计、内容创作、学术研究的开发者或爱好者来说，可能需要从特定的艺术社区、设计图库或者行业论坛批量收集视觉素材或数据。gallery-dl 能够帮助你高效地抓取这些公开或受限的内容，作为研究的样本或创作的灵感来源，省去了大量手动复制粘贴的时间。
自动化工作流集成：由于 gallery-dl 是一个命令行工具，它非常适合集成到各种自动化脚本或工作流中。你可以编写一个简单的 Python 脚本或者 Shell 脚本，定时运行 gallery-dl 来监控某些页面，一旦有新内容发布，就自动下载到你的服务器或 NAS 上。这对于需要持续更新特定内容的用户来说，是非常有用的。

推荐理由：