پرش به محتوا

عیب‌یابی تماس ناموفق SIP در Asterisk؛ از کد پاسخ تا علت شکست

تشخیص بخش شکست تماس با ردگیری PJSIP، لاگ کانال و آزمون فرضیه
29 آبان 1405 توسط
عیب‌یابی تماس ناموفق SIP در Asterisk؛ از کد پاسخ تا علت شکست
سینا طیفوری

برای عیب‌یابی تماس ناموفق SIP در Asterisk، ابتدا درخواست شکست‌خورده، پاسخ نهایی و سمت صادرکنندهٔ آن را مشخص کنید. سپس پیام SIP را کنار لاگ پردازش تماس بگذارید. شنیدن بوق اشغال، دیدن یک کد ۴۰۳ یا حتی ثبت موفق ترانک، علت را به‌تنهایی تعیین نمی‌کند. خروجی مفید بررسی باید نشان دهد تماس تا کجا پیش رفته، کدام شاهد فرضیه را تأیید می‌کند و آزمون بعدی چیست.

این راهنما برای مدیر تلفنی است که تماس برقرار نمی‌شود و می‌خواهد پیش از تغییر رمز، مسیر یا فایروال، نقطهٔ شکست را پیدا کند. فرمان‌ها بر مبنای Asterisk 22 با درایور PJSIP نوشته شده‌اند؛ در Issabel و توزیع‌های دیگر ابتدا نسخه و درایور واقعی را بررسی کنید. این مقاله گزارش رخداد مشتری یا نتیجهٔ آزمون یک سامانهٔ تولیدی نیست.

کاور مفهومی است؛ نمودار زیر، گردش پیشنهادی تشخیص را نشان می‌دهد.

۱. پروندهٔ تماس را پیش از دست‌کاری تنظیمات بسازید

یک تماس آزمایشی مجاز با مقصد مشخص انتخاب کنید. زمان دقیق همراه منطقهٔ زمانی، جهت تماس، داخلی مبدأ، مقصد، ترانک منتخب و علامت شنیده‌شده را در پروندهٔ داخلی ثبت کنید. مشخص کنید مشکل همهٔ مقصدها را درگیر کرده یا فقط یک گروه شماره را؛ تماس ورودی و خروجی را نیز جدا نگه دارید. مقایسه با یک تماس سالم از همان مسیر، برای محدودکردن دامنهٔ بررسی مفید است.

ثبت ترانک و برقراری تماس دو آزمون متفاوت‌اند. در مستند ثبت خروجی PJSIP، وضعیت ثبت با فرمان جداگانه دیده می‌شود؛ مشاهدهٔ Registered به معنی پذیرش همهٔ درخواست‌های INVITE یا مجازبودن هر شمارهٔ مقصد نیست. بعضی ترانک‌ها نیز به‌جای ثبت، بر شناسایی نشانی مبدأ متکی‌اند. بنابراین نبود رکورد ثبت را بدون شناخت قرارداد سرویس، خرابی اعلام نکنید.

asterisk -rx 'core show version'
asterisk -rx 'module show like res_pjsip'
asterisk -rx 'pjsip show registrations'
asterisk -rx 'pjsip show endpoints'
asterisk -rx 'core show help pjsip set logger'

این فرمان‌ها برای مشاهده و شناخت قابلیت‌های نسخه‌اند. اگر PJSIP در دسترس نیست، فرمان‌های آن را به درایور دیگری تعمیم ندهید. نام endpoint و نام registration لزوماً یکی نیستند. خروجی‌ها ممکن است شماره، نام حساب یا نشانی شبکه داشته باشند؛ فایل خام را در محل محدود نگه دارید و نسخهٔ پاک‌سازی‌شده را برای تبادل آماده کنید.

۲. ردگیری کوتاه بگیرید و دو سمت تماس را جدا بخوانید

پیش از ثبت پیام‌ها، وضعیت فعلی logger را بررسی و برای بازگرداندن همان وضعیت یادداشت کنید. اگر خاموش است و اجازهٔ عیب‌یابی دارید، در کنسول تعاملی Asterisk فقط برای یک بازهٔ کوتاه آن را روشن کنید، یک تماس بسازید و بلافاصله به وضعیت قبلی برگردانید. روشن‌کردن logger صرفاً مشاهدهٔ تنظیمات نیست؛ حجم خروجی و دادهٔ ثبت‌شده را افزایش می‌دهد. راهنمای گردآوری اطلاعات عیب‌یابی Asterisk این ابزار را معرفی می‌کند.

pjsip set logger on
; Reproduce one authorized test call, then restore the prior state.
pjsip set logger off

