Python に yt-dlp を組み込むときのプロキシオプション設定

組み込まれた yt-dlp クライアントは、YoutubeDL に渡されたオプションからプロキシを読み取ります:

import yt_dlp

options = {
    'proxy': 'socks5://proxy.example:1080',
}
with yt_dlp.YoutubeDL(options) as ydl:
    pass

SOCKS5 プロキシ一覧の候補を使って、示された SOCKS5 URL のエンドポイントを用意できます。クライアントのコンテキスト内で pass をアプリケーションが意図する処理に置き換えてください。その処理は実際のメディア URL を宛先として保持します。

プロキシオプションは HTTP、HTTPS、SOCKS のエンドポイントに対応します。そのスキームは中継プロトコルを表します。HTTPS プロキシには、Requests や curl_cffi など、対応するリクエストハンドラのインストールも必要です。

明示的に空のプロキシ文字列を指定すると、直接アクセスになります。オプションを省略した場合は、yt-dlp の通常の環境変数ベースのプロキシ動作が維持されます。

実際に処理を行う YoutubeDL インスタンスを設定してください。周囲のアプリケーションの Requests セッションには独自の方針があり、委任された外部ダウンローダーにも独自のプロキシ入力が必要になる場合があります。