استكشاف أخطاء دفق RTSP وإصلاحها: الدليل التشخيصي الكامل لتدفقات الكاميرا

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

الفرز السريع: أين الفشل؟

قبل قراءة أي صفحة معينة، حدد الطبقة التي فشلت:

1. هل يستطيع العميل الوصول إلى الكاميرا؟ → مشاكل في طبقة الاتصال
2. ** هل يقوم DESCRIBE بإرجاع SDP صالح؟ ** → مشاكل مستوى التحكم
3. هل تصل حزم RTP ويتم فك تشفيرها بشكل صحيح؟ → مشاكل في مستوى الوسائط

إذا كنت لا تعرف الطبقة التي فشلت، فابدأ بـ سير عمل التشخيص المنهجي.

---

Connection layer: reaching the camera

---

مستوى التحكم: أخطاء أمر RTSP

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

400 طلب سيء

• طلب RTSP 400 غير صحيح: فشل الوصف — عنوان URL غير صحيح، ورؤوس غير مدعومة، وتداخل في الخادم الوكيل. يغطي تنسيقات عناوين URL للمحور وDahua وHikvision.

401 غير مصرح به

• حلقة مصادقة RTSP 401 — Digest مقابل المصادقة الأساسية، معلمات nonce/realm، لماذا تنجح المصادقة في VLC ولكنها تفشل في تطبيقك.

• الغوص العميق في مصادقة ملخص RTSP — انتهاء الصلاحية بدون تاريخ، مطابقة المجال، لا معنى لها = معالجة حقيقية.

• تشخيص عنوان URL للكاميرا 401/404 — عندما يعمل عنوان URL في عميل واحد وليس في عميل آخر.

404 غير موجود

• تشخيص عنوان URL للكاميرا 401/404 — مسار بث خاطئ، وتنسيقات URL خاصة بالكاميرا.

• عنوان URL للتحكم المجمع وإعداد SDP 404 — عندما لا يتطابق عنوان URL للتحكم في SDP مع عنوان URL للوصف.

454 الجلسة غير موجودة

• لم يتم العثور على جلسة RTSP 454 — معرف الجلسة غير متطابق، الجلسات منتهية الصلاحية، العب قبل الإعداد.

461 النقل غير معتمد

• نقل غير مدعوم RTSP 461: فشل الإعداد — تفاوض نقل UDP مقابل TCP، ffmpeg "فشل إعداد الطريقة: 461"، أخطاء تكامل الفرقاطة/المشفرة/NVR.

500 / 503 أخطاء الخادم

• خطأ داخلي في الخادم RTSP 500 — فشل من جانب الكاميرا. متى يتم الانتهاء من البرامج الثابتة للكاميرا؟

• خدمة RTSP 503 غير متاحة — استنفاد موارد الكاميرا، وجود عدد كبير جدًا من عمليات البث المتزامنة، وحدود النطاق الترددي.

النقل والشبكات

• تم حظر UDP RTP بواسطة جدار الحماية/NAT — يعمل التحكم في RTSP ولكن يتم حظر وسائط UDP RTP. قواعد جدار الحماية، اجتياز NAT، تكوين منفذ بروتوكول RTSP، احتياطي TCP المشذر.

• عدم تطابق قناة TCP المشذرة — عندما لا تتطابق قنوات RTP/RTCP المشذرة بين العميل والخادم.

• رد خادم النقل غير المطابق — يستجيب الخادم بمعلمات نقل مختلفة عن المطلوبة.

• تصحيح أخطاء UDP المتعدد — تكوين RTSP/RTP للبث المتعدد، وIGMP، وTTL، والبنية الأساسية للشبكة.

• مهلة RTSP: UDP مقابل TCP معشق — لماذا تنتهي مهلة البث بشكل مختلف على UDP مقابل TCP.

---

Media plane: RTP, codec, and payload problems

RTP packet analysis

H.264 and H.265 codec issues

Audio and metadata tracks

ONVIF and camera-specific

---

RTCP وإدارة الجلسة

• تقارير مرسل RTCP: الارتعاش والخسارة — قراءة حزم RTCP SR لفهم جودة الشبكة من منظور الكاميرا.

• RTCP BYE: ينتهي البث بشكل غير متوقع — عندما ترسل الكاميرا RTCP BYE وتنهي البث.

• RTCP CNAME ومزامنة الصوت/الفيديو — استخدام RTCP CNAME لمزامنة مسارات الصوت والفيديو.

• RTSP TEARDOWN وتنظيف الجلسة — تسرب موارد الكاميرا، وفشلت إعادة الاتصال، وحالة البث المزدحم.

• مهلة جلسة RTSP والبقاء على قيد الحياة — لماذا تتوقف عمليات البث بعد 30 ثانية تقريبًا وكيفية إبقائها نشطة.

• رأس نطاق RTSP وNPT — التحكم في موضع التشغيل باستخدام معلمات Range وNPT.

