toMedia
进阶用法

代理与网络

gallery-dl 的代理和网络配置

🌐 代理与网络

设置代理

# 命令行指定代理
gallery-dl --proxy "http://127.0.0.1:7890" "URL"

# SOCKS5 代理
gallery-dl --proxy "socks5h://127.0.0.1:1080" "URL"

配置文件方式:

{
  "extractor": {
    "proxy": "http://127.0.0.1:7890"
  }
}

按网站设置不同代理

{
  "extractor": {
    "proxy": null,
    "twitter": {
      "proxy": "http://127.0.0.1:7890"
    },
    "instagram": {
      "proxy": "http://127.0.0.1:7890"
    },
    "weibo": {
      "proxy": null
    }
  }
}

速率限制

{
  "extractor": {
    "sleep": [1.0, 3.0],
    "sleep-request": [0.5, 1.5]
  },
  "downloader": {
    "rate": "2M"
  }
}

命令行方式:

# 限速 2MB/s
gallery-dl --rate-limit "2M" "URL"

重试设置

{
  "downloader": {
    "retries": 5,
    "timeout": 60.0
  },
  "extractor": {
    "retries": 3
  }
}

自定义 User-Agent

{
  "extractor": {
    "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:130.0) Gecko/20100101 Firefox/130.0"
  }
}

自定义 Headers

{
  "extractor": {
    "twitter": {
      "headers": {
        "Accept-Language": "en-US,en;q=0.9"
      }
    }
  }
}

对于需要翻墙访问的网站(Twitter、Instagram 等),建议在配置文件中统一设置代理,避免每次输入。

On this page