Jelajahi dokumentasi
Panduan
Perbarui versi nightly, kurangi permintaan serentak, periksa Deno, lalu uji cookie dan IP keluar yang berfungsi.
Di halaman ini
Cobalah ini dulu
- Update malam. Upgrade lingkungan Python yang digunakan oleh pekerja yang gagal.
- Mengurangkan beban. Berhenti kerja paralel pada IP ini; menguji satu video dan satu fragmen sekaligus.
- Pastikan Deno. Mengkonfirmasi bahwa log verbous mengidentifikasi waktu kerja.
- *Cuba cookie yang valid. * Untuk pekerjaan kecil, gunakan sesi browser yang dapat memainkan sumber.
- Tukar IP yang ditolak. Mulai ekstraksi segar melalui host yang sehat atau output 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"Berjalan pada pekerja yang gagal. Periksa verboza Proxy map untuk rute yang sebenarnya. --ignore-config menghapus opsi yang disimpan tetapi tetap menginstal plugins dan proxy lingkungan.
Sukses berarti file yang disimpan. Setelah audio bekerja, menguji video dengan -f bv, kemudian mengembalikan pengaturan output penuh Anda. --simulate dan -F tidak menguji transfer media. Kap 2M adalah titik permulaan untuk diagnosis.
1. update untuk malam hari
Perintah yang sebelumnya bekerja tiba-tiba gagal: update pertama. perubahan pemain YouTube dapat memecahkan ekstraktor yang lebih tua; malam terakhir mungkin sudah mengandung perbaikan.
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 --versionMengembalikan dan memulai kembali konten jika gambarnya mengandung paket yang lebih tua; mengemas kini Python pada host tidak memperbarui konten tersebut.
Menghapus player_client lama, player_js_version dan format=missing_pot overrides untuk garis dasar. Seorang pekerja dari insiden lama sekarang dapat memilih klien yang tidak sesuai atau mengeksposkan aliran yang tokennya masih hilang. Masalah #14680 adalah contoh perubahan pemain tetap upstream; menyalin override sementara tidak terbatas tidak menjadi fix.
2 Mengurangi permintaan yang bersaing
Download bekerja, kemudian gagal karena volume meningkat: mengurangi beban total pada output IP. Dalam pengalaman FlashData, transfer paralel cepat dapat memicu penolakan.
| Sumber dari load | Diagnosis pertama |
|---|---|
| Video kompetitif | Satu video aktif untuk IP output ini; menghentikan sisa tali sementara. |
| Permintaan Fragment asli | --concurrent-fragments 1. |
| aria2 atau download eksternal lainnya | Kembali ke --downloader native. Jika aria2 digunakan lagi nanti, mulai dengan -x 1 -s 1 -j 1. |
| Media Bandwidth | Cobalah --limit-rate 2M sebagai tes konservatif, kemudian meningkat secara bertahap. |
| Extraction dan download baru | Gunakan --sleep-requests 2 dan --sleep-interval 5 --max-sleep-interval 10. |
| Pensiun yang terbelah | Tetap terbatas kedua-dua tingkat pekerjaan dan tingkat download penghitungan pensiun; jangan berbilang mereka di antara 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 transfer beban rendah bekerja, tetaplah garis dasar itu dan meningkatkan satu dimensi sekaligus sambil menonton kegagalan. Jika masih gagal segera setelah pemeriksaan nightly/runtime, jangan terus mengurangi lebar jalur banding tanpa batas: menguji IP output yang berbeda. Rute yang sudah ditandai oleh YouTube mungkin tetap ditolak setelah lalu lintas yang memicu itu telah berhenti.
3. periksa Deno
Pastikan kedua ketergantungan pada pekerja: Deno menjalankan tantangan; 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 pesan yang menyelesaikan [jsc:deno]. Waktu berjalan yang hilang atau peringatan signature/n-challenge perlu diperbaiki sebelum menjalankan download besar lainnya. Deno 2.3+ adalah minimum saat ini dalam dokumentasi EJS upstream; gunakan versi yang didukung up-to-date.
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 memungkinkan --impersonate="". Ini menyediakan pencetakan jari seperti permintaan browser; itu tidak menggantikan Deno. Jika target browser tidak tersedia, instalasi tambahan di lingkungan Python yang sama. Jika impersonasi menunjukkan kegagalan pada rute kerja, bandingkan permintaan yang sama tanpa bendera.
Setelah pemeriksaan ketergantungan, transfer media nyata akan kembali. Jika malam saat ini masih melaporkan kegagalan penyelesaian tandatangan untuk pemain yang sama, simpan ID pemain dan pesan penyelesai untuk masalah upstream yang sesuai. Jika penyelesaian berhasil dan media mendapat 403, lanjutkan ke session/IP cek.
5. menggantikan IP output yang ditolak
Video publik yang sama, pengaturan yang sama, hasil yang berbeda oleh IP: FlashData melihat banyak persisten 403s yang disebabkan oleh IP proxy yang buruk atau berlapis. reinstalling yt-dlp tidak memperbaiki rute itu.
- Simpan sumber, revisi malam, Deno, cookie jika perlu, dan format selektor yang sama.
- Uji satu pengganti keluar IP dengan ekstraksi segar dan transfer media nyata.
- Mengkonfirmasi proxy sebenarnya mengubah outbound IP. Nama host gateway baru atau pengesahan masih dapat menyebabkan output yang sama.
- Tetap sesi proxy yang kuat sepanjang extraction, generasi token dan transfer media.
- Menghilangkan atau menyejukkan keluar yang gagal di kolam renang Anda. berputar ke keluar yang sehat lain untuk pekerjaan baru atau penarikan terkontrol.
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 | Aksi berikutnya |
|---|---|
| Sumber yang sama berhasil pada output IP baru | Tetaplah laluan itu dan garis dasarnya yang rendah beban. kuarantine keluar yang gagal daripada mengembalikannya untuk setiap video. |
| Mengubah proxy tidak ada efek | Periksa kebijakan IP dan sesi yang sebenarnya; proxy masih dapat menggunakan output yang sama. |
| Player bekerja, media gagal hanya melalui proxy | Periksa googlevideo.com akses dan media yang menggunakan yang sama exit/session. |
| Satu sumber gagal di setiap jalur yang diuji; kontrol bekerja | Meneliti sumber, format dan status hidup.Jangan menandakan seluruh proxy pool yang rusak dari satu video. |
Advanced: Mengekstraksi dan transfer pada satu IP
Salah satu bug aplikasi yang biasa adalah mengekstrak info['url'] pada mesin, menyimpannya di kue, dan kemudian men-downloadnya di tempat lain. URL media yang ditandatangani akan tamat dan mungkin tergantung pada IP asli dan headers permintaan. Proxy berputar dapat membuat pembagian yang sama bahkan dalam satu aplikasi.
Menguji ID video YouTube dan pengaturan output yang diinginkan. Pastikan karyawan melakukan ekstraksi segar dan muat turun bersama. Jika pekerja menggunakan proxy, tetap sama egress melalui ekstraksi pemain, generasi token dan permintaan media. Tanyakan kepada penyedia proxy untuk sesi yang bercinta bukannya 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 berhasil saat requests.get(saved_media_url) atau proses yang terpisah FFmpeg gagal, periksa yang hilang: URL umur, headers yang disediakan oleh extractor, cookie dan egress nyata. Simpan URL media dari rekaman pekerjaan yang berkelanjutan. Ketika menarik hasil ekstraksi yang habis, minta URL segar dari ID video asli.
Advanced: mengidentifikasi permintaan yang gagal
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F daftar format yang dikeluarkan; --simulate berhenti sebelum menyimpan media. Tidak ada bukti bahwa aliran yang dipilih akan mengembalikan byte. Jika log mencapai Downloading 1 format(s) dan kemudian gagal dengan data media 403, mengubah nama file output atau menginstal FFmpeg tidak akan memperbaiki permintaan HTTP.
Profil klien YouTube seperti mweb dan web_safari mengubah yang pemain menjawab yt-dlp permintaan. Beberapa jawaban membutuhkan tanda tangan atau transformasi n-parameter; beberapa permintaan media juga membutuhkan token bukti asal GVS. Token PO untuk permintaan pemain tidak dapat ditukar dengan satu untuk pengiriman media atau subtitle.
| Lokasi log | Interpretasi |
|---|---|
Unable to download API page / Unable to download webpage | Permintaan ekstraksi ditolak. mengenal pasti host tersebut sebelum memperlakukan sebagai kegagalan media-server. |
unable to download video data: HTTP Error 403: Forbidden | Permintaan media yang dipilih ditolak. ikuti solver/token/route cawangan di bawah. |
| Pesan Retry Fragment | Tetaplah error fragmen dan protokol; bandingkan format lain yang tersedia daripada mengembalikan fragmen yang sama secara tidak terbatas. |
| FFmpeg berkata HTTP 403 saat membaca sebuah input | FFmpeg adalah memegang media jauh, misalnya untuk klip. periksa URL dan jaringan yang ditransfer ke FFmpeg; ini bukan kesalahan kodek lokal. |
Penyimpanan upload kembali AccessDenied | File mencapai tahap upload Anda.Fix bucket access and retry that upload, not the YouTube download. |
Advanced: Menginstal penyedia PO-token
Gunakan cawangan ini ketika format yang diperlukan ditarik untuk token GVS yang hilang, atau token yang dikonfigurasi Anda ditolak. Token terikat dengan konteks client/request dan dapat terikat dengan ID video. Token yang disalin untuk satu video tidak merupakan pengesahan yang dapat digunakan kembali untuk seluruh kue. Gunakan penyedia untuk menghasilkan token untuk permintaan saat ini.
Setup berikut menggunakan bgutil 2.0.2. Ini memiliki dua bagian: plugin Python yang diisi oleh yt-dlp dan layanan JavaScript yang menghasilkan token. Tetaplah versi mereka teratur saat upgrade. Contoh di bawah menggunakan layanan yang dapat diakses di host yang sama di pelabuhan 4416.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"Untuk yt-dlp berjalan di host Docker. hanya menerbitkan port loopback.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2Memerlukan Git, Node 22+ dan npm. menjalankan perintah terakhir di terminal yang terpisah dan biarkan berjalan. jika folder sudah ada, gunakan cek yang ada dari 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 diperhatikan | Perbaiki |
|---|---|
PO Token Providers: none | Plugin tidak diisi.Memasang dengan penerjemah Python yang sama; menghapus --no-plugin-dirs.Untuk binari terpisah, gunakan instalasi ZIP plugin yang didokumentasikan penyedia bukannya pip ke lingkungan yang tidak terkait. |
Error reaching GET … /ping | Mulai penyedia atau perbaiki base_url. periksa dari proses download, bukan hanya browser laptop Anda. |
| Pembekal terdaftar, tetapi tidak terjadi generasi | Baca kesalahan pemain sebelumnya. LOGIN_REQUIRED dapat menghentikan permintaan sebelum tahap token. plugin yang dimuat tidak membuktikan bahwa itu digunakan. |
| Sebuah token dihasilkan, kemudian bot/sign-in penolakan | Move to session/network diagnosis. menghasilkan token tidak mengautentikasi akun browser. |
| mweb token bekerja, klien lama masih gagal | Jangan menggunakan token mweb untuk klien lain. biarkan penyedia mengendalikan konteks yang dipilih, atau kembali ke konfigurasi klien yang bekerja. |
Untuk dua kontena, 127.0.0.1 di dalam pekerja menunjuk kepada pekerja itu sendiri. Letakkan kedua layanan di jaringan Docker yang sama dan gunakan nama layanan penyedia, misalnya http://bgutil-provider:4416. Jangan mendedahkan pelabuhan penyedia 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 merekam kegagalan token manual yang diselesaikan dengan beralih ke penyedia. Ini juga mengandung reaksi kemudian: memperlakukan fix kerja sebagai bukti kegagalan token itu, tidak membuktikan bahwa setiap kemudian 403 memiliki penyebab yang sama.
Advanced: satu format, klip atau streaming langsung gagal
Format daftar dengan cookie, penyedia dan opsi jaringan yang sama seperti gagal download. Menggunakan format yang gagal secara langsung. Jika format yang berbeda yang tersedia bekerja, Anda telah menyempit kegagalan ke jalur delivery/client; Anda tidak menetapkan bahwa setiap resolusi atau codec pecah.
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 klien. Mereka tidak sama dengan kegagalan n-tuntutan. Jika suatu override lama web hanya menghasilkan format unavailable/unsupported, lepaskan override atau gunakan jalur yang didokumentasikan mweb/provider. Jangan menambahkan formats=missing_pot sebagai perbaikan: ia mengeksposkan format tanpa menyertakan token yang hilang.
Video langsung, baru-baru ini selesai dan biasa diunggah dapat mengeksposkan manifestasi yang berbeda. Termasuk kondisi itu saat mencari upstream. Jika aliran yang baru selesai masih diproses, format alternatif yang tersedia saat ini atau ekstraksi kemudian mungkin menjadi tes berikutnya yang berguna; menambahkan kode global yang berlebihan untuk setiap pekerja tidak.
Mengumpulkan 1 pekerja
Pertama, ulangi sumber yang gagal dengan output yang diperlukan video/audio asli. Kemudian mengembalikan satu pekerja menggunakan kebijakan manifesto, arkib dan output yang ada. Jika semua pekerjaan berbagi sesi atau rute yang gagal yang sama, istirahat yang mengganggu bukannya 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 kembali pada setiap percobaan membutuhkan kondisi yang berubah sebelum bersara. Jangan menetapkan retries fragmen yang tak terbatas atau memindahkan ID yang gagal ke dalam arkib keberhasilan. Jika media selesai dan hanya penyimpanan pengiriman gagal, kembali upload file yang disimpan.
Masih gagal? menyiapkan laporan kesalahan yang berguna
- Menangkap transfer yang sebenarnya gagal dengan --verbose, tidak hanya berjalan sukses --simulate.
- Tetap yt-dlp revisi, runtime/EJS versi, penyedia yang dimuat dan yang dipilih format/protocol.
- Termasuk peringatan sebelum kesalahan, apakah token diminta, dan apakah kegagalan terjadi sebelum atau setelah pemilihan media.
- Mencatat hasil dari sumber yang sama di atas IPv4/direct/proxy hanya untuk perbandingan yang sebenarnya Anda lakukan.
- Menghapus konten cookie, proxy credentials, URL yang ditandatangani dan token sebelum berbagi log.
Cari upstream menggunakan peringatan sebelumnya spesifik dan pelepasan Anda. Jika regresi yang sepadan masih terbuka, simpan item yang gagal dan gunakan jalur kerja yang disahkan sambil menjejaki perbaikan itu. Sebuah log bersih yang hanya mengatakan '403' kurang berguna daripada rekaman pendek yang menunjukkan permintaan dan perubahan yang dikendalikan gagal.