تصفح الوثائق
الأدلة
أوقف المهام على عنوان IP المقيّد، وخفّض معدّل طلبات الاستخراج والترجمة، ثم استأنف عملية واحدة.
في هذه الصفحة
أوقف المهام وانتظر ثم اختبر مرة واحدة
- أوقف استخدام عنوان IP المتأثر. أوقف كل العمليات التي تشارك عنوان الخروج ومحاولات الإعادة الفورية.
- حدّث الإصدار الليلي. راجع حزمة yt-dlp وDeno في بيئة التشغيل أثناء التوقف.
- اترك مهلة قبل إعادة المحاولة. ابدأ ببضع دقائق. التزم بالمدة في
Retry-Afterإن وُجدت، وانتظر مدة أطول عند الحاجة. - اختبر مصدرًا واحدًا. بعد نجاح الاختبار، استأنف عملية واحدة مع ترك فواصل بين الطلبات.
- غيّر عنوان الخروج عند الحاجة. واصل استخدام معدّل الطلبات المنخفض على العنوان الجديد.
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 \
--sleep-requests 3 --extractor-retries 1 --skip-download --write-info-json -P diagnostics \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"توقف عن الحصول على 429؟ انتظر لفترة أطول أو تغيير الخروج.تحديث yt-dlp لا يعود إلى حد معدل IP الحالي؛ اختبار المظاهر الكاملة يضيف فقط الحمل.
العثور على طلب محدّد
| العمل الفشل | لماذا يمكن أن يولد الكثير من الطلبات | أول انخفاض |
|---|---|---|
| بيانات الفيديو / طلبات اللاعب | يمكن استخراج كامل التقاط العديد من ردود الفعل اللاعبين ودعم الموارد. | استخراج واحد لكل مصدر؛ إعادة استخدام نتيجة داخل نفس العمل. |
| البحث / قناة / قائمة اللعب | مجموعة النتائج الكبيرة تتطلب طلبات متكررة. | يربط النتائج المطلوبة ، ويظل الهوية التي تم اكتشافها وتجنب تكرار المسح بأكمله. |
| الترجمة / تليف الملاحظات | يمكن لكل لغة أو ترجمة مطلوبة إضافة طلب للقبول. | طلب اللغات المطلوبة فقط وإضافة النوم المحدد للعنوان. |
| وسائل الإعلام / الفقرات | مقاطع الفيديو الموازية والاتصالات المكسورة تشارك ميزانية طلب الخروج. | تقليل العمال، وتنافس الفقرات والاتصالات الخارجية للتحميل. |
قراءة اسم المضيف والخط قبل 429 مباشرة. يجب أن يرسل لك خطأ timedtext/caption إلى التخزين الفرعي؛ يجب أن يرسل لك طلب اللاعب إلى التخزين الاستخراج. تغيير MP4 الكوديك أو الحد من بايتات الوسائط لا يبطئ متايدات فقط.
إذا عرض yt-dlp الرسالة Sign in to confirm you’re not a bot، فاتبع دليل التحقق من الروبوتات. قد يستمر حظر عنوان IP الذي رُصد مدةً أطول من حدّ المعدل المؤقت. إذا ظهر الخطأ 403 أثناء تنزيل الوسائط، فاتبع دليل أخطاء 403.
استخدم التحكم الصحيح في السعر
| السيطرة | نطاق | ما لا يحل |
|---|---|---|
| --sleep-requests 3 | تأخير بين طلبات الاستخراج داخل هذا التنزيل. | تنسيق بين الموظفين الآخرين أو جميع مكالمات API منفصلة في تطبيقك. |
| --sleep-subtitles 5 | تأخير قبل كل عنوان تنزيل. | لا يزال هناك حبل يطلب كل لغة متوفرة من قبل العديد من العمال. |
| --sleep-interval 5 --max-sleep-interval 10 | الانتظار قبل تحميل وسائل الإعلام. | قوس يستخدم تحميل = كاذب أو --skip-download فقط للميتا بيانات. |
| --concurrent-fragments 1 | التنافس الفصيلة الأصلية داخل وظيفة وسائل الإعلام الواحدة. | عدد العمليات المنفصلة yt-dlp. |
| --limit-rate 2M | وسائل الإعلام نقل نطاق النطاق. | البحث أو المتصفح أو ترتيب طلب التردد. |
| كوخ مشترك من الخروج | إجمالي الوظائف النشطة والطلبات تنفجر من خلال واحد الخروج IP. | معدل IP يقتصر بالفعل على المستأجرين غير المرتبطين أو الوظائف. |
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--skip-download --write-subs --write-auto-subs --sub-langs "en.*" --sub-format "vtt/best" \
--sleep-requests 3 --sleep-subtitles 5 -P captions -o "%(id)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"الأرقام المذكورة أعلاه هي إعدادات البدء لإعادة التأهيل المراقبة ، لا يتم نشر حصص. زيادة الفضاء عند عودة الرفض. تسجيل الإخراج الفعال IP و حساب العامل جنبا إلى جنب مع الأخطاء بحيث لا يتضاعف العامل المبتدئ حديثا أو البروكسي المشترك بسلام معدل الطلب.
مثال Python: معدل البيانات-العمل فقط
مع download=False، وسائل الإعلام تحميل النوم ليست جدول العمل. إضافة تأخير بين المصادر وكذلك sleep_interval_requests داخل yt-dlp. ابدأ بشكل متسلسل ، وقف تشغيل فاشل وتصنيف الخطأ قبل أن تقرر متى تسحبها.
import json
import random
import time
from pathlib import Path
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget
from yt_dlp.utils import DownloadError
sources = list(dict.fromkeys(
line.strip() for line in Path("urls.txt").read_text().splitlines()
if line.strip() and not line.lstrip().startswith("#")
))
options = {
"js_runtimes": {"deno": {}},
"impersonate": ImpersonateTarget(),
"noplaylist": True,
"sleep_interval_requests": 3,
"extractor_retries": 1,
}
with Path("metadata.jsonl").open("a", encoding="utf-8") as records:
for index, source in enumerate(sources):
if index:
time.sleep(random.uniform(5, 10))
try:
with YoutubeDL(options) as downloader:
info = downloader.extract_info(source, download=False)
except DownloadError:
# Do not immediately replay a failing queue. Inspect the error;
# cool down the exit before restarting after a rate limit.
raise
record = {key: info.get(key) for key in (
"id", "webpage_url", "title", "channel_id", "duration"
)}
records.write(json.dumps(record, ensure_ascii=False) + "\n")
records.flush()لا تكتشف كل فشل في يوتيوب من خلال البحث عن سلسلة واحدة من رسائل الخطأ والنوم دون نهاية. الحفاظ على العناصر الفشل مع خطأهم ومحاولة حساب. يقع البارد المشترك في IP أو الجلسة الخروج، في حين أن الفيديو غير المتاحة هو فشل على مستوى العنصر. يجب على العمال الآخرين احترام نفس الباردة.
استبدال الخروج الذي يبقى معدل محدود
على اتصال مباشر ، هذا يعني إعادة استخدام مختلفة host/network. مع البروكسي ، يعني خروج البروكسي مختلف ، وليس مجرد عنوان بوابة مختلف. توقف العمال القدامى قبل اختبار استبدالها والحفاظ على نفس الإعدادات منخفضة الحمل.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--proxy "http://USER:PASSWORD@HOST:PORT" --sleep-requests 3 --extractor-retries 1 \
--skip-download --write-info-json -P diagnostics \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"للحصول على وظيفة وسائل الإعلام، والحفاظ على هذا الخروج مستقرة من الاستخراج من خلال التحويل؛ الدوران بين الوظائف أو قبل التقاعد الطازج. يساعد حوض البروكسي على توزيع العمل الجماعي فقط عندما تكون خروقات الحوض قابلة للاستخدام وتسيطر على معدل الخروج. إذا كان استبدال يضرب 429 على الفور أيضا، فحص الاستخدام المشترك والطوب بدلا من تسريع الدوران.
إعادة تدوير العمل دون تكرار العمل النهائي
- إعادة تشغيل الفشل الدقيق: البيانات الميتا، صفحة البحث، مسار العلامات أو تدفق وسائل الإعلام.
- ابدأ عامل واحد ومراقبة عدة عناصر. استعادة التنافس تدريجيا، مع حد لكل IP.
- إعادة استخدام الهوية المكتشفة والبيانات الميتا الموجودة بدلاً من تكرار كل البحث والاستخراج.
- الحفاظ على الملاحظات المطلوبة اللغات صريحة وإلغاء فقط المسارات المفقودة.
- استخدم الانسحابات المحدودة مع زيادة الانتظار والرصاص في الحبل المشترك.وقف الانسحاب على الفور عندما يتم رفض نفس الخروج مرة أخرى.
الحفاظ على وسائل الإعلام منفصلة وشركات التوقيع. إذا تم الانتهاء من MP4 ولكن تم الحصول على 429، والحفاظ على الملف وتخطيط إصلاح العلامة. إعادة تحميل الوسائط يضيف الحمل ولا يزال لا يحدد الكمال النصي. أرباح وسائل الإعلام وحدها ليست سجلًا للغطاء.