# إصلاح الخطأ 429 Too Many Requests في yt-dlp

أوقف المهام على عنوان IP المقيّد، وخفّض معدّل طلبات الاستخراج والترجمة، ثم استأنف عملية واحدة.

مرجع كانوني: https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests
Reviewed: 2026-11-13 by FlashData

- [كلا الجانبين 429](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md#recover) — استراحة الخروج واختبار بعد انقطاع الطقس
- [فقط الفشل في التصوير](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing) — لغة الحد وطلبات سرعة الفرع
- [Python متايدات](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md#python) — إضافة الفضاء بين المصادر
- [IP لا يزال معدل محدود](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md#exit-ip) — اختبار خروجه بديلاً عند الحمل المنخفض

<a id="recover"></a>

## أوقف المهام وانتظر ثم اختبر مرة واحدة


1. **أوقف استخدام عنوان IP المتأثر.** أوقف كل العمليات التي تشارك عنوان الخروج ومحاولات الإعادة الفورية.
2. **حدّث الإصدار الليلي.** راجع حزمة yt-dlp وDeno في بيئة التشغيل أثناء التوقف.
3. **اترك مهلة قبل إعادة المحاولة.** ابدأ ببضع دقائق. التزم بالمدة في `Retry-After` إن وُجدت، وانتظر مدة أطول عند الحاجة.
4. **اختبر مصدرًا واحدًا.** بعد نجاح الاختبار، استأنف عملية واحدة مع ترك فواصل بين الطلبات.
5. **غيّر عنوان الخروج عند الحاجة.** واصل استخدام معدّل الطلبات المنخفض على العنوان الجديد.

**تحديث قاعدة الاستخراج أثناء الفراغ**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
```

**دراسة متايدات بعد الجليد**

```bash
python -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"
```

هذه الإعدادات تسارع هذه العملية؛ لا تتوقف عن العملية الأخرى باستخدام نفس IP.

**توقف عن الحصول على 429؟** انتظر لفترة أطول أو تغيير الخروج.تحديث yt-dlp لا يعود إلى حد معدل IP الحالي؛ اختبار المظاهر الكاملة يضيف فقط الحمل.

<a id="identify"></a>

## العثور على طلب محدّد


| العمل الفشل | لماذا يمكن أن يولد الكثير من الطلبات | أول انخفاض |
| --- | --- | --- |
| بيانات الفيديو / طلبات اللاعب | يمكن استخراج كامل التقاط العديد من ردود الفعل اللاعبين ودعم الموارد. | استخراج واحد لكل مصدر؛ إعادة استخدام نتيجة داخل نفس العمل. |
| البحث / قناة / قائمة اللعب | مجموعة النتائج الكبيرة تتطلب طلبات متكررة. | يربط النتائج المطلوبة ، ويظل الهوية التي تم اكتشافها وتجنب تكرار المسح بأكمله. |
| الترجمة / تليف الملاحظات | يمكن لكل لغة أو ترجمة مطلوبة إضافة طلب للقبول. | طلب اللغات المطلوبة فقط وإضافة النوم المحدد للعنوان. |
| وسائل الإعلام / الفقرات | مقاطع الفيديو الموازية والاتصالات المكسورة تشارك ميزانية طلب الخروج. | تقليل العمال، وتنافس الفقرات والاتصالات الخارجية للتحميل. |

قراءة اسم المضيف والخط قبل 429 مباشرة. يجب أن يرسل لك خطأ timedtext/caption إلى التخزين الفرعي؛ يجب أن يرسل لك طلب اللاعب إلى التخزين الاستخراج. تغيير MP4 الكوديك أو الحد من بايتات الوسائط لا يبطئ متايدات فقط.

إذا عرض yt-dlp الرسالة `Sign in to confirm you’re not a bot`، فاتبع دليل التحقق من الروبوتات. قد يستمر حظر عنوان IP الذي رُصد مدةً أطول من حدّ المعدل المؤقت. إذا ظهر الخطأ 403 أثناء تنزيل الوسائط، فاتبع دليل أخطاء 403.

- [التحقق باستمرار من تسجيل الدخول](https://flashdata.dev/ar/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [الوسائط HTTP 403](https://flashdata.dev/ar/docs/guides/yt-dlp-403-forbidden/reference.md)

<a id="pacing"></a>

## استخدم التحكم الصحيح في السعر


| السيطرة | نطاق | ما لا يحل |
| --- | --- | --- |
| --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 يقتصر بالفعل على المستأجرين غير المرتبطين أو الوظائف. |

**جمع فقط المسارات المختارة، مع التخطيط**

```bash
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"
```

استخدم علامة لغة واحدة مثل en إذا كانت مجموعات البيانات الخاصة بك تحتاج فقط إلى هذا المسار. en.* يمكن أن يطلب عدة إصدارات.

الأرقام المذكورة أعلاه هي إعدادات البدء لإعادة التأهيل المراقبة ، لا يتم نشر حصص. زيادة الفضاء عند عودة الرفض. تسجيل الإخراج الفعال IP و حساب العامل جنبا إلى جنب مع الأخطاء بحيث لا يتضاعف العامل المبتدئ حديثا أو البروكسي المشترك بسلام معدل الطلب.

<a id="python"></a>

## مثال Python: معدل البيانات-العمل فقط


مع download=False، وسائل الإعلام تحميل النوم ليست جدول العمل. إضافة تأخير بين المصادر وكذلك sleep_interval_requests داخل yt-dlp. ابدأ بشكل متسلسل ، وقف تشغيل فاشل وتصنيف الخطأ قبل أن تقرر متى تسحبها.

**العامل المتعدد البيانات المتسلسلة عن قصد**

```python
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()
```

إنشاء urls.txt مع عنوان URL الفيديو واحد في الخط.هذا المثال الحد الأدنى يتوقف على أي خطأ في التنزيل؛ يجب على قناة الإنتاج تصنيف الفشل، وتحديد النقاط التحقق، ومنع تكرار السجلات على التجديد.

لا تكتشف كل فشل في يوتيوب من خلال البحث عن سلسلة واحدة من رسائل الخطأ والنوم دون نهاية. الحفاظ على العناصر الفشل مع خطأهم ومحاولة حساب. يقع البارد المشترك في IP أو الجلسة الخروج، في حين أن الفيديو غير المتاحة هو فشل على مستوى العنصر. يجب على العمال الآخرين احترام نفس الباردة.

<a id="exit-ip"></a>

## استبدال الخروج الذي يبقى معدل محدود


على اتصال مباشر ، هذا يعني إعادة استخدام مختلفة host/network. مع البروكسي ، يعني خروج البروكسي مختلف ، وليس مجرد عنوان بوابة مختلف. توقف العمال القدامى قبل اختبار استبدالها والحفاظ على نفس الإعدادات منخفضة الحمل.

**اختبار واحد يسيطر عليه من خلال خروجه بديلا**

```bash
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 و جلسات اللمس](https://flashdata.dev/ar/docs/guides/yt-dlp-403-forbidden/reference.md#environment)

<a id="resume"></a>

## إعادة تدوير العمل دون تكرار العمل النهائي


1. إعادة تشغيل الفشل الدقيق: البيانات الميتا، صفحة البحث، مسار العلامات أو تدفق وسائل الإعلام.
2. ابدأ عامل واحد ومراقبة عدة عناصر. استعادة التنافس تدريجيا، مع حد لكل IP.
3. إعادة استخدام الهوية المكتشفة والبيانات الميتا الموجودة بدلاً من تكرار كل البحث والاستخراج.
4. الحفاظ على الملاحظات المطلوبة اللغات صريحة وإلغاء فقط المسارات المفقودة.
5. استخدم الانسحابات المحدودة مع زيادة الانتظار والرصاص في الحبل المشترك.وقف الانسحاب على الفور عندما يتم رفض نفس الخروج مرة أخرى.

الحفاظ على وسائل الإعلام منفصلة وشركات التوقيع. إذا تم الانتهاء من MP4 ولكن تم الحصول على 429، والحفاظ على الملف وتخطيط إصلاح العلامة. إعادة تحميل الوسائط يضيف الحمل ولا يزال لا يحدد الكمال النصي. أرباح وسائل الإعلام وحدها ليست سجلًا للغطاء.

- [بيانات وسائل الإعلام وملفات التوقيع](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#dataset)
- [Python العامل و سجلات الانتهاء](https://flashdata.dev/ar/docs/guides/yt-dlp-python-api/reference.md)
- [أضف تعليق 429](https://github.com/yt-dlp/yt-dlp/wiki/FAQ#http-error-429-too-many-requests-or-402-payment-required)
- [توجيهات سعر طلب يوتيوب](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#this-content-isnt-available-try-again-later)
