# إصلاح الخطأ 403 Forbidden في yt-dlp

حدّث الإصدار الليلي، وقلّل الطلبات المتزامنة، وتحقّق من Deno، ثم اختبر ملفات تعريف الارتباط وعنوان IP صالحًا للخروج.

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

- [بدأت الفشل بعد العمل](https://flashdata.dev/ar/docs/guides/yt-dlp-403-forbidden/reference.md#versions) — تحديث العامل الحقيقي إلى الليل
- [فشل مع ارتفاع المنافسة](https://flashdata.dev/ar/docs/guides/yt-dlp-403-forbidden/reference.md#rate) — انخفاض العمال والقطع والاتصالات
- [هذا البروكسي IP لا يزال يفشل](https://flashdata.dev/ar/docs/guides/yt-dlp-403-forbidden/reference.md#environment) — اختبار واحتفاظ مسار الخروج البديل
- [تحذير من تشغيل أو توكين](https://flashdata.dev/ar/docs/guides/yt-dlp-403-forbidden/reference.md#challenges) — تحقق أولاً من دينو ثم من سياق الرمز

<a id="clean-test"></a>

## ابدأ بهذه الخطوات


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

**تحديث، ثم تحقق من الوقت المطلوب**

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

استخدم عنوان URL المفقود، ثم الفيديو العام القصير كتحكم.هذا الاستطلاع الصوتي وحده يمنع FFmpeg ويحفظ اسم ملف جديد مدرجة في الوقت لكل محاولة.

**العمل على العامل المفقود.** تحقق من الرمز `Proxy map` لرحلتها الحقيقية. `--ignore-config` يزيل الخيارات المحفوظة ولكن يحتفظ بالملحقات المثبتة والبيئات البيئية.

**النجاح يعني ملف تم حفظه.** بمجرد أن يعمل الصوت، اختبر الفيديو مع `-f bv`، ثم استعادة إعدادات النتيجة الكاملة. `--simulate` و `-F` لا اختبر نقل الوسائط. `2M` هو نقطة انطلاق للتشخيص.

- [إعدادات لينكس: ليلا، دينو و curl-cffi](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#install)
- [خطأ التسجيل / بوت التحقق](https://flashdata.dev/ar/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [HTTP 429 الحد الأدنى للمعدل](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md)

<a id="versions"></a>

## 1 تحديث لليلة


**القائمة التي تعمل سابقا فجأة تفشل:** تحديث أولا.تغيرات يوتيوب لاعب يمكن أن كسر المستخلصين القديمة؛ قد تكون آخر ليلة بالفعل تحتوي على التصحيح.

**تحديث بيئة Python للعامل**

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

**إذا كنت تستخدم المطبق الرسمي بدلا من ذلك**

```bash
yt-dlp --update-to nightly
yt-dlp --version
```

yt-dlp -U فقط تحديثات داخل القناة الحالية.استخدم --update-to ليلاً للانتقال من المستقر.

إعادة تشغيل وإعادة تشغيل حاوية إذا كانت صورتها تحتوي على حزمة قديمة؛ لا يتم تحديث Python على المضيف لتحديث هذا الحاوية.

إزالة القديمة player_client، player_js_version، وتكوينات=missing_pot تتجاوز خط الأساس. يمكن للعامل من حادث قديم الآن اختيار عميل غير مناسب أو عرض تدفق لا يزال يفتقر إليه الرموز. الموضوع #14680 هو مثال على تغيير اللاعب ثابتة في الاتجاه الأعلى؛ نسخ الموجة الزمنية غير المحدودة ليست الترتيب.

- [إصدار القنوات والتحديثات](https://github.com/yt-dlp/yt-dlp#update)
- [تحدث تغيير اللاعب: #14680](https://github.com/yt-dlp/yt-dlp/issues/14680)

<a id="rate"></a>

## 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. |
| عودة نستيل | الحفاظ على كل من مستوى العمل ومستوى التحميل حسابات التقاعد محدودة؛ لا تضاعفها بين العمال. |

**استرداد تدفق الفيديو المطلوب عند الحمل المنخفض**

```bash
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 الخروج المختلف. قد يبقى مسار يوتيوب قد يرفض بعد أن توقفت حركة المرور التي أدت إلى ذلك.

- [aria2 التحكم في الاتصال](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#aria2)
- [طلب التعبئة والتغليف لمتايدات وقبعات](https://flashdata.dev/ar/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing)

<a id="challenges"></a>

## 3 تحقق من دينو


**تحقق من الاشتباكات على العامل:** يدير Deno التحديات؛ `yt-dlp-ejs` يوفر كتابات الحل، `[default]` إضافي يثبت الكتابات.

**تحقق من إدمان العمال**

```bash
deno --version
python -m pip show yt-dlp yt-dlp-ejs
python -m yt_dlp --list-impersonate-targets
```

**تحقق من اكتشاف الوقت المناسب وحل التحدي**

```bash
python -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 المتقدمة؛ استخدم نسخة مدعومة حديثة.

**خدمة لينكس مع Deno خارج PATH**

```bash
python -m yt_dlp --ignore-config --js-runtimes "deno:/opt/deno/bin/deno" --impersonate="" \
  --verbose --simulate "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

استبدال /opt/deno/bin/deno مع الواقعية قابلة للتنفيذ.في macOS أو Windows، استخدم هذا الطريق الديني المطلق للعامل بدلا من ذلك.

يتيح إضافية curl-cffi --impersonate="". يوفر بصمات الأصابع مثل المتصفح؛ فإنه لا يحل محل Deno. إذا كان الهدف المتصفح غير متاح، وتثبيت الإضافات في نفس بيئة Python. إذا كان التصميم يقدم فشلًا في مسار العمل ، فقم بمقارنة الطلب نفسه دون العلم.

بعد التحقق من الاعتماد ، يتم إعادة نقل وسائل الإعلام الحقيقية. إذا كان الليل الحالي لا يزال يبلغ عن فشل تسجيل حل لنفس اللاعب، حفظ معرف اللاعب ورسالة حل للمشكلة التي تتطابق مع مشكلة الدوران العلوي. إذا نجح حل ووسائل الإعلام تحصل على 403 ، استمر في session/IP التحقق.

- [أوقات التشغيل المدعومة وإعداد EJS](https://github.com/yt-dlp/yt-dlp/wiki/EJS)
- [إعداد Linux الكامل](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#install)

<a id="cookies"></a>

## 4: جرب الكوكيز الصحيحة لعمل صغير


**اختبار جلسة واحدة معروفة.** تأكد من أن المتصفح يمكن أن تلعب المصدر الدقيق، ثم حاول الكوكيز مع نفس الأمر والطريق.

**استخدام جلسة Firefox العاملة**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies-from-browser firefox \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

**استخدام جلسة مستوردة على عامل بلا رأس**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -f ba -o "diagnostics/%(id)s-%(epoch)s.%(ext)s" --cookies private/youtube-cookies.txt \
  "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

استخدم ملفات تعريف الارتباط في شكل Netscape.حافظ على الملف الخاص والكتابة لهذا العمل؛ للحصول على سر القراءة فقط، جعل نسخة لكل عمل.

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

للعمل الجماعي، وإدارة حوض من IPs المخرج المباشر المستخدمة والدورات على حدود العمل، مع ميزانية منخفضة لكل طلب IP. حفظ ملفات تعريف الارتباط للمصادر التي تتطلب حقا الوصول إلى الحساب. لا يسمح تغيير IP بالوصول إلى مقطع فيديو خاص أو غير متاح.

- [إجراءات تصدير الكوكيز وتجديدها](https://flashdata.dev/ar/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#renew-session)
- [نسخ الكوكيز المكتوبة في حاويات](https://flashdata.dev/ar/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md#server)

<a id="environment"></a>

## 5. استبدال خروجه المرفوضة IP


**نفس الفيديو العام، نفس الإعدادات، نتيجة مختلفة من IP:** استبدال الخروج الفشل. FlashData يرى الكثير من مستمرة 403s الناجمة عن ضعف أو علامة تجارية IPs. إعادة تثبيت yt-dlp لا يصلح هذا الطريق.

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

**اختبار جلسة استبدال بروكسي**

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

استبدال بروجين الجلسة الحقيقية بشكل خاص.يمكن لمدونة الورقة أن تعرض مصداقية البروجين؛ تحريرها قبل المشاركة.

**مقارنة الوصول المباشر للمضيف عند توفره**

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

هذا يمنع environment/configured البروكسيات للاختبار.إزالتها عندما لا يستطيع المضيف الوصول إلى YouTube مباشرة.

**مقارنة مسار IPv4 للمضيف**

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

يمكن أن يختلف مسار IPv4 يعمل عن مسار IPv6 الفشل.مع بروكسي ، لا يختار -4 بالضرورة عائلة IP الخروج من بروكسي.

| النتيجة | الإجراء التالي: |
| --- | --- |
| نفس المصدر ينجح على خروجه IP الجديد | الحفاظ على هذا الطريق ومسارها المنخفض الحمل.الخروج الفشل كوارث بدلا من إعادة التخلي عنه لكل مقطع فيديو. |
| تغيير مصداقية البروكسي لا يؤثر | تحقق من سياسة IP والجلسة الحقيقية؛ قد يستخدم البروكسي نفس الخروج. |
| لاعب يعمل، وسائل الإعلام تفشل فقط من خلال البروكسي | تحقق من الوصول إلى googlevideo.com وأن وسائل الإعلام تستخدم نفس exit/session. |
| فشل مصدر واحد في كل مسار اختبره؛ يعمل التحكم | تحقق من المصدر والترتيب والحالة الحية.لا تضع علامة على حوض البروكسي بأكمله مكسور من مقطع فيديو واحد. |

- [أحدث network/IP وطلب حجم التشخيص](https://github.com/yt-dlp/yt-dlp/issues/17103)

<a id="media-urls"></a>

## متقدمة: الحفاظ على استخراج ونقل على IP واحد


خطأ تطبيق شائع هو استخراج `info['url']` على جهاز واحد، وتخزينها في قوس واحد، وتنزيلها في وقت لاحق في مكان آخر. تنتهي عناوين URL التي تم توقيعها ويمكن أن تعتمد على عناوين IP الأصلية وطلب. يمكن لـ Proxy التدوير إنشاء نفس الانقسام حتى داخل تطبيق واحد.

قم بتوفير ID الفيديو على YouTube وإعدادات النتيجة المطلوبة. يجب على العامل إجراء استخراج جديد والتنزيل معا. إذا كان العامل يستخدم بروكسي، والحفاظ على نفس التقدم من خلال استخراج اللاعب، وتوليد الرموز وطلبات وسائل الإعلام. اسأل مزود البروكسي عن جلسة متسخة بدلاً من إعادة توجيه كل طلب HTTP.

**الحفاظ على استخراج ونقل في نفس وظيفة Python**

```python
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"])
```

هذا هو تنزيل محلي مباشر؛ لا يحتاج إلى مفتاح API. إضافة خيارات التحقق cookie/provider فقط إذا كانت الاختبارات السابقة تتطلبها.

إذا نجح هذا أثناء `requests.get(saved_media_url)` أو فشل عملية منفصلة FFmpeg، فحص هذا الفشل: العمر URL، العناوين المتوفرة من المستخرج، الكوكيز، والانحراف الحقيقي. احفظ عناوين URL من سجلات العمل المستدامة. عند استرداد نتائج الاستخراج المتأخرة، اطلب عناوين URL الطازجة من معرف الفيديو الأصلي.

- [شرح متقدم لخطأ URL المستخرج](https://github.com/yt-dlp/yt-dlp/wiki/FAQ#i-extracted-a-video-url-but-it-does-not-play-on-another-machine--in-my-web-browser)

<a id="triage"></a>

## التقدم: تحديد طلب الفشل


**طلب التسلسل**

```text
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. |

<a id="po-token"></a>

## متقدم: تثبيت مزود PO-token


استخدم هذا الفرع عندما يتم إزالة النماذج المطلوبة لتوجيه GVS المفقود ، أو يتم رفض توجيهك المحدد. يتم ربط الرموز بـ client/request ويمكن ربطها بـ ID الفيديو. لا يوجد رمز نسخ لفيديو واحد هو تصديق قابل للاستخدام مرة أخرى لقطعة كاملة. استخدم مزودًا لإنتاج الرمز للحصول على الطلب الحالي.

> **تحذير يمكن أن يصف سقوط متقطع**
> إذا كان العميل الآخر قد قدم بالفعل الملف المطلوب، فإن تحذير العميل المتسارع وحده ليس تنزيلًا فاشلًا.تحقق منه عندما يفتقر البث المطلوب أو يختفي طلب وسائل الإعلام المختارة.

يُستخدم الإعداد التالي bgutil 2.0.2. يحتوي على جزأين: ملحق Python الذي يتم تحميله بواسطة yt-dlp وخدمة JavaScript التي تنتج الرموز. الحفاظ على إصداراتهم متوافقة عند الترقية. يستخدم الأمثلة أدناه خدمة متاحة على نفس المضيف في الميناء 4416.

**قم بتثبيت المرفق في بيئة Python في yt-dlp**

```bash
python -m pip install "bgutil-ytdlp-pot-provider==2.0.2"
```

**Docker**

yt-dlp يُنقل على مستودع Docker. نشر فقط بوابة loopback.


**ابدأ المورد**

```bash
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. تشغيل الأمر الأخير في محطة منفصلة وتركه يعمل.إذا كان المجلد موجوداً بالفعل، استخدم التحقق الحالي من إصدار مطابقة.


**بناء وتشغيل المورد الأصلي**

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


**تحقق من الخدمة من بيئة التحميل**

```bash
python -c "from urllib.request import urlopen; print(urlopen('http://127.0.0.1:4416/ping', timeout=5).status)"
```

توقع HTTP 200. تشغيل هذا داخل حاوية العامل إذا كان هذا هو المكان الذي يمر فيه yt-dlp.

**طلب mweb وسائل الإعلام مع المورد**

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

**ماذا تبحث عنه في السجل**

```text
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`. لا تظهر بوابة المورد علنا.

**استخدام المورد على شبكة Docker للعامل**

```bash
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 لاحق له نفس السبب.

- [إعداد و التحقق من المورد](https://github.com/Brainicism/bgutil-ytdlp-pot-provider)
- [سياقات الرموز ومتطلبات العملاء الحالية](https://github.com/yt-dlp/yt-dlp/wiki/PO-Token-Guide)
- [الحادثة اليدوية: #17681](https://github.com/yt-dlp/yt-dlp/issues/17681)

<a id="formats"></a>

## متقدمة: تنسيق واحد أو مقطع أو البث المباشر يفشل


قائمة تنسيقات مع نفس الكوكيز والمورد وخيارات الشبكة التي فشلت في تنزيل. قم بتشغيل النموذج المفقود مباشرة. إذا كان هناك تنسيق مختلف متوفر يعمل، فقد قمت بتخفيض الفشل إلى مسار delivery/client؛ لم تكن قد حددت أن كل حل أو رمز يتم كسرها.

**قائمة بتنسيقات هذا الطلب السياق**

```bash
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
  -F "https://www.youtube.com/watch?v=jNQXAC9IVRw"
```

**اختبار الهوية المفقودة من هذه القائمة**

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

استبدال YOUR_FORMAT_ID.لإختيار مختلط، اختبر الفيديو والهوية بشكل منفصل.للمقاطع، اختبر أولاً تدفق غير مكتوب.

تحذيرات SABR تتعلق بالشكلات المقدمة من قبل العميل. إنها ليست نفس الفشل n-challenge. إذا كان الموجة العجوز `web` تنتج فقط unavailable/unsupported تنسيقات، إزالة الموجة العجوز أو استخدام المسار المكتوب mweb/provider. لا تضاف `formats=missing_pot` كإصلاح: يظهر تنسيقات دون توفير الرموز المفقودة.

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

- [تغيير تنسيق SABR: #12482](https://github.com/yt-dlp/yt-dlp/issues/12482)
- [Post-live 403 تقرير: #15586](https://github.com/yt-dlp/yt-dlp/issues/15586)

<a id="batch-recovery"></a>

## إعادة توجيه واحد العامل


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

**تطبيق التخزين على إعدادات جمعك الحالية**

```bash
python -m yt_dlp --ignore-config --config-locations yt-dlp-work.conf -t sleep --retries 3 \
  --fragment-retries 3 --batch-file urls.txt
```

استخدم التكوين الذي يحتوي على ساعات العمل والعملاء والخيارات الناتجة والملفات.تقدم النوم مساحات الطلبات داخل هذه العملية؛ فإنه لا ينسق العمال الآخرين.

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

- [إعدادات جمع قابلة للاستخدام](https://flashdata.dev/ar/docs/guides/how-to-use-yt-dlp/reference.md#repeatable)
- [Python الانتهاء و batch السجلات](https://flashdata.dev/ar/docs/guides/yt-dlp-python-api/reference.md#completion)

<a id="report"></a>

## لا يزال فاشلا؟ إعداد تقرير خطأ مفيد


- التقاط التحويل الفعلي المفقود مع --verbose ، وليس فقط نجاح --simulate سباق.
- الحفاظ على yt-dlp مراجعة، runtime/EJS الإصدارات، المورد المحمول، والخيار المختار format/protocol.
- إدراج التحذير قبل الخطأ، ما إذا كان تم طلب الرمز، وما إذا كان الفشل حدث قبل أو بعد اختيار وسائل الإعلام.
- اكتب النتائج من نفس المصدر على IPv4/direct/proxy فقط للمقارنة التي قمت بها فعلا.
- إزالة محتوى الكوكيز، وشهادات البروكسي، وURL الموقعة والتوكنات قبل مشاركة السجل.

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

- [البحث عن أسئلة upstream](https://github.com/yt-dlp/yt-dlp/issues)
- [بوت-شك وتصحيح الكوكيز](https://flashdata.dev/ar/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [تحميل YouTube المدارة](https://flashdata.dev/ar/products/youtube-download)