خطی که با نقطه‌ویرگول شروع می‌شود توضیح است؛ آن را در کنسول وارد نکنید. اگر logger از قبل روشن یا دارای فیلتر بوده، خاموش‌کردن کورکورانه ممکن است بررسی هم‌زمان دیگری را مختل کند؛ دستورهای موجود و فیلترها را با help همان نسخه بررسی کنید. نحو و رفتار logger را می‌توان با کد رسمی شاخهٔ 22 تطبیق داد.

در هر بخش، Call-ID، مقدار و روش CSeq، جهت دریافت یا ارسال و ترتیب زمانی را کنار هم بخوانید. Asterisk میان تماس ورودی و خروجی کانال‌های جدا می‌سازد؛ جست‌وجوی یک Call-ID واحد در سراسر مسیر کافی نیست. اتصال دو بخش را با نام کانال، زمان و شواهد اجرای Dial مشخص کنید. پاسخ مربوط به OPTIONS یا REGISTER را پاسخ INVITE فرض نکنید.

مسیر بررسی تماس ناموفق: پروندهٔ تماس، تفکیک دو سمت، پاسخ نهایی و آزمون فرضیه
گردش پیشنهادی بررسی؛ کد پاسخ، آغاز بررسی است و برای اثبات علت به شاهد تکمیلی نیاز دارد. برای مشاهدهٔ اندازهٔ اصلی روی تصویر بزنید.

ردگیری SIP می‌تواند شناسهٔ تماس، شماره‌ها، سرآیندهای احراز هویت و اطلاعات SDP داشته باشد. این داده‌ها را عمومی نکنید. پیش از ارسال برای پشتیبانی، Authorization و Proxy-Authorization و اطلاعات خصوصی را حذف کنید؛ شناسه‌های جایگزین را در همهٔ خطوط یکسان نگه دارید تا ارتباط پیام‌ها از بین نرود.

۳. کد پاسخ را به پرسش تشخیصی تبدیل کنید

جدول زیر معنای کوتاه کدها بر پایهٔ RFC 3261، بخش ۲۱ و پرسش پیشنهادی برای ادامهٔ بررسی است. ستون آخر توصیهٔ عملی است، نه رابطهٔ قطعی میان یک کد و یک تنظیم.

پاسخمعنای پایهپرسش بعدی
401 / 407درخواست احراز هویتآیا درخواست بعدی با احراز هویت پذیرفته شد؟
403رد درخواستکدام سمت و با چه سیاست یا پیام همراهی رد کرده است؟
404کاربر یا دامنهٔ مقصد شناخته نشدRequest-URI در همان بخش چه بود؟
408مهلت پاسخ سپری شدپاسخ واقعی دریافت شد یا خطای محلی ثبت شد؟
480 / 486عدم دسترسی موقت / اشغال در این مقصدوضعیت واقعی مقصد و مسیر جایگزین چیست؟
487درخواست خاتمه یافتهآیا پیش از آن CANCEL دیده می‌شود؟
488پارامترهای نشست پذیرفته نشدپیشنهاد رسانه با قابلیت و سیاست مقصد سازگار است؟
503سرویس موقتاً در دسترس نیستپاسخ‌دهنده و راهنمای Retry-After چه می‌گویند؟

برای ۴۰۱ تکرارشونده، فقط رمز را مظنون ندانید. راهنمای عیب‌یابی رسمی PJSIP توضیح می‌دهد که درخواستِ فاقد endpoint قابل شناسایی هم می‌تواند با چالش ظاهری احراز هویت روبه‌رو شود. نخست وجود و شناسایی endpoint را با لاگ تطبیق دهید؛ سپس نام کاربری، realm و رابطهٔ auth را بررسی کنید. بخش‌هایی از این راهنما نمونه‌های قدیمی دارد؛ تنظیمات نمونه را بدون تطبیق نسخه کپی نکنید.

در ۴۸۸، نبود کدک مشترک یک فرضیه است. SDP و پیام تشخیصی همان سمت را بررسی کنید؛ برای آزمایش، حفاظت رسانه را خاموش نکنید. توضیح مکمل دربارهٔ مرز امنیت سیگنالینگ و رسانه در راهنمای TLS و SRTP آمده است. اگر تماس پاسخ داده شده ولی صدا مشکل دارد، مسیر بررسی SDP و RTP برای صدای یک‌طرفه مناسب‌تر است.

۴. مثال فرضی: چرا پیام نهایی گوشی کافی نیست؟

فرض کنید تماس آزمایشی از داخلی به یک مقصد بیرونی ناموفق است. گوشی ابتدا چالش احراز هویت می‌گیرد، درخواست بعدی پذیرفته می‌شود و Asterisk کانال خروجی می‌سازد. در سمت ترانک، INVITE با پاسخ ۴۰۳ پایان می‌یابد و گوشی بوق اشغال می‌شنود. این یک سناریوی آموزشی است؛ زمان، حساب یا نتیجهٔ واقعی مشتری در آن استفاده نشده است.

شاهد موجود، رسیدن درخواست به پاسخ‌دهندهٔ سمت ترانک و ردشدن آن در همان بخش است. این شاهد به‌تنهایی نه خرابی رمز داخلی را ثابت می‌کند، نه تمام شبکهٔ اپراتور را مقصر می‌داند. گام بعدی، مقایسهٔ شمارهٔ ارسال‌شده، هویت تماس‌گیرنده و سیاست مجاز سرویس با قرارداد اپراتور و یک تماس سالم است. پیش از تغییر، مسئول بررسی و معیار نتیجه را مشخص کنید.

برای هر فرضیه سه جمله بنویسید: «چه دیدیم»، «چه نتیجه‌ای هنوز قابل اثبات نیست» و «کدام آزمون ابهام را کم می‌کند». اگر فقط یک مقصد مشکل دارد، تعمیم آن به همهٔ ترانک‌ها کمکی نمی‌کند. اگر هیچ INVITE خروجی ساخته نشده، بررسی مسیر و انتخاب مقصد را جلو بیندازید؛ راهنمای مسیریابی تماس ورودی در Issabel برای سمت ورودی این مسئله، مسیر مستقلی ارائه می‌دهد.

۵. وضعیت Dial، علت قطع و پاسخ SIP را مخلوط نکنید

متغیر DIALSTATUS نتیجهٔ اجرای Dial را با مقادیری مانند BUSY، NOANSWER و CONGESTION بیان می‌کند؛ این خروجی عین کد پاسخ SIP نیست. در مرجع Dial در Asterisk 22 تعریف این وضعیت‌ها آمده است. پیام رابط کاربری یا یک سطر گزارش را بدون ردگیری مرتبط، تشخیص نهایی ننامید.

قابلیت‌های Hangup Cause برای بررسی علت قطع کانال‌های درگیر طراحی شده‌اند. در شماره‌گیری چندمقصدی، نتیجهٔ کانال‌ها ممکن است متفاوت باشد. تبدیل علت‌ها نیز اطلاعات را خلاصه می‌کند؛ جدول نگاشت رسمی Asterisk را همراه نسخه و درایور بخوانید. افزودن کد به dialplan تولید صرفاً برای تکمیل گزارش، بدون پشتیبان و مجوز تغییر، گام نخست مناسبی نیست.

سرآیند Reason نیز ممکن است وجود داشته باشد. مطابق RFC 3326، مقدار cause با نوع پروتکل تفسیر می‌شود: در Reason از نوع SIP، عدد کد SIP است؛ در نوع Q.850، عدد علت Q.850 است. عدد یکسان در این دو فضا الزاماً معنی یکسانی ندارد. نبود این سرآیند هم مجوز ساختن علت از روی حدس نیست.

۶. پرونده را با شاهد و معیار پذیرش تحویل دهید

برای ارجاع به تیم شبکه یا اپراتور، نسخهٔ پاک‌سازی‌شدهٔ ردگیری، زمان با منطقهٔ زمانی، جهت تماس، بخش درگیر و نتیجهٔ تماس مقایسه‌ای را آماده کنید. درخواست مشخص باشد: مثلاً «علت رد این INVITE در سمت سرویس را با شناسهٔ جایگزین بررسی کنید». ارسال یک عکس از بوق اشغال یا انبوه لاگ نامرتبط، مسئله را قابل پیگیری نمی‌کند.

اگر اصلاحی مجاز شد، ابتدا خط مبنا و نسخهٔ قابل بازگشت تنظیمات را نگه دارید و هر بار یک متغیر را تغییر دهید. پذیرش فقط حذف کد خطا نیست: تماس مقصد آزمایشی باید پاسخ بگیرد، دوطرفه شنیده شود و عادی قطع شود؛ مسیر سالم قبلی نیز دوباره آزموده شود. پس از بررسی، logger را به وضعیت اولیه برگردانید و نگهداری فایل‌ها را طبق سیاست سازمان محدود کنید.

جمع‌بندی: عیب‌یابی تماس ناموفق SIP با تشخیص بخش شکست و کنارهم‌گذاشتن شواهد پیش می‌رود. جدول کدها کمک می‌کند پرسش درست بسازید؛ پاسخ نهایی باید از ردگیری، لاگ و آزمون مشخص پشتیبانی شود. برای بررسی ساختاریافتهٔ سامانهٔ تلفنی خود می‌توانید از آسیاپرداز درخواست مشاوره کنید؛ اطلاعات محرمانه یا فایل خام را در فرم عمومی قرار ندهید.

کنترل دسترسی چندشرکتی در Odoo 19؛ راهنمای آزمون Record Rules
از مجوز مدل و قواعد گروهی تا شرکت فعال و آزمون دسترسی ممنوع