ドキュメントを探す
ガイド
nightly 版への更新、同時リクエストの削減、Deno の確認を順に行い、有効な Cookie と利用可能な出口 IP を試します。
このページの内容
まずはこれを試してみる
- 夜間更新。 失敗したワーカーが使用するPython環境をアップグレードします。
- 負荷を減らす この IP で並行作業を中止し、1 つのビデオと 1 つのフレームを同時にテストします。
- チェックDeno. 言語のログが実行時間を検出していることを確認します。
- 有効なクッキーを試してみてください. 小さな作業のために、ソースを再生できるブラウザセッションを使用してください。
- 拒否されたIPを置き換える 新鮮な抽出を健康的なホストまたはプロキシの出力で開始します。
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --versionpython -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"失敗したワーカーを走らせる 実際のルートのために Proxy map をチェックします. --ignore-config 保存されたオプションを削除しますが、プラグインや環境プロキシをインストールしています。
成功は保存されたファイルを意味します. 音声が動作すると、ビデオを -f bv でテストし、その後、完全な出力設定を復元します. --simulate と -F メディア転送をテストしないでください. 2M キャップは診断の出発点です。
1.夜間更新
以前の作業コマンドが突然失敗する:更新先. YouTube プレーヤーの変更は、古いエクストラクターを破壊することができます; 最新の夜間はすでに修正を含む可能性があります。
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コンテナを再起動し、その画像が古いパッケージを含む場合; ホスト上の 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-targetspython -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 ドキュメンタリーの現在の最低値であり、最新のサポートされたバージョンを使用します。
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"curl-cffi 追加は --impersonate="」を可能にします。ブラウザのような要求指紋を提供します; Denoを置き換えることはありません。ターゲットがブラウザにアクセスできない場合は、同じ Python 環境で追加をインストールします。インパルソングが作業ルートに失敗を示す場合は、旗なしで同じ要求を比較してください。
依存検査の後、実際のメディア転送を再開します。現在の夜間がまだ同じプレイヤーの署名解決失敗を報告している場合は、アップストリーム問題に合致するプレイヤーIDとソリューバーメッセージを保存します。解決が成功し、メディアが 403 を取得した場合、 session/IP チェックに進みます。
5.拒否された出力IPを置き換える
同じ公開ビデオ、同じ設定、IPによって異なる結果:FlashData は、不良またはフラッグされたプロキシ IP によって引き起こされる多くの持続的な 403s を見ます. 再インストール yt-dlp はそのルートを修正しません。
- ソース、夜間修正、Deno、必要に応じてクッキー、フォーマットセレクターを同じように保つ。
- 1回の交換出力IPを新鮮な抽出と実際のメディア転送でテストします。
- プロキシが実際にその出力IPを変更したことを確認します 新しいゲートウェアホスト名またはクレジットは、同じ出力につながる可能性があります。
- 抽出、トークン生成、メディア転送を通じて、一貫したプロキシセッションを維持します。
- プールで失敗した出入りを取り除くか冷却するか、新しい仕事やコントロールされた退職のために別の健康的な出入りへ転換する。
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"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"| 結果発表 | 次のアクション |
|---|---|
| 同じソースが新しい出力IPで成功する | そのルートとその低負荷ベースラインを維持し、すべてのビデオのためにそれを撤退する代わりに失敗した出力を四半期にします。 |
| プロキシの認証を変更することは効果がない | 実際のエグレースIPとセッションポリシーをチェックし、プロキシは同じ出力を使用する可能性があります。 |
| プレーヤーが動作し、メディアはプロキシを通じてのみ失敗する。 | googlevideo.com アクセスをチェックし、メディアが同じことを使用している exit/session. |
| 試用されたルートごとに1つのソースが失敗し、コントロールが動作する。 | ソース、フォーマット、ライブステータスを調べる ビデオから壊れたプロキシプール全体をラベルしないでください。 |
進歩: 1 IP で抽出と転送を維持する
一般的なアプリケーションバグは、一台の機械で info['url'] を抽出し、そのままの箱に保存し、その後別の場所でダウンロードすることです。サインされたメディアのURLは終了し、オリジナルのIPとリクエストヘッダーに依存する可能性があります。ローティングプロキシは、同じアプリケーション内でも同じ分割を作成することができます。
YouTube ビデオ ID と望ましい出力設定をチェックします。ワーカーが新鮮な抽出を行い、一緒にダウンロードしてください。ワーカーがプロキシを使用している場合、プレイヤーの抽出、トークン生成、メディアの要請を通じて同じエグレースを保持します。プロキシプロバイダーに、各 HTTP リクエストを回転する代わりに、タッチセッションを要求します。
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"])このようなことが成功する場合、 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で同じホストでアクセス可能なサービスを使用します。
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.2Git、Node 22+ および npm を必要とします 別のターミナルで最後のコマンドを実行し、それを実行させます フォルダーが既に存在している場合は、既存のコントロールを使用して、同一リリースを表示します。
git clone --depth 1 --branch 2.0.2 https://github.com/Brainicism/bgutil-ytdlp-pot-provider.git
cd bgutil-ytdlp-pot-provider/server
npm ci
npx tsc
node build/main.js --host 127.0.0.1 --port 4416python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"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%| 観察結果 | フィックス |
|---|---|
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"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"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.txt403は、退職する前に、あらゆる試みで戻ってくる状態を変更する必要があります。無限のフラグマットリトリを設定したり、失敗したIDを成功アーカイブに移動しないでください。メディアが完了し、ストレージのみの配達が失敗した場合、保存されたファイルのアップロードを再開します。
まだ失敗? 有用なエラーレポートの準備
- 実行に失敗した転送をキャプチャする --verbose だけの成功した --simulate 走行ではありません。
- yt-dlpのレビュー、 runtime/EJSのバージョン、充電されたプロバイダー、および選択された format/protocol.を保持します。
- エラーの前に警告を含み、トークンが要求されたかどうか、メディアの選択の前にまたは後に失敗が発生したかどうか。
- 同じソースの結果を記録する IPv4/direct/proxy は、実際に実行した比較のみのために。
- ログを共有する前に、クッキーのコンテンツ、プロキシ認証、サインされたURL、トークンを削除します。
特定の先行警告とリリースを使用してアップストリームを検索します。合致した回復がまだ開いている場合は、失敗した項目を保持し、その修正を追跡する際に確認された作業ルートを使用します。「403」だけを言う清潔なロゴは、要求とコントロールされた変更が失敗したことを示す短い記録よりも役に立たない。