Belgeleri incele
Kılavuzlar
Nightly sürümünü güncelleyin, eşzamanlı istekleri azaltın, Deno'yu doğrulayın, ardından çerezleri ve çalışan bir çıkış IP adresini deneyin.
Bu sayfada
Bunu ilk denemek
- Gece güncelleştirme. Başarısız işçi tarafından kullanılan Python ortamını yükseltin.
- Yüklemeyi azaltın. Bu IP'de paralel işleri durdurun; tek video ve tek parça test edin.
- Deno'yu kontrol edin. Sözlü günlüğün çalışma saatini tespit ettiğini doğrulayın.
- Geçerli çerezler seçin. Küçük bir iş için, kaynağı oynayabilen bir tarayıcı oturumu kullanın.
- Düşürülen bir IP'yi değiştirin. Sağlıklı bir ev sahibi veya proxy çıkış yoluyla taze bir ekstraksiyon başlatın.
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"Başarısız işçi üzerinde çalışın. Gerçek yol için Proxy map verbozunu kontrol edin. --ignore-config kaydedilen seçenekleri kaldırır ancak eklentileri ve çevre proxy'lerini yüklemeye devam eder.
Başarı bir dosya kaydedildi anlamına gelir. Ses çalıştırdıktan sonra -f bv ile videoyu test edin, sonra tam çıkış ayarlarını geri yüklemeyin. --simulate ve -F bir medya transferini test etmeyin. 2M kapı teşhis için bir başlangıç noktasıdır.
1 Güncelleştirme Geceye
Daha önce çalışan bir komut aniden başarısız olur: ilk güncelleştirme. YouTube oynatıcı değişiklikleri eski çıkarıcıları kırabilir; son gece zaten düzeltme içerebilir.
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 --versionBir konteyner yeniden başlatın ve yeniden başlatın, eğer görüntü eski bir paket içeriyorsa; ev sahibi Python güncellemesi bu konteyner güncellemez. iş günlüğünde doğru bir değişiklik yapın ve diğer ayarları değiştirmeden önce aynı kaynağı tekrar çalıştırın.
Eski player_client, player_js_version ve formatı=missing_pot baseline geçişleri kaldırın. Eski bir olaydan gelen bir işçi artık uygun olmayan bir müşteriyi seçebilir veya token eksikliği olan bir akım sergilebilir. Sorun #14680 bir oyuncu sabit yükseliş değişimi bir örnektir; geçici aşırı sonsuz kopyalanması düzeltme değildir.
2. Karşılıklı talepleri azaltmak
Download çalışır, sonra hacim artarken başarısız olur: çıkış IP'deki toplam yükü azaltır.FlashData'nın deneyiminde, hızlı paralel transferler reddedilebilir.
| yük kaynağı | İlk Diagnostik Siteler |
|---|---|
| Video Rekabetçi İşler | Bu çıkış IP için aktif bir video; kalan çubuk geçici olarak durdurulur. |
| Fragman talepleri | --concurrent-fragments 1. |
| aria2 veya başka bir dış indirme | Поверніться до --downloader native. Якщо згодом знову ввімкнете aria2, почніть із -x 1 -s 1 -j 1. |
| Media Bandwidth İletişim | --limit-rate 2M bir muhafazakar test olarak deneyin, sonra yavaş yavaş arttırın. |
| İndirim ve Yeni İndirme | Kullanımı --sleep-requests 2 ve --sleep-interval 5 --max-sleep-interval 10. |
| NESDED RETRİ | Hem iş düzeyinde hem de indirme düzeyinde emeklilik sayısını sınırlı tutun; bunları çalışanlar arasında çoğaltmayın. |
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"Düşük yük transfer işe yarıyorsa, o baz çizgisini tutun ve başarısızlıkları izlerken bir boyut arttırın. Eğer nightly/runtime kontrolünden hemen sonra hala başarısız olursa, bant genişliğini sonsuz bir şekilde azaltmaya devam etmeyin: farklı bir çıkış IP'yi test edin. YouTube tarafından zaten işaretlenen bir rota, başlatılan trafiğin durdurulduktan sonra reddedilebilir.
3 Deno kontrolü
İki bağımlılığı işçiye kontrol edin: Deno zorlukları yerine getirir; yt-dlp-ejs çözücü yazıları sağlar. [default] ek yazıları yüklüyor.
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"Deno için JS çalıştırma hattını ve herhangi bir [jsc:deno] çözücü mesajı okuyun. Bir eksik çalışma saat veya signature/n-challenge uyarısı bir başka büyük indirme çalışması öncesinde düzeltilmelidir. Deno 2.3+, yükseliş EJS belgelerinde mevcut minimum; güncel destekli bir versiyonu kullanın.
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 Ekstra olanak sağlar --impersonate="". Bu, tarayıcı gibi talep parmak izi sağlar; değiştirmez Deno. Tarayıcı hedefi mevcut değilse, ek yükleme aynı Python ortamında. Bir iş yolu üzerinde bir eksiklik ortaya çıkarsa, bayrak olmadan aynı talep karşılaştırın.
Bağımlılık kontrolünden sonra, gerçek medya transferini yeniden başlatın. Eğer mevcut gece hala aynı oyuncu için imza çözme başarısızlığı raporlar, oyuncu kimliği ve çözüm mesajı kaydedin yukarı akış sorunu eşleşmek için. Eğer çözüm başarılı olursa ve medya 403 alırsa, session/IP kontrollerine devam edin.
5: reddedilen çıkış IP'yi değiştirin
Aynı kamu videosu, aynı ayarları, IP ile farklı sonuçlar: başarısız çıkışını değiştirir. FlashData, zayıf veya bayraklı proxy IP'lerin neden olduğu birçok kalıcı 403s görüyor. Bu yöntemi yeniden yüklemek yt-dlp düzeltmez.
- Kaynak, gece revizyonu, Deno, gerekirse çerezleri ve format seçicisi aynı tutun.
- Tek bir değiştirme çıkış IP test, taze bir ekstraksiyon ve gerçek bir medya transfer ile.
- Proxy'nin aslında çıkış IP'sini değiştirdiğini doğrulayın. yeni bir kapı barındırma adı veya kimlik hala aynı çıkışa yol açabilir.
- Ekstraksiyon, token üretimi ve medya transferleri boyunca bir proxy oturumu tutun.
- Havuzunuzdaki başarısız çıkışları kaldırın veya soğutun. yeni bir iş veya kontrol edilen bir geri çekilme için sağlıklı bir çıkışa dönün.
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"| Sonuç Sonuç Sonuç | Sonraki eylem |
|---|---|
| Aynı kaynak yeni bir çıkış IP'de başarılı olur | Bu yolu ve düşük yükü olan temel çizgisini tutun. her video için geri çekilmekten ziyade başarısız çıkışını kvantifleştirin. |
| Proxy kimliklerini değiştirmek işe yaramaz | Gerçek egress IP ve oturum politikası kontrol edin; proxy hala aynı çıkış kullanabilir. |
| Oyuncu çalışıyor, medya sadece proxy aracılığıyla başarısız olur | googlevideo.com erişimini kontrol edin ve bu medya aynı şeyi kullanır exit/session. |
| Her deneme yolunda bir kaynak başarısız olur; kontrol işlemi | Kaynak, format ve canlı durumu araştırın. tek bir video ile kırık tüm proxy havuzu etiketlemeyin. |
Gelişmiş: Ekstraksiyon ve transfer tek bir IP'de tutun
Bir uygulama hatası, info['url']'yi bir makineye çıkarır, bir çubukta saklar ve daha sonra başka bir yerde indir. İmza edilen medya URL'leri sona erer ve orijinal IP ve başlıklarına bağlı olabilir. Bir rotating proxy aynı bölünme bile tek bir uygulama içinde oluşturabilir.
YouTube video kimliğini ve istenen çıkış ayarlarını kontrol edin. İşçilerin yeni bir ekstraksiyon yapmasını ve birlikte indirmelerini sağlayın. Eğer işçi bir proxy kullanırsa, oyuncu çıkarma, token üretimi ve medya talepleri aracılığıyla aynı egresi tutun. Her HTTP isteği döndürmek yerine bir oturum için proxy sağlayıcısına sor.
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"])Eğer bu requests.get(saved_media_url) veya ayrı bir FFmpeg işlem başarısız olursa, bu kayıpları kontrol edin: URL yaş, ekstraktör tarafından sağlanan başlıklar, çerezler ve gerçek egres. Medya URL'lerini kalıcı iş kayıtlarından uzak tutun. Geçmiş çıkarma sonuçlarını geri çekildiğinde, orijinal video kimliğinden taze URL'ler isteyin.
Gelişmiş: Başarısız talep tespit etmek
Watch page / player response
→ available streams and their signed URLs
→ googlevideo.com media bytes or fragments
→ local FFmpeg processing-F kaydedilen biçimleri listeler; --simulate kaydetme medyası öncesinde durur. Ayrıca seçilen akımın byteyi iade edeceğini kanıtlamaz. Eğer kayıt Downloading 1 format(s) ulaşırsa ve sonra bir medya verisi 403 ile başarısız olursa, çıkış dosya adı değiştirmek veya FFmpeg yüklemek bu HTTP isteği düzeltmez.
mweb ve web_safari gibi YouTube istemci profilleri, oyuncu cevabı yt-dlp isteği değiştirir. Bazı cevaplar bir imza veya n-parametrel dönüşüm gerektirir; bazı medya talepleri de bir GVS kanıt-orijinal token gerektirir. Oyuncu isteği için bir PO token, medya teslimatı veya alt başlıklar için biriyle değiştirilemez.
| Log Konumu | yorumlama |
|---|---|
Unable to download API page / Unable to download webpage | Bir çıkarma isteği reddedildi. bu ev sahibi, bir medya-server arızası olarak ele almadan önce tanımlayın. |
unable to download video data: HTTP Error 403: Forbidden | Seçilen medya isteği reddedildi. aşağıdaki solver/token/route dalları izleyin. |
| Fragment Retry Mesajları | Fragman hatasını ve protokolünü tutun; aynı fragmanı sonsuza kadar geri çekmek yerine başka bir mevcut biçimi karşılaştırın. |
| FFmpeg diyor ki HTTP 403 bir giriş okurken | FFmpeg bir klip için, örneğin, uzaktan medyayı yakalamaktadır. URL'yi ve ağın FFmpeg'ye geçtiğini kontrol edin; bu yerel bir kodek hatası değildir. |
Giriş Yükleme AccessDenied | Dosya yükleme aşamasına ulaştı. bucket erişimini ve yüklediği geri çekilmesini düzeltin, YouTube indirme değil. |
Gelişmiş: PO-token sağlayıcısı kurun
Bu dalı, gereklilik formatı eksik bir GVS token için kaybolduğunda veya yapılandırılmış token reddedildiğinde kullanın. Tokenler client/request bir bağlamda bağlanır ve video kimliğine bağlanabilir. Bir video için kopyalanmış bir token, bir bütün çubuk için yeniden kullanılabilir bir kimlik değildir. Bir sağlayıcı kullanarak, mevcut talep için token oluşturun.
Bu ayar bgutil 2.0.2 kullanır. İki parçası vardır: yt-dlp tarafından yüklenen bir Python eklentisi ve tokenler üreten bir JavaScript hizmeti. Güncelleştirme sırasında versiyonlarını düzeltin. Aşağıdaki örnekler, aynı bardağında 4416 erişilebilir bir hizmet kullanır.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"yt-dlp için Docker barındırma üzerinde çalıştırın. yalnızca loopback portu yayınlayın.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2Git, Node 22+ ve npm gerektirir. son komutu ayrı bir terminalde çalıştırın ve çalıştırın. eğer klasör zaten mevcutsa, eşleşen serbest bırakma mevcut kontrolünü kullanın.
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%| gözlemlenen sonuç | Fix Fix |
|---|---|
PO Token Providers: none | Plugin yüklen değildir. aynı Python tercümanı ile yükleme; kaldır --no-plugin-dirs. tek tek binalar için, sağlayıcının belgelendirilmiş eklenti ZIP yükleme yerine bağımsız bir ortamda pip kullanın. |
Error reaching GET … /ping | sağlayıcı başlatın veya düzeltin base_url. indirme işleminden kontrol edin, sadece dizüstü bilgisayarınızın tarayıcısını değil. |
| Tedarikçi listelenmiştir, ancak hiçbir nesil gerçekleşmez | Daha önceki oyuncu hatalarını okuyun. LOGIN_REQUIRED token aşamasından önce talep durdurabilir. yüklü bir eklenti kullanıldığını kanıtlamaz. |
| Bir token oluşturulur, sonra bot/sign-in reddedilir | session/network teşhisine geçin. bir token oluşturmak tarayıcı hesabını doğrulamıyor. |
| mweb token çalışıyor, eski zorunlu müşteri hala başarısız | mweb tokenini diğer müşteriye tekrar kullanmayın. sağlayıcı seçilen bağlamı ele almasına veya çalışan müşterinin yapılandırmasına geri dönmesine izin verin. |
İki konteyner için, 127.0.0.1 işçinin içindeki işe işaret eden işçi kendisine. Her iki hizmet de aynı Docker ağına yerleştirin ve sağlayıcının hizmet adını, örneğin http://bgutil-provider:4416 kullanın. Satıcı limanı kamuya açık olarak göstermeyin.
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"Sorun #17681 bir sağlayıcıya geçerek çözülen bir manuel-token eksikliği kaydeder. Ayrıca bir sonraki tekrarlama içerir: iş düzeni bu token başarısızlığı kanıtı olarak ele alınır, her sonraki 403 aynı nedeni olduğunu kanıtlamaz.
Gelişmiş: Bir format, klip veya canlı akış başarısız olur
List formatı, başarısız indirme ile aynı çerezler, sağlayıcı ve ağ seçenekleri ile. Başarısız formatı doğrudan çalıştırın. Farklı bir mevcut biçim çalışıyorsa, başarısızlığı delivery/client yolu ile daraltmışsınız; her çözünürlüğün veya kodeklerin kırıldığını belirlememişsinizdir.
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 uyarıları, bir müşterinin sunduğu biçimleri ilgilendirir. N-Callenge başarısızlığı ile aynı değildir. Eğer eski bir web aşırı çizgisi sadece unavailable/unsupported biçimleri üretiyorsa, aşırı çizgiyi çıkarın veya belgelendirilmiş mweb/provider yolu kullanın. formats=missing_pot'yi bir düzeltme olarak eklemeyin: eksik tokenlerini sağlamadan biçimleri ortaya çıkarır.
Canlı, son zamanlarda bitmiş ve sıradan yüklenen videolar farklı manifesto gösterebilir. Bu durumu, upstream arama yaparken içerir. Eğer son zamanlarda bitmiş bir akış hala işleniyorsa, mevcut bir alternatif format veya sonraki bir çıkarma yararlı bir sonraki test olabilir; her işçi için küresel bir kodek aşırı eklemek değildir.
Bir işçi özet
İlk olarak, kayıp kaynağı orijinal gerekli video/audio çıkışla tekrarlayın. Sonra bir işçi mevcut manifesto, arşiv ve çıkış politikası kullanarak yeniden başlatılır. Eğer tüm işler aynı başarısız oturum veya rota paylaşırsa, başarısızlıkları çoğaltmak yerine bu çarpışma durdurun.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txtHer denemede geri dönen bir 403 emekli olmadan önce değişen bir koşul gerektirir. Sonsuz parçalar geri dönüşleri ayarlamayın veya başarısız kimlikleri başarı arşivine aktarmayın. Medya bittiğinde ve sadece depolama teslimat başarısız olursa, kaydedilen dosyayı yeniden yüklemeyi başlatın.
Yine de başarısız mı? yararlı bir hata raporu hazırlayın
- Gerçek başarısız transfer --verbose ile yakalanır, sadece başarılı bir --simulate koşu ile değil.
- yt-dlp incelemesini, runtime/EJS versiyonlarını, yüklü sağlayıcıyı ve seçilmiş format/protocol.'yi tutun
- Hata öncesi uyarı, bir token istendiği ve başarısızlık medya seçimi öncesi veya sonrası olup olmadığı içerir.
- Aynı kaynaktan gelen sonuçları IPv4/direct/proxy üzerinden kaydedin, sadece gerçekten yaptığınız karşılaştırmalar için.
- Cookie içeriğini, proxy kimliklerini, imzalanan URL'leri ve tokenleri paylaşmadan önce kaldırın.
Önceki uyarı ve serbest bırakma özel uyarı kullanarak arama. Eğer bir eşleşen regresyon hala açık ise, eksik öğeyi tutun ve bu düzeltmeyi izlerken doğrulanmış bir çalışma yolu kullanın. Sadece '403' diyen temiz bir log, talep ve kontrol edilen değişikliklerin başarısız olduğunu gösteren kısa bir kayıtdan daha az yararlıdır.