تصفح الوثائق
الأدلة
حدّث الإصدار الليلي، وقلّل الطلبات المتزامنة، وتحقّق من Deno، ثم اختبر ملفات تعريف الارتباط وعنوان IP صالحًا للخروج.
في هذه الصفحة
ابدأ بهذه الخطوات
- حدّث الإصدار الليلي. استخدم بيئة Python التي يعمل فيها برنامج التنزيل الذي واجه الخطأ.
- خفّض الحمل. أوقف المهام الموازية على عنوان IP هذا، واختبر فيديو واحدًا وجزءًا واحدًا في كل مرة.
- تحقّق من Deno. تأكّد من ظهور بيئة JavaScript في السجلّ المفصّل.
- جرّب ملفات تعريف ارتباط صالحة. استخدم جلسة متصفح يمكنها تشغيل الفيديو إذا كانت المهمة صغيرة.
- استبدل عنوان 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 تحديث لليلة
القائمة التي تعمل سابقا فجأة تفشل: تحديث أولا.تغيرات يوتيوب لاعب يمكن أن كسر المستخلصين القديمة؛ قد تكون آخر ليلة بالفعل تحتوي على التصحيح.
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 تتجاوز خط الأساس. يمكن للعامل من حادث قديم الآن اختيار عميل غير مناسب أو عرض تدفق لا يزال يفتقر إليه الرموز. الموضوع #14680 هو مثال على تغيير اللاعب ثابتة في الاتجاه الأعلى؛ نسخ الموجة الزمنية غير المحدودة ليست الترتيب.
2: تقليل الطلبات المتنافسة
تحميل العمل، ثم الفشل مع زيادة الحجم: يقلل من الحمل الإجمالي على خروجه IP. في تجربة FlashData، يمكن أن تنفجر التحويلات الموازية السريعة الرفض.
| مصدر الحمل | أول تشخيص |
|---|---|
| وظائف الفيديو المتنافسة | فيديو واحد نشط لهذا الخروج IP؛ وقف بقية الحبل مؤقتا. |
| طلبات الفقرة الأصلية | --concurrent-fragments 1. |
| aria2 أو أي تنزيل خارجي آخر | ارجع إلى --downloader native. إذا أعدت استخدام aria2 لاحقًا، فابدأ بالإعدادات -x 1 -s 1 -j 1. |
| وسائل الإعلام Bandwidth | حاول --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 الخروج المختلف. قد يبقى مسار يوتيوب قد يرفض بعد أن توقفت حركة المرور التي أدت إلى ذلك.
3 تحقق من دينو
تحقق من الاشتباكات على العامل: يدير 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 التحذير قبل تشغيل تحميل كبير آخر. دينو 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. إذا كان التصميم يقدم فشلًا في مسار العمل ، فقم بمقارنة الطلب نفسه دون العلم.
بعد التحقق من الاعتماد ، يتم إعادة نقل وسائل الإعلام الحقيقية. إذا كان الليل الحالي لا يزال يبلغ عن فشل تسجيل حل لنفس اللاعب، حفظ معرف اللاعب ورسالة حل للمشكلة التي تتطابق مع مشكلة الدوران العلوي. إذا نجح حل ووسائل الإعلام تحصل على 403 ، استمر في session/IP التحقق.
5. استبدال خروجه المرفوضة IP
نفس الفيديو العام، نفس الإعدادات، نتيجة مختلفة من IP: استبدال الخروج الفشل. FlashData يرى الكثير من مستمرة 403s الناجمة عن ضعف أو علامة تجارية IPs. إعادة تثبيت yt-dlp لا يصلح هذا الطريق.
- الحفاظ على المصدر، التعديل الليلي، دينو، الكوكيز إذا لزم الأمر، وتشكيل المختار هو نفسه.
- اختبار واحد استبدال الخروج 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. |
| فشل مصدر واحد في كل مسار اختبره؛ يعمل التحكم | تحقق من المصدر والترتيب والحالة الحية.لا تضع علامة على حوض البروكسي بأكمله مكسور من مقطع فيديو واحد. |
متقدمة: الحفاظ على استخراج ونقل على IP واحد
خطأ تطبيق شائع هو استخراج info['url'] على جهاز واحد، وتخزينها في قوس واحد، وتنزيلها في وقت لاحق في مكان آخر. تنتهي عناوين URL التي تم توقيعها ويمكن أن تعتمد على عناوين IP الأصلية وطلب. يمكن لـ Proxy التدوير إنشاء نفس الانقسام حتى داخل تطبيق واحد.
قم بتوفير ID الفيديو على YouTube وإعدادات النتيجة المطلوبة. يجب على العامل إجراء استخراج جديد والتنزيل معا. إذا كان العامل يستخدم بروكسي، والحفاظ على نفس التقدم من خلال استخراج اللاعب، وتوليد الرموز وطلبات وسائل الإعلام. اسأل مزود البروكسي عن جلسة متسخة بدلاً من إعادة توجيه كل طلب 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 من سجلات العمل المستدامة. عند استرداد نتائج الاستخراج المتأخرة، اطلب عناوين 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.
يغير ملفات تعريف عميل YouTube مثل mweb و web_safari التي يطلبها اللاعب الاستجابة yt-dlp. بعض الإجابات تحتاج إلى توقيع أو تحويل n-المعيار؛ وبعض طلبات الوسائط تحتاج أيضا إلى دليل GVS-of-original token. لا يمكن تبادل الرمز PO لطلب اللاعب مع الرمز الذي يتم تقديمه من خلال وسائل الإعلام أو العناوين الفرعية.
| موقع اللوج | تفسير |
|---|---|
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 الفيديو. لا يوجد رمز نسخ لفيديو واحد هو تصديق قابل للاستخدام مرة أخرى لقطعة كاملة. استخدم مزودًا لإنتاج الرمز للحصول على الطلب الحالي.
يُستخدم الإعداد التالي bgutil 2.0.2. يحتوي على جزأين: ملحق Python الذي يتم تحميله بواسطة yt-dlp وخدمة JavaScript التي تنتج الرموز. الحفاظ على إصداراتهم متوافقة عند الترقية. يستخدم الأمثلة أدناه خدمة متاحة على نفس المضيف في الميناء 4416.
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"yt-dlp يُنقل على مستودع Docker. نشر فقط بوابة loopback.
docker run --name bgutil-provider -d --init -p 127.0.0.1:4416:4416 brainicism/bgutil-ytdlp-pot-provider:2.0.2يتطلب Git و 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.للمكونات الثنائية منفصلة، استخدم تثبيت المكون الإضافي الموثوق به من قبل المورد بدلا من إدخالها في بيئة غير مرتبطة. |
Error reaching GET … /ping | بدء المورد أو تصحيح base_url.تحقق من عملية التنزيل، وليس فقط متصفح الكمبيوتر المحمول الخاص بك. |
| الموردين المذكورين ولكن لا يحدث الجيل | اقرأ أخطاء المشغل السابق. LOGIN_REQUIRED يمكن إيقاف الطلب قبل مرحلة الرموز. لا يثبت ملحق محمول أنه تم استخدامه. |
| يتم إنشاء الرموز ، ثم bot/sign-in رفض | تحويل إلى session/network التشخيص.إن إنشاء رمز لا يحقق مصداقية حساب المتصفح. |
| mweb يعمل الرموز، لا يزال العميل القسري القديم يفشل | لا تستخدم علامة mweb مرة أخرى لهذا العميل الآخر.دع المورد يتعامل مع السياق المحدد، أو العودة إلى تكوين العميل العامل. |
بالنسبة لشريطين ، 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 لاحق له نفس السبب.
متقدمة: تنسيق واحد أو مقطع أو البث المباشر يفشل
قائمة تنسيقات مع نفس الكوكيز والمورد وخيارات الشبكة التي فشلت في تنزيل. قم بتشغيل النموذج المفقود مباشرة. إذا كان هناك تنسيق مختلف متوفر يعمل، فقد قمت بتخفيض الفشل إلى مسار 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 كإصلاح: يظهر تنسيقات دون توفير الرموز المفقودة.
يمكن أن يظهر الفيديو المباشر والنهائي والفيديو المرفوع عادي مختلف المظاهر. إدراج هذا الحالة عند البحث عن upstream. إذا كان تدفقًا تم الانتهاء منه حديثًا لا يزال في المعالجة ، فقد يكون تنسيقًا متغيرًا متاحًا حاليًا أو استخراجًا لاحقًا هو الاختبار التالي المفيد ؛ لا يوجد إضافة كوديك عالمي إلى كل عامل.
إعادة توجيه واحد العامل
أولاً، تكرار المصدر المفقود مع النتيجة الأصلية المطلوبة video/audio. ثم إعادة تعيين عامل واحد باستخدام سياسة المظاهر والملفات والخروج الموجودة. إذا كانت جميع الوظائف تشارك نفس الجلسة أو المسار الفشل، وقف هذا الارتباك بدلا من تضاعف فشلها.
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
--fragment-retries 3 --batch-file urls.txt403 العودة في كل محاولة تحتاج إلى تغيير حالة قبل التقاعد. لا تضع إخراجات الفقرات المتعددة أو تحريك الهوية المفقودة إلى أرشيف النجاح. إذا انتهت وسائل الإعلام وفشل تسليم التخزين فقط، إعادة تحميل الملف المحفوظ.
لا يزال فاشلا؟ إعداد تقرير خطأ مفيد
- التقاط التحويل الفعلي المفقود مع --verbose ، وليس فقط نجاح --simulate سباق.
- الحفاظ على yt-dlp مراجعة، runtime/EJS الإصدارات، المورد المحمول، والخيار المختار format/protocol.
- إدراج التحذير قبل الخطأ، ما إذا كان تم طلب الرمز، وما إذا كان الفشل حدث قبل أو بعد اختيار وسائل الإعلام.
- اكتب النتائج من نفس المصدر على IPv4/direct/proxy فقط للمقارنة التي قمت بها فعلا.
- إزالة محتوى الكوكيز، وشهادات البروكسي، وURL الموقعة والتوكنات قبل مشاركة السجل.
البحث عن التقدم باستخدام تحذير ما قبل محدد وإطلاقك. إذا كان الانعكاس المطابق لا يزال مفتوحا، والحفاظ على البند الفشل واستخدام مسار العمل المعتمد أثناء تتبع هذا التصحيح. سجل نظيف يقول فقط "403" أقل فائدة من سجل قصير يظهر أن طلب وتغيير التحكم فشل.