mikf/gallery-dl

项目介绍

gallery-dl 是一个 Python 命令行工具，用于从大量图片托管站点下载图片画廊和合集。每个站点由对应的「提取器」处理：用户传入页面或搜索链接，工具解析出帖子列表、抓取文件并保存到本地。它提供丰富的命令行选项、基于 JSON 的配置，以及通过格式化字符串控制文件命名的能力。

它适合想把画廊批量、可重复地归档到本地的用户：画师、资料整理者、研究者，以及备份自己帖子的用户。

快速使用

需要 Python 3.8+ 和 Requests 库。最直接的安装方式是通过 PyPI：

python -m pip install -U gallery-dl

Windows 用户应使用 py 代替 python。

安装后传入图库链接即可下载，例如按标签搜索 Danbooru：

gallery-dl "https://danbooru.donmai.us/posts?tags=bonocho"

文件会按默认命名规则写入当前目录。gallery-dl --help 可查看全部选项。若站点地址不规范，可在链接前加提取器名称强制指定，例如 tumblr:https://sometumblrblog.example。

登录与认证

需要登录或有可选登录的站点，可以通过 -u/-p、-o 或配置文件提供用户名和密码。无法用密码登录时，可通过配置文件中的 cookies 选项、--cookies 或 --cookies-from-browser 使用浏览器会话。部分站点（Pixiv、DeviantArt、Flickr、Reddit、Tumblr、Mastodon 等）支持 OAuth，例如运行 gallery-dl oauth:flickr 后按提示授权。

其他安装方式

提供 Windows 和 Linux 预编译可执行文件，也有 nightly 构建。Linux 可用 Snap 或 Homebrew，Windows 可用 Chocolatey 或 Scoop，macOS 可用 Homebrew 和 MacPorts。Docker 镜像发布在 Docker Hub 和 GitHub Container Registry；运行容器时应挂载配置文件和下载目录，以便持久化。

使用约束

• 依赖 Python 3.8+ 和 Requests；部分功能需要额外依赖，如 yt-dlp 用于 HLS/DASH 视频、FFmpeg 用于 Pixiv Ugoira 转换、PySocks 用于 SOCKS 代理、PyYAML/TOML 用于对应格式的配置。
• 配置文件查找路径因操作系统而异；多个配置文件会合并，后加载的文件覆盖先前的值。
• 站点存在速率限制和机器人检测；使用自己的账号抓取可能导致封禁。
• 下载内容可能与站点条款和版权冲突，使用后果由用户承担。
• 项目开发已迁移到 Codeberg，详见迁移公告。GitHub 仓库采用 GPL-2.0 许可证。

HotRepo 点评

HotRepo 数据中没有该仓库的 GitHub 日榜排名或 Star 增长快照。可用的观察来自历史 Hacker News 讨论：2020 年一条帖子获得 407 分、65 条评论，围绕下载器定位和可维护性展开，其中有人批评其模块化不足（讨论）。2026 年另一条帖子（201 分、61 条评论）讨论项目因 DMCA 通知迁出 GitHub，评论涉及版权与通知本身；FAKKU 的 CEO 在帖中表示通知由第三方代理未经批准发出（评论）。对读者而言，项目的实用信息是：它积累了长期使用记录和活跃社区，但当前开发已转向 Codeberg。