• رأس مقياس RTSP وتشغيل الخدعة — التقديم السريع والترجيع والتحكم في السرعة عبر رأس Scale.

---

Comparison and alternatives

---

ابدء

هل أنت جديد في تشخيصات RTSP؟ ابدأ هنا:

1. سير العمل التشخيصي المنهجي — النموذج ثلاثي الطبقات ومجموعة الأدلة.
2. الاتصال بالبث — إعداد اتصال RTSP الأول.
3. دليل استكشاف الأخطاء وإصلاحها — الأعطال الشائعة وإصلاحاتها.

<!-- rtsp-localized-evidence-foundation-v1:start -->

خطة إثبات عملية لموضوع «استكشاف أخطاء دفق RTSP وإصلاحها: الدليل التشخيصي الكامل لتدفقات الكاميرا»

الإجابة المباشرة هي أن تشخيص بث كاميرا لا يعتمد على ظهور صورة أو على رمز خطأ منفرد. يجب ربط النتيجة بطلب RTSP وردّه، وباختيار Transport، وبهوية جلسة صالحة، ثم بأرقام تسلسل RTP والطوابع الزمنية وبيانات RTCP عند وصول الوسائط. في موضوع «استكشاف أخطاء دفق RTSP وإصلاحها: الدليل التشخيصي الكامل لتدفقات الكاميرا» ابدأ بأقرب طبقة إلى العرض الظاهر، لكن احتفظ بسجل زمني واحد حتى لا تختلط مشكلة التحكم بمشكلة الشبكة أو برنامج فك الترميز.

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

طبقة الفحص	الدليل الذي يجب حفظه	سؤال القرار
RTSP	الطلب، الحالة، الرؤوس، CSeq وSession	هل وافق الخادم على العملية نفسها؟
SDP	control وpayload type وclock rate وcodec	هل وصف الخادم المسار الذي سيُستقبل؟
Transport	client_port أو interleaved وقيمة server_port	هل يرسل الطرفان عبر القناة نفسها؟
RTP	SSRC والتسلسل والطابع الزمني وmarker	هل تصل وحدات الوسائط بترتيب يمكن تفسيره؟
RTCP	sender report وCNAME وBYE	هل توجد ساعة وهوية ونهاية جلسة قابلة للتتبع؟
Decoder	SPS/PPS/VPS وpacketization mode	هل البيانات الواصلة قابلة للتهيئة وفك الترميز؟

افصل دائمًا بين «لم تصل وسائط» و«وصلت وسائط غير قابلة للفك». غياب حزم RTP بعد SETUP وPLAY يشير إلى مسار UDP أو NAT أو جدار ناري أو رد Transport غير متطابق. وصول RTP مع فجوات في التسلسل يثبت فقدًا أو إعادة ترتيب. وصول تسلسل متماسك مع فشل الصورة ينقل التحقيق إلى payload type وclock rate وحدود الإطار ومعلمات H.264 أو H.265. هذه الحدود أهم من رسالة اللاعب العامة لأنها تحدد المالك المحتمل للإصلاح.

كيف تُكتب إجابة قابلة للاقتباس؟

اكتب النتيجة في ثلاث جمل: العملية التي نجحت، أول دليل أخفق، والتجربة التالية التي تفصل بين سببين. مثال البنية هو: «نجح DESCRIBE وSETUP وPLAY؛ لم تصل أي حزمة RTP إلى منافذ العميل المعلن عنها؛ إعادة الاختبار عبر TCP interleaved ستفصل بين حجب UDP وخطأ عنوان المسار». لا تقل إن الكاميرا أو الشبكة «معطلة» من دون حزمة أو رد يثبت الحد.

ما الحد الأدنى لإعادة إنتاج المشكلة؟

احتفظ بنسخة من تبادل OPTIONS وDESCRIBE وSETUP وPLAY، ونص SDP، ورد Transport، ومعرّف Session بعد إخفاء الأسرار. بالنسبة للوسائط، سجّل SSRC وأول وآخر رقم تسلسل ومعدل الساعة وعدد الفجوات ومدة الالتقاط. اذكر هل يعمل VLC أو VMS آخر، لكن تعامل مع ذلك كاختبار فرق لا كدليل أن الطرف الآخر صحيح في كل شيء.

متى يجب فحص الخادم بدل العميل؟

افحص الخادم عندما يرفض العملية بحالة واضحة، أو يغيّر عنوان control إلى مسار غير موجود، أو يعيد Transport لا يطابق العرض، أو يبدّل SSRC والساعة من دون انتقال معلن. افحص العميل عندما يكرر nonce قديمًا، أو يرسل Session مفقودة، أو يطلب UDP ثم لا يفتح المنافذ، أو يفسر marker بوصفه نهاية كل NAL. قد يكون العطل بينهما؛ لذلك يجب أن تبقى الحزمة والوقت جزءًا من التقرير.

كيف تُراجع النتيجة قبل التسليم؟

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

<!-- rtsp-localized-evidence-foundation-v1:end --><!-- rtsp-localized-layer-verdicts-v1:start -->

من الملاحظة إلى حكم طبقي قابل للمراجعة

في «استكشاف أخطاء دفق RTSP وإصلاحها: الدليل التشخيصي الكامل لتدفقات الكاميرا» اكتب الملاحظة قبل تفسيرها. الملاحظة هي شيء يمكن لشخص آخر العثور عليه في السجل: حالة RTSP مرتبطة بـCSeq، أو قيمة في SDP، أو رد Transport، أو فجوة بين رقمين متتاليين، أو تغير SSRC، أو اختلاف بين RTP timestamp وRTCP sender report. أما عبارات مثل «الخادم بطيء» و«الترميز غير متوافق» فهي فرضيات حتى تحدد الحزمة التي تجعلها أرجح من البدائل.

قسّم القضية إلى نقاط حدود. الحد الأول هو فتح اتصال TCP. الثاني هو قبول OPTIONS أو DESCRIBE. الثالث هو أن يصف SDP مسارًا وعرضًا يمكن للعميل استخدامهما. الرابع هو SETUP مع Transport متوافق. الخامس هو PLAY مع Session صحيحة. السادس هو وصول RTP، ثم سلامة الترتيب والتوقيت، ثم استعداد برنامج فك الترميز. توقف عند أول حد لا يملك دليل نجاح؛ الأدلة اللاحقة لا تصلح لإخفاء غياب دليل سابق.

عند مقارنة تجربتين، ثبّت المصدر والوقت قدر الإمكان. إذا اختبرت UDP مقابل TCP interleaved، استخدم عنوان المسار وبيانات الاعتماد نفسها. إذا اختبرت main stream مقابل sub stream، أبق النقل والعميل ثابتين. إذا قارنت VLC مع VMS، سجّل الطلبات التي يرسلها كل عميل بدل الاكتفاء بأن أحدهما يعرض صورة. الاختلاف في control URL أو Authorization أو Session أو keepalive قد يفسر النتيجة أكثر من اسم البرنامج.

مصفوفة الاستبعاد

ابدأ بفرضيتين فقط. مثال: لا توجد وسائط بسبب حجب UDP، أو لأن الخادم يرسل إلى منافذ مختلفة. يختبر TCP interleaved الفرضية الأولى، بينما مقارنة عرض Transport بردّه واستخراج عناوين IP والمنافذ تختبر الثانية. بالنسبة للصورة المشوهة، قارن فرضية فقد RTP بفرضية تهيئة codec ناقصة: أرقام التسلسل تفصل الأولى، ووجود SPS/PPS/VPS قبل أول إطار يفصل الثانية.

لكل فرضية اكتب دليلًا مؤيدًا ودليلًا يمكن أن ينفيها. إذا لم توجد حزمة يمكن أن تنفي الادعاء، فهو واسع أكثر من اللازم. «الـNAT أسقط UDP» يمكن نفيه بوصول RTP إلى منفذ العميل؛ «لا توجد معلمات H.264» يمكن نفيه برؤية SPS وPPS صالحتين قبل IDR. هذه الصياغة تمنع التقرير من التحول إلى قائمة احتمالات بلا ترتيب.

التعامل مع الزمن من دون استنتاج زائد

RTSP CSeq يرتب معاملات التحكم، وRTP sequence يوضح ترتيب الحزم، وRTP timestamp يوضح زمن أخذ عينات الوسائط، بينما وقت الالتقاط يوضح وصول الحزمة إلى نقطة الرصد. لا تساوِ هذه الساعات. فرق وقت الوصول لا يثبت انجراف timestamp، وقفزة timestamp لا تثبت فقد حزمة من دون تسلسل. عند مزامنة الصوت والفيديو، استخدم RTCP sender reports لربط ساعات RTP بزمن مشترك، ولا تعتمد على تشابه أرقام timestamp بين clock rates مختلفة.

حزمة القبول النهائية

يُغلق التحقيق عندما يمكن تكرار الإصلاح في اتصال جديد وبإعداد واحد موثق. يجب أن يوضح التقرير المدخلات، وآخر خطوة ناجحة، وأول دليل فاشل، والتغيير، ونتيجة إعادة الاختبار، وما لم يُختبر. أرفق مقطعًا صغيرًا من السجل أو إحصاءات الحزم بدل ملف ضخم غير محدد. أخفِ الأسرار، لكن لا تحذف CSeq أو Session المموهة أو SSRC أو النطاق الزمني الذي يجعل النتيجة قابلة للمراجعة.

إذا بقيت المشكلة، استخدم استكشاف أخطاء RTSP لإعادة بناء التسلسل، أو تقارير RTSP Inspector لتسليم الحد الفاشل إلى فريق الكاميرا أو الشبكة أو VMS.

<!-- rtsp-localized-layer-verdicts-v1:end -->