sbstratos79/hydownloader

Hydrus 替代下载器 (基于 gallery-dl) Docker 镜像

镜像概述

本Docker镜像提供了一个基于gallery-dl的Hydrus替代下载器系统，旨在扩展Hydrus的媒体资源下载能力。通过集成gallery-dl的多网站支持特性，该镜像可作为Hydrus原生下载器的替代方案，支持从更多图片分享平台、漫画网站及社交媒体下载资源，提升Hydrus的媒体资源获取灵活性。

核心功能与特性

• Hydrus集成：无缝对接Hydrus媒体管理系统，作为替代下载器扩展其下载功能
• 多网站支持：基于gallery-dl实现，支持Pixiv、、ArtStation、、Instagram等数百个图片/媒体网站（完整支持列表见https://github.com/mikf/gallery-dl%EF%BC%89
• 配置灵活：支持自定义gallery-dl配置文件，可设置下载路径、文件命名规则、代理设置等
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低
• 容器化部署：简化部署流程，支持Docker Compose集成，便于与Hydrus服务联动

使用场景与适用范围

• Hydrus用户扩展下载能力：当Hydrus原生下载器不支持特定网站时，作为替代方案使用
• 多平台资源批量下载：需要从多个不同网站批量获取媒体资源并导入Hydrus管理
• 自定义下载规则需求：需要根据文件类型、尺寸、发布时间等条件筛选下载内容
• 自动化媒体采集：结合定时任务实现周期性资源同步与更新

使用方法

前置要求

• 已部署Hydrus服务，并获取API访问密钥（在Hydrus客户端「服务」→「管理API访问」中生成）
• Docker环境（20.10+版本）或Docker Compose（2.0+版本）

Docker Run 命令示例

bash
docker run -d \
  --name hydrus-gallerydl-downloader \
  -e HYDRUS_URL="http://hydrus-server:45869" \
  -e HYDRUS_API_KEY="your_hydrus_api_key" \
  -v /path/to/gallery-dl/config:/app/config \
  -v /path/to/downloads:/app/downloads \
  --restart unless-stopped \
  hydrus-gallerydl-downloader:latest

Docker Compose 配置示例

yaml
version: '3.8'

services:
  hydrus-downloader:
    image: hydrus-gallerydl-downloader:latest
    container_name: hydrus-gallerydl-downloader
    environment:
      - HYDRUS_URL=http://hydrus-server:45869  # Hydrus服务地址（需与Hydrus配置一致）
      - HYDRUS_API_KEY=your_hydrus_api_key     # Hydrus API密钥
      - LOG_LEVEL=info                         # 日志级别：debug/info/warn/error
    volumes:
      - ./gallery-dl/config:/app/config        # 挂载gallery-dl配置文件目录
      - ./downloads:/app/downloads             # 挂载下载文件存储目录（需与Hydrus库路径对应）
    restart: unless-stopped
    depends_on:
      - hydrus-server  # 若Hydrus也在容器中运行，需添加依赖关系

配置参数说明

环境变量

挂载目录

gallery-dl配置文件

默认配置文件路径：/app/config/config.json，可通过挂载自定义配置。配置示例（支持网站登录、代理等）：

json
{
  "extractor": {
    "base-directory": "/app/downloads",
    "filename": "{title}_{id}.{extension}",
    "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36",
    "pixiv": {
      "username": "your_pixiv_username",
      "password": "your_pixiv_password"
    },
    "proxy": "http://proxy-server:8080"
  }
}

注意事项

1. 确保Hydrus服务与下载器在同一网络环境，或配置正确的HYDRUS_URL（需为公网可访问地址）
2. 下载目录需与Hydrus的媒体库路径一致，或通过Hydrus的「导入文件夹」功能监控此目录
3. 首次运行前建议测试配置：执行docker exec -it hydrus-gallerydl-downloader gallery-dl --version验证gallery-dl可用性

相关链接

• https://hydrusnetwork.github.io/hydrus/
• https://github.com/mikf/gallery-dl
• https://github.com/mikf/gallery-dl/blob/master/docs/supportedsites.md