Semak dokumentasi
Panduan
Kemas kini versi nightly, kurangkan permintaan serentak, semak Deno, kemudian uji kuki dan IP keluar yang berfungsi.
Pada halaman ini
Cuba ini terlebih dahulu
- Memperbaharui pada waktu malam.Memperbaharui persekitaran Python yang digunakan oleh pekerja yang gagal.
- Mengurangkan beban. Berhenti kerja paralel pada IP ini; menguji satu video dan satu fragmen pada satu masa.
- Pastikan Deno. Mengesahkan bahawa log verbous mengesan masa kerja.
- Cuba kuki yang sah. Untuk kerja kecil, gunakan sesi pelayar yang boleh memainkan sumber.
- Tukar IP yang ditolak. Mulakan ekstraksi segar melalui penyelenggara yang sihat atau keluar proxy.
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"Berlari pada pekerja yang gagal. Periksa verbo Proxy map untuk laluan sebenar. --ignore-config menghapuskan opsyen yang disimpan tetapi mengekalkan plugins dan proxy persekitaran yang dipasang.
Sukses bermaksud fail yang disimpan. Sebaik sahaja audio berfungsi, ujian video dengan -f bv, kemudian pulih seting output penuh anda. --simulate dan -F tidak menguji pemindahan media. Kap 2M merupakan titik permulaan bagi diagnosis.
1. update kepada malam
Perintah yang telah bekerja tiba-tiba gagal: update pertama. perubahan pemutar YouTube boleh memecahkan pengekstrak yang lebih tua; yang terakhir malam mungkin sudah mengandungi penyesuaian.
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 --versionMemulihkan dan memulakan semula bekas jika imejnya mengandungi pakej yang lebih tua; kemas kini Python pada host tidak mengemas kini bekas itu.
Menghilangkan lama player_client, player_js_version dan format=missing_pot berlebihan untuk garis asas. Seorang pekerja daripada insiden lama kini boleh memilih pelanggan yang tidak sesuai atau mendedahkan aliran yang token masih hilang. Issue #14680 ialah contoh perubahan pemain yang tetap upstream; menyalin override sementara tidak berkesudahan bukanlah penyelesaian.
2 Mengurangkan permintaan yang bersaing
Download berfungsi, kemudian gagal apabila jumlah meningkat: mengurangkan beban keseluruhan pada IP output.Dalam pengalaman FlashData, pemindahan paralel yang cepat boleh mencetuskan penolakan.
| Sumber beban | diagnostik pertama |
|---|---|
| Video kerja persaingan | Satu video aktif untuk IP keluar ini; berhenti selebihnya tali sementara. |
| Permintaan Fragment asli | --concurrent-fragments 1. |
| aria2 atau lain-lain pemacu luaran | Kembali kepada --downloader native. Jika menggunakan aria2 semula, mulakan dengan -x 1 -s 1 -j 1. |
| Media lebar | Cuba --limit-rate 2M sebagai ujian konservatif, kemudian meningkat secara beransur-ansur. |
| Pengeluaran dan muat turun baru | Menggunakan --sleep-requests 2 dan --sleep-interval 5 --max-sleep-interval 10. |
| Pergi ke Pensiun | Pastikan kedua-dua tahap pekerjaan dan tahap penarikan pengiraan terhad; jangan berbilang mereka di kalangan pekerja. |
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"Jika pemindahan beban rendah berfungsi, simpan garis asas itu dan meningkatkan satu dimensi pada satu masa sambil menonton kegagalan. Jika ia masih gagal segera selepas pemeriksaan nightly/runtime, jangan terus mengurangkan lebar jalur tanpa henti: menguji IP keluar yang berbeza. Rute yang telah ditandakan oleh YouTube mungkin kekal ditolak selepas trafik yang memicu ia telah berhenti.
3 Periksa Deno
Pastikan kedua-dua ketergantungan pada pekerja: Deno menjalankan cabaran; yt-dlp-ejs menyediakan skrip penyelesai. [default] tambahan memasang skrip.
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"Baca garis runtime JS untuk Deno, dan apa-apa [jsc:deno] mesej yang menyelesaikan. Masa berjalan yang hilang atau peringatan signature/n-challenge perlu diselesaikan sebelum menjalankan muat turun besar yang lain. Deno 2.3+ ialah minimum semasa dalam dokumentasi EJS upstream; gunakan versi yang disokong sehingga kini.
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
--verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"Yang curl-cffi tambahan membolehkan --impersonate="". Ia menyediakan pencetakan jari seperti permintaan pelayar; ia tidak menggantikan Deno. Jika tarikan pelayar tidak tersedia, memasang tambahan dalam persekitaran Python yang sama. Sekiranya impersonasi menunjukkan kegagalan pada laluan kerja, bandingkan permintaan yang sama tanpa bendera.
Selepas pemeriksaan ketagihan, pemindahan media sebenar berkurangan. Jika malam semasa masih melaporkan kegagalan penyelesaian tandatangan untuk pemain yang sama, simpan ID pemain dan mesej penyelesai untuk masalah upstream yang sepadan. Jika penyelesaian berjaya dan media mendapat 403, teruskan kepada session/IP pemeriksaan.
5. menggantikan IP keluar yang ditolak
Video awam yang sama, tetapan yang sama, hasil IP yang berbeza: menggantikan output yang gagal. FlashData melihat banyak persisten 403s yang disebabkan oleh IP proxy yang buruk atau bercahaya. Menginstal semula yt-dlp tidak memperbaiki laluan itu.
- Simpan sumber, pemeriksaan malam, Deno, kuki jika perlu, dan format selektor yang sama.
- Ujian satu penggantian keluar IP dengan ekstraksi segar dan pemindahan media sebenar.
- Mengesahkan bahawa proxy sebenarnya mengubah IP outboundnya. nama tuan rumah atau pengesahan gateway baru masih boleh membawa kepada output yang sama.
- Mengekalkan sesi proxy yang bertekanan sepanjang ekstraksi, pengeluaran token dan pemindahan media.
- Menghilangkan atau menyejukkan keluar yang gagal di kolam renang anda. berputar ke keluar yang sihat untuk pekerjaan baru atau penarikan yang dikendalikan.
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"| Hasil | Tindakan berikutnya |
|---|---|
| Sumber yang sama berjaya pada output IP baru | Tetap laluan itu dan baseline beban rendah. kuarantine keluar yang gagal daripada menarik balik untuk setiap video. |
| Perubahan pengesahan proxy tidak mempunyai kesan | Semak dasar IP dan sesi yang sebenarnya; proxy masih boleh menggunakan output yang sama. |
| Pemain berfungsi, media gagal hanya melalui proxy | Semak akses googlevideo.com dan media yang menggunakan yang sama exit/session. |
| Satu sumber gagal pada setiap laluan yang diuji; kawalan berfungsi | Menyiasat sumber, format dan keadaan hidup.Jangan menandakan keseluruhan kolam proxy yang rosak daripada satu video. |
Advanced: Mengekalkan ekstraksi dan pemindahan pada satu IP
Salah satu ralat aplikasi yang biasa ialah mengekstrak info['url'] pada satu mesin, menyimpannya dalam tali, dan muat turunnya kemudian di tempat lain. URL media yang ditandatangani tamat tempoh dan boleh bergantung kepada IP asal dan tajuk permintaan. Proxy berputar boleh mencipta pembahagian yang sama walaupun dalam satu aplikasi.
Menguji ID video YouTube dan tetapan output yang dikehendaki. Pastikan pekerja melakukan ekstraksi segar dan muat turun bersama-sama. Jika pekerja menggunakan proxy, simpan yang sama melalui ekstraksi pemain, pengeluaran token dan permintaan media. Tanya pembekal proxy untuk sesi yang bertekanan daripada memutar setiap permintaan 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"])Jika ini berjaya semasa requests.get(saved_media_url) atau proses FFmpeg yang berasingan gagal, semak yang hilang: URL umur, tajuk yang disediakan oleh pengekstrak, kuki dan kemajuan sebenar. Simpan URL media daripada rekod pekerjaan yang berterusan. Apabila mengembalikan hasil pengekstrakan yang tamat tempoh, meminta URL segar daripada ID video asal.
Advanced: mengesan permintaan yang gagal
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F senarai format yang dikeluarkan; --simulate berhenti sebelum menyimpan media. Ia juga tidak membuktikan bahawa aliran yang dipilih akan mengembalikan byte. Jika log mencapai Downloading 1 format(s) dan kemudian gagal dengan data media 403, mengubah nama fail output atau memasang FFmpeg tidak akan memperbaiki permintaan HTTP.
Profil klien YouTube seperti mweb dan web_safari mengubah yang pemain menjawab yt-dlp permintaan. Sesetengah jawapan memerlukan penandatanganan atau transformasi parameter n; sesetengah permintaan media juga memerlukan token bukti asal GVS. Token PO untuk permintaan pemain tidak boleh ditukar dengan satu untuk penghantaran media atau subtitle.
| Lokasi log | interpretasi |
|---|---|
Unable to download API page / Unable to download webpage | Permintaan pengekstrakan telah ditolak. mengenal pasti tuan rumah itu sebelum memperlakukan ia sebagai kegagalan media-server. |
unable to download video data: HTTP Error 403: Forbidden | Permintaan media yang dipilih telah ditolak.Sila ikuti cawangan solver/token/route di bawah. |
| Perbincangan Fragment Retry | Menjaga kesilapan fragmen dan protokol; membandingkan format lain yang tersedia daripada mengembalikan fragmen yang sama secara tidak berkesudahan. |
| FFmpeg berkata HTTP 403 semasa membaca satu input | FFmpeg adalah menangkap media jauh, contohnya untuk klip. semak URL dan rangkaian yang dipindahkan ke FFmpeg; ini bukan kesilapan kodek tempatan. |
Penyimpanan upload mengembalikan AccessDenied | Fail mencapai peringkat muat naik anda. mengesetkan akses bucket dan retry yang muat naik, bukan muat turun YouTube. |
Advanced: memasang pembekal PO-token
Gunakan cawangan ini apabila format yang diperlukan disingkirkan untuk token GVS yang hilang, atau token yang dikonfigurasi anda ditolak. Token terikat kepada konteks client/request dan boleh terikat kepada ID video. Token yang disalin untuk satu video bukanlah pengesahan yang boleh digunakan semula untuk satu tali penuh. Gunakan pembekal untuk menghasilkan token untuk permintaan semasa.
Seting berikut menggunakan bgutil 2.0.2. Ia mempunyai dua bahagian: plugin Python yang dimuat turun oleh yt-dlp dan perkhidmatan JavaScript yang menghasilkan token. Tetap disesuaikan versi mereka semasa menaik taraf. Contoh-contoh di bawah menggunakan perkhidmatan yang boleh diakses di host yang sama di pelabuhan 4416.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"Untuk yt-dlp menjalankan pada host Docker. menerbitkan hanya port loopback.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2Permintaan Git, Node 22+ dan npm. menjalankan perintah terakhir dalam terminal yang berasingan dan biarkan ia berjalan. jika folder sudah wujud, gunakan cek yang sedia ada untuk pelepasan yang sepadan.
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%| Hasil yang dilihat | Fix |
|---|---|
PO Token Providers: none | Plugin tidak dimuat naik. memasangnya dengan penerjemah Python yang sama; menghapuskan --no-plugin-dirs. Untuk binari berasingan, gunakan pemasangan ZIP plugin yang didokumenkan oleh pembekal daripada pip ke dalam persekitaran yang tidak berkaitan. |
Error reaching GET … /ping | Mulakan pembekal atau membetulkan base_url. semak daripada proses muat turun, bukan sahaja pelayar laptop anda. |
| Pembekal disenaraikan, tetapi tiada generasi berlaku | Baca kesilapan pemain terdahulu. LOGIN_REQUIRED boleh menghentikan permintaan sebelum peringkat token. plugin yang dimuat naik tidak membuktikan bahawa ia telah digunakan. |
| (a) Menerima tanda-tanda yang dikeluarkan, kemudian bot/sign-in penolakan | Bergerak ke diagnosis session/network. menghasilkan token tidak mengesahkan akaun pelayar. |
| mweb token berfungsi, pelanggan lama masih gagal | Jangan gunakan token mweb untuk klien lain. biarkan pembekal mengendalikan konteks yang dipilih, atau kembali kepada konfigurasi klien yang berfungsi. |
Untuk dua bekas, 127.0.0.1 di dalam pekerja menunjuk kepada pekerja itu sendiri. Letakkan kedua-dua perkhidmatan di rangkaian Docker yang sama dan gunakan nama perkhidmatan pembekal, contohnya http://bgutil-provider:4416. Jangan mendedahkan pelabuhan pembekal secara terbuka.
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"Masalah #17681 merekodkan kegagalan token manual yang diselesaikan dengan beralih kepada pembekal. Ia juga mengandungi satu pengulangan kemudian: memperlakukan pembaikan kerja sebagai bukti kegagalan token itu, bukan bukti bahawa setiap kemudian 403 mempunyai punca yang sama.
Advanced: satu format, klip atau aliran langsung gagal
Format senarai dengan kuki yang sama, pembekal dan pilihan rangkaian seperti kegagalan muat turun. Menggunakan format yang gagal secara langsung. Jika format yang berbeza yang tersedia berfungsi, anda telah menyempit kegagalan kepada laluan delivery/client; anda tidak menetapkan bahawa setiap resolusi atau kodek telah rosak.
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"Peringatan SABR berkaitan dengan format yang ditawarkan oleh pelanggan. Mereka tidak sama seperti kegagalan n-challenge. Sekiranya satu kelebihan lama web hanya menghasilkan format unavailable/unsupported, lepaskan kelebihan atau gunakan laluan yang didokumenkan mweb/provider. Jangan menambah formats=missing_pot sebagai penyesuaian: ia mendedahkan format tanpa menyediakan token yang hilang mereka.
Video hidup, baru-baru ini selesai dan biasa dimuat naik boleh mendedahkan manifestasi yang berbeza. Masukkan keadaan itu apabila mencari upstream. Jika aliran baru-baru ini masih diproses, format alternatif yang kini tersedia atau ekstraksi kemudian boleh menjadi ujian seterusnya yang berguna; menambah kodek global yang berlebihan kepada setiap pekerja tidak.
Menggambarkan seorang pekerja
Pertama-tama mengulangi sumber yang gagal dengan output asal yang dikehendaki video/audio. Kemudian mengembalikan satu pekerja menggunakan manifest, arkib dan dasar output yang sedia ada. Jika semua pekerjaan berkongsi sesi atau laluan yang gagal yang sama, berhenti yang mengejek daripada mengulangi kegagalan.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txtA 403 yang kembali pada setiap percubaan memerlukan keadaan yang berubah sebelum bersara. Jangan menetapkan retries fragmen yang tidak berkesudahan atau memindahkan ID yang gagal ke dalam arkib kejayaan. Jika media selesai dan hanya penyimpanan penghantaran gagal, memulakan semula muat naik fail yang disimpan.
Masih gagal?Siapkan laporan kesilapan yang berguna
- Menangkap pemindahan sebenar yang gagal dengan --verbose, bukan sahaja berjalan yang berjaya --simulate.
- Mengekalkan yt-dlp penilaian, runtime/EJS versi, pembekal yang dimuat naik dan yang dipilih format/protocol.
- Termasuk amaran sebelum kesilapan, sama ada token telah diminta, dan sama ada kegagalan berlaku sebelum atau selepas pemilihan media.
- Mencatat hasil daripada sumber yang sama di atas IPv4/direct/proxy hanya untuk perbandingan yang anda sebenarnya menjalankan.
- Menghapuskan kandungan cookie, pengesahan proxy, URL yang ditandatangani dan token sebelum berkongsi log.
Cari upstream menggunakan amaran tertentu yang terdahulu dan pelepasan anda. Jika regresi yang sepadan masih terbuka, simpan item yang gagal dan gunakan laluan kerja yang disahkan semasa menjejaki pembaikan itu. Log bersih yang hanya mengatakan '403' kurang berguna daripada rekod pendek yang menunjukkan perubahan permintaan dan kawalan gagal.