コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

ガイド

yt-dlp の 403 Forbidden エラーを解決する

nightly 版への更新、同時リクエストの削減、Deno の確認を順に行い、有効な Cookie と利用可能な出口 IP を試します。

このページの内容

まずはこれを試してみる

  1. 夜間更新。 失敗したワーカーが使用するPython環境をアップグレードします。
  2. 負荷を減らす この IP で並行作業を中止し、1 つのビデオと 1 つのフレームを同時にテストします。
  3. チェックDeno. 言語のログが実行時間を検出していることを確認します。
  4. 有効なクッキーを試してみてください. 小さな作業のために、ソースを再生できるブラウザセッションを使用してください。
  5. 拒否されたIPを置き換える 新鮮な抽出を健康的なホストまたはプロキシの出力で開始します。
更新、その後必要な実行時間をチェック
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
1 源、低負荷転送
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --downloader native \
  --concurrent-fragments 1 --limit-rate 2M --sleep-requests 2 \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
失敗したURLを使用して、コントロールとして短い公開ビデオを表示します. このオーディオ単純スキャンは FFmpeg を避け、試みごとに新しいタイムステンプされたファイル名を保存します。

失敗したワーカーを走らせる 実際のルートのために Proxy map をチェックします. --ignore-config 保存されたオプションを削除しますが、プラグインや環境プロキシをインストールしています。

成功は保存されたファイルを意味します. 音声が動作すると、ビデオを -f bv でテストし、その後、完全な出力設定を復元します. --simulate と -F メディア転送をテストしないでください. 2M キャップは診断の出発点です。

1.夜間更新

以前の作業コマンドが突然失敗する:更新先. YouTube プレーヤーの変更は、古いエクストラクターを破壊することができます; 最新の夜間はすでに修正を含む可能性があります。

従業員のPython環境を更新する
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
python -c "import sys, yt_dlp; print(sys.executable); print(yt_dlp.__file__)"
代わりに公式実行可能なものを使用する場合
yt-dlp --update-to nightly
yt-dlp --version
yt-dlp -U だけの更新プログラムは現在のチャンネル内で使用します --update-to 夜間で安定から切り替える。

コンテナを再起動し、その画像が古いパッケージを含む場合; ホスト上の Python の更新はそのコンテナを更新しない。

古い player_client, player_js_version と フォーマット=missing_pot は ベースライン の 過剰 を 取り除く。古い事件から来たワーカーは、不適切なクライアントを選択したり、まだトークンが欠けているストリームを暴露したりすることができます。Issue #14680 は、プレイヤーが固定アップストリームを変更する例であり、その一時的な過剰を無期限にコピーすることは修正ではない。

2.競争要求の削減

ダウンロードが動作し、その後、容量が上昇するにつれて失敗します: 出力IPの総負荷を減らします FlashData の経験では、速い並行転送が拒否を引き起こす可能性があります。

負荷の源初診断設定
コンテストビデオの仕事この出力IPのためのアクティブなビデオ1つ、残りの尾を一時的に停止します。
原産地の要請--concurrent-fragments 1.
aria2または別の外部ダウンロード--downloader native に戻してください。後で aria2 を再び使う場合は -x 1 -s 1 -j 1 から始めます。
メディアバンド幅保守的なテストとして --limit-rate 2M を試してみて、徐々に増加します。
抽出と新しいダウンロード使用する --sleep-requests 2 と --sleep-interval 5 --max-sleep-interval 10 。
退職 ノース仕事レベルとダウンロードレベルの退職数を両方制限し、従業員の間でそれらを増やさないでください。
必要なビデオストリームを低負荷で回復する
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --downloader native --concurrent-fragments 1 --limit-rate 2M --sleep-requests 2 \
  --sleep-interval 5 --max-sleep-interval 10 --retries 1 --fragment-retries 1 -f bv \
  -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" "https://www.youtube.com/watch?v=jNQXAC9IVRw"

低負荷転送が動作する場合は、そのベースラインを維持し、失敗を見ながら一次元を増やす。nightly/runtimeチェックの直後に失敗する場合は、無期限に帯域幅を減らすことを続けないでください:別の出力IPをテストします。YouTubeがすでに掲げているルートは、それが引き起こしたトラフィックが停止した後に拒否される可能性があります。

3. チェックDeno

ワーカーに両方の依存点をチェックする: Denoは課題を解決し、 yt-dlp-ejs ソリューバーのスクリプトを提供し、 [default] 追加はスクリプトをインストールします。

ワーカー依存症をチェック
deno --version
python -m pip show yt-dlp yt-dlp-ejs
python -m yt_dlp --list-impersonate-targets
実行時間検出と挑戦解決のチェック
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"

読む JS ランタイム ライン Deno, と すべての [jsc:deno] 解決 メッセージ.欠けている実行時間または signature/n-challenge 警告は、別の大きなダウンロード実行前に修正する必要があります。Deno 2.3+ は、アップストリーム EJS ドキュメンタリーの現在の最低値であり、最新のサポートされたバージョンを使用します。

リノックスサービス 外のPATH
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
実行可能なものと代わる /opt/deno/bin/deno. macOS または Windows では、その代わりに従業員の絶対的な Deno パスを使用します。

curl-cffi 追加は --impersonate="」を可能にします。ブラウザのような要求指紋を提供します; Denoを置き換えることはありません。ターゲットがブラウザにアクセスできない場合は、同じ Python 環境で追加をインストールします。インパルソングが作業ルートに失敗を示す場合は、旗なしで同じ要求を比較してください。

依存検査の後、実際のメディア転送を再開します。現在の夜間がまだ同じプレイヤーの署名解決失敗を報告している場合は、アップストリーム問題に合致するプレイヤーIDとソリューバーメッセージを保存します。解決が成功し、メディアが 403 を取得した場合、 session/IP チェックに進みます。

4.小さな仕事のための有効なクッキーを試す

1つの知られている作業セッションをテストします. ブラウザが正確なソースをプレイできることを確認し、その後同じコマンドとルートでそのクッキーを試してみます。

機能するFirefoxセッションを使用する
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies-from-browser firefox \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
ヘッドレスワーカーに輸出されたセッションを使用する
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies private/youtube-cookies.txt \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
Netscape 形式のクッキーを使用します. この仕事のためにファイルをプライベートで書き込み可能に保ち、読みだけの秘密のために、仕事ごとにコピーを作成します。

クッキーがロードされている場合、YouTubeはそれらがもはや有効ではないと述べているが、同じファイルを繰り返し通過する代わりにセッションを置き換える。いくつかのビデオでは、ブラウザのログインを維持することは実用的なものかもしれません。広範囲の公開ビデオコレクションでは、多くのブラウザセッションを見つけ、更新することは、依存可能なスケール戦略ではありません。

マルクワークでは、使用可能なプロキシ出力IPのプールを管理し、低IPリクエスト予算で仕事の境界線で回転します。アカウントのクッキーを実際にアカウントへのアクセスを必要とするソースに保存します。IP 変更は、プライベートまたは利用できないビデオへのアクセスを許可しません。

5.拒否された出力IPを置き換える

同じ公開ビデオ、同じ設定、IPによって異なる結果:FlashData は、不良またはフラッグされたプロキシ IP によって引き起こされる多くの持続的な 403s を見ます. 再インストール yt-dlp はそのルートを修正しません。

  1. ソース、夜間修正、Deno、必要に応じてクッキー、フォーマットセレクターを同じように保つ。
  2. 1回の交換出力IPを新鮮な抽出と実際のメディア転送でテストします。
  3. プロキシが実際にその出力IPを変更したことを確認します 新しいゲートウェアホスト名またはクレジットは、同じ出力につながる可能性があります。
  4. 抽出、トークン生成、メディア転送を通じて、一貫したプロキシセッションを維持します。
  5. プールで失敗した出入りを取り除くか冷却するか、新しい仕事やコントロールされた退職のために別の健康的な出入りへ転換する。
代替プロキシセッションのテスト
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --proxy "http://USER:PASSWORD@HOST:PORT" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
実際のスティッキーセッションプロキシをプライベートに置き換える スティッキーログはプロキシ認証を暴露することができます; 共有する前に編集します。
利用可能な場合の直接ホストアクセスを比較する
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --proxy "" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
これは、テストのための environment/configured プロキシを妨げます. ホストが YouTube に直接アクセスできないときにそれをスキャンします。
ホストのIPv4ルートを比較する
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  --force-ipv4 "https://www.youtube.com/watch?v=jNQXAC9IVRw"
機能するIPv4ルートは、失敗したIPv6ルートとは異なります. プロキシでは、 -4 は必ずしもプロキシの出発 IP ファミリーを選択する必要はありません。
結果発表次のアクション
同じソースが新しい出力IPで成功するそのルートとその低負荷ベースラインを維持し、すべてのビデオのためにそれを撤退する代わりに失敗した出力を四半期にします。
プロキシの認証を変更することは効果がない実際のエグレースIPとセッションポリシーをチェックし、プロキシは同じ出力を使用する可能性があります。
プレーヤーが動作し、メディアはプロキシを通じてのみ失敗する。googlevideo.com アクセスをチェックし、メディアが同じことを使用している exit/session.
試用されたルートごとに1つのソースが失敗し、コントロールが動作する。ソース、フォーマット、ライブステータスを調べる ビデオから壊れたプロキシプール全体をラベルしないでください。

進歩: 1 IP で抽出と転送を維持する

一般的なアプリケーションバグは、一台の機械で info['url'] を抽出し、そのままの箱に保存し、その後別の場所でダウンロードすることです。サインされたメディアのURLは終了し、オリジナルのIPとリクエストヘッダーに依存する可能性があります。ローティングプロキシは、同じアプリケーション内でも同じ分割を作成することができます。

YouTube ビデオ ID と望ましい出力設定をチェックします。ワーカーが新鮮な抽出を行い、一緒にダウンロードしてください。ワーカーがプロキシを使用している場合、プレイヤーの抽出、トークン生成、メディアの要請を通じて同じエグレースを保持します。プロキシプロバイダーに、各 HTTP リクエストを回転する代わりに、タッチセッションを要求します。

同じPython作業で抽出と転送を維持する
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget

options = {
    "js_runtimes": {"deno": {}},
    "impersonate": ImpersonateTarget(),
    "format": "ba",
    "outtmpl": "diagnostics/%(id)s-%(epoch)s.%(ext)s",
    "noplaylist": True,
    "verbose": True,
    # If required, configure one sticky proxy for the entire job:
    # "proxy": "http://USER:PASSWORD@HOST:PORT",
}
with YoutubeDL(options) as downloader:
    downloader.download(["https://www.youtube.com/watch?v=jNQXAC9IVRw"])
これは直接の地元ダウンロードであり、APIキーは必要ありません。確認された cookie/provider オプションを追加する場合にのみ、以前のテストがそれらを必要とする場合。

このようなことが成功する場合、 requests.get(saved_media_url) または別の FFmpeg プロセスが失敗する間に、その欠陥を確認してください: URL 年齢、エクストラクターによって提供されたヘッドウェア、クッキー、および実際のエグレッシュ。メディアURLを持続可能な仕事記録から削除します。終了した抽出結果をリリースする際、オリジナルのビデオIDから新鮮なURLを要求します。

進歩:失敗した要求を確認する

要請順序
Watch page / player response
  → available streams and their signed URLs
  → googlevideo.com media bytes or fragments
  → local FFmpeg processing

-Fは抽出されたフォーマットをリストし、 --simulateはメディアを保存する前に停止します。選択した流れがバイトを返すことを証明するものではありません。記録が Downloading 1 format(s) に到達し、その後メディアデータ 403 で失敗した場合、出力ファイル名を変更または FFmpeg をインストールすると、その HTTP 要求を修正することはありません。

mweb と web_safari のような YouTube クライアント プロファイルは、プレイヤーの回答 yt-dlp が要求する変更です。いくつかの回答には署名またはnパラメーター変換が必要です; いくつかのメディアリクエストには、GVS証明オリジナルトークンも必要です。プレイヤーの要望のための PO トークンは、メディア配達またはサブタイトルのための 1 つと交換できません。

ロゴ位置解釈
Unable to download API page / Unable to download webpage抽出要請は拒否されました そのホストを特定する前にメディアサーバーの故障として扱います。
unable to download video data: HTTP Error 403: Forbiddenメディアの要求は拒否されました. 下の solver/token/route 枝をフォローします。
メッセージ リトリー メッセージセグメントストリームが失敗しました. フレームエラーとプロトコルを保持し、同じフレームを無期限にリターンする代わりに別の利用可能なフォーマットを比較します。
FFmpeg が HTTP 403 を読みながらFFmpegは、例えば、クリップのために、リモートメディアを捕獲します. URLとネットワークが FFmpegに移行したことを確認します. これは地元のコデックエラーではありません。
ストレージアップロードが AccessDenied に戻りますファイルはアップロードステージに到達しました. アップロードするバケットアクセスとリトリーを修正し、YouTubeダウンロードではなく。

進歩:PO-tokenプロバイダーをインストール

この分野を使用すると、必要なフォーマットが欠けているGVSトークンに切り替えられたり、設定されたトークンが拒否される場合があります。トークンは client/request コンテキストに接続されており、ビデオ ID に接続することができます。1 つのビデオにコピーされたトークンは、全巻の再利用可能な認証ではありません。プロバイダーを使用して、現在のリクエストのためのトークンを生成します。

次の設定では bgutil 2.0.2 を使用します。パイソンプラグインは yt-dlp で充電され、トークンを生成する JavaScript サービスです。アップグレード時にバージョンを調整する。下記の例では、ポート4416で同じホストでアクセス可能なサービスを使用します。

コンタクトを yt-dlp の Python 環境にインストールする
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"

ドッカーホストで実行するには yt-dlp のみループバックポートを公開します。

プロバイダーをスタート
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2
ダウンロード環境からサービスをチェック
python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"
HTTP 200 を期待します. yt-dlp が実行されている場合、従業員コンテナ内でこれを実行します。
mwebメディア・プロバイダーとのリクエスト
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  --extractor-args "youtube:player_client=mweb" \
  --extractor-args "youtubepot-bgutilhttp:base_url=http://127.0.0.1:4416" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
ログで何を探すべきか
PO Token Providers: bgutil:http-2.0.2 (external)
Generating a gvs PO Token for mweb client via bgutil HTTP server
[download] 100%
プロバイダーの発見、トークン生成、メディア転送は3つの別々のチェックです。
観察結果フィックス
PO Token Providers: noneプラグインは充電されていません. 同じ Python インタラクターでインストールします. --no-plugin-dirs を削除します. 単一のバイナリーでは、プロバイダーの文書化されたプラグイン ZIP インストールを使用して、関連していない環境にピップする代わりに。
Error reaching GET … /pingプロバイダーを起動するか、または修正する base_url.ダウンロードプロセスからチェックするだけでなく、ノートパソコンのブラウザだけです。
プロバイダーリストですが、世代は起こりません。以前のプレイヤーのエラーを読み取る LOGIN_REQUIRED は、トークンステージの前にリクエストを停止することができます. 充電されたプラグインは、使用されたことを証明しません。
トークンが生成され、その後bot/sign-in拒否session/network診断に移動します. トークンを生成することは、ブラウザのアカウントを認証しません。
mweb トークンが動作し、古い強制クライアントがまだ失敗他のクライアントのために mweb のトークンを再利用しないでください. プロバイダーが選択したコンテキストを処理するか、または作業クライアントの設定に戻るようにしてください。

2つのコンテナの場合127.0.0.1ワーカーの内側はワーカー自身にポイントを付けます。両方のサービスを同じDockerネットワークに配置し、プロバイダーのサービス名、例えば http://bgutil-provider:4416 を使用します。プロバイダーポートを公開しないでください。

プロバイダーを従業員のドッカーネットワークで使用する
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  --extractor-args "youtube:player_client=mweb" \
  --extractor-args "youtubepot-bgutilhttp:base_url=http://bgutil-provider:4416" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"

問題 #17681 は、プロバイダーに切り替えることによって解決された手動トークン失敗を記録します。それはまた、後期の再発を含みます:そのトークン失敗の証拠として作業修正を扱い、後期の403が同じ原因を持っていることを証明するのではありません。

進歩: 1 つのフォーマット、クリップまたはライブストリームが失敗

同じクッキー、プロバイダー、ネットワークオプションを有するリスト形式は、ダウンロードが失敗したように。失敗したフォーマットを直接実行します。別の利用可能なフォーマットが動作する場合、失敗を delivery/client コースに縮小しました; すべての解像度またはコデックが破損していることを確認していません。

この要請の文脈のフォーマットをリストする
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
このリストから失敗したIDをテストする
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f YOUR_FORMAT_ID -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
代わる YOUR_FORMAT_ID. 合併した選択のために、ビデオとオーディオIDを別々にテストします. クリップのために、まず、無断のストリームをテストします。

SABRの警告は、クライアントが提供するフォーマットに関連しています。彼らは、n-challengeの失敗と同じではありません。古いwebの過剰がunavailable/unsupportedの形式のみを生成する場合、過剰を取り除くか、文書化されたmweb/providerのパスを使用します。formats=missing_potを修正として追加しないでください:それは欠けているトークンを提供せずにフォーマットを暴露します。

ライブ、最近終了、通常アップロードされたビデオは、さまざまなマニフェストを展示することができます。アップストリームを検索する際にその状態を含む。最近終了したストリームがまだ処理されている場合、現在利用可能な代替形式または後期抽出は次のテストに役立つかもしれません; グローバルコデックをすべてのワーカーに追加することはありません。

1 ワーカーをまとめる

まず、最初に必要な出力 video/audio で失敗したソースを繰り返します。その後、既存のマニス、アーカイブ、出力ポリシーを使用して1人のワーカーを再開します。すべての仕事が同じ失敗セッションやルートを共有している場合、その失敗を増やす代わりに、そのスイッチを休憩します。

既存のコレクション構成にパッキングを適用する
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
  --fragment-retries 3 --batch-file urls.txt
現在の作業時間、プロバイダー、出力、アーカイブオプションを含む設定を使用します. このプロセス内でスペースの要望をプレセットする睡眠器は、他の従業員を調整しません。

403は、退職する前に、あらゆる試みで戻ってくる状態を変更する必要があります。無限のフラグマットリトリを設定したり、失敗したIDを成功アーカイブに移動しないでください。メディアが完了し、ストレージのみの配達が失敗した場合、保存されたファイルのアップロードを再開します。

まだ失敗? 有用なエラーレポートの準備

  • 実行に失敗した転送をキャプチャする --verbose だけの成功した --simulate 走行ではありません。
  • yt-dlpのレビュー、 runtime/EJSのバージョン、充電されたプロバイダー、および選択された format/protocol.を保持します。
  • エラーの前に警告を含み、トークンが要求されたかどうか、メディアの選択の前にまたは後に失敗が発生したかどうか。
  • 同じソースの結果を記録する IPv4/direct/proxy は、実際に実行した比較のみのために。
  • ログを共有する前に、クッキーのコンテンツ、プロキシ認証、サインされたURL、トークンを削除します。

特定の先行警告とリリースを使用してアップストリームを検索します。合致した回復がまだ開いている場合は、失敗した項目を保持し、その修正を追跡する際に確認された作業ルートを使用します。「403」だけを言う清潔なロゴは、要求とコントロールされた変更が失敗したことを示す短い記録よりも役に立たない。