«UNABLE_TO_GET_ISSUER_CERT_LOCALLY» على Mac

يعني UNABLE_TO_GET_ISSUER_CERT_LOCALLY أن Node.js لا يجد الجهة التي وقّعت الشهادة. السبب المعتاد وكيل يفحص TLS أو جهة خاصة.

أصلحها مع وكيلكينسخ طلبًا لـ Claude Code أو Codex أو أي وكيل يستطيع استخدام الطرفية.

يواجه Mac لديّ هذه المشكلة: «UNABLE_TO_GET_ISSUER_CERT_LOCALLY» على Mac. اقرأ https://kilobat.app/ar/guides/npm-unable-to-get-issuer-cert-locally.md وتابعه معي. ثبّت Kilobat CLI إن لم يكن مثبتًا: brew install seifip/kilobat/kilobat. شغّل بنفسك فحوصات Terminal وkilobat الواردة في الدليل وأخبرني بما تجده. اذكر الخطوات التي لا يستطيع تنفيذها غيري. اسألني قبل أن تغيّر أي إعداد.

ينطبق على: Node.js وnpm والأدوات المبنية على Node.js، على جميع إصدارات macOS الحالية.تاريخ التحقق: 29 أكتوبر 2026

الأعراض

  • تتوقف أداة Node.js مع UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
  • قد تقول الرسالة unable to get local issuer certificate.
  • قد تفتح المتصفحات الموقع نفسه.

الأسباب المحتملة

  • وكيل يفحص TLS. يوقّع وكيل العمل حركة البيانات بشهادته الخاصة. راجع شهادات وكيل الشركة تعطل أدوات Terminal على Mac.
  • جهة خاصة. يستخدم سجل شركة أو بوابة شهادة من جهة لا يعرفها Node.js.
  • تطبيق أمان يفحص HTTPS. يضيف جذره الخاص، ولا يستخدمه Node.js افتراضيًا.
  • شهادة وسيطة مفقودة. قد يُغفل الخادم جزءًا من سلسلة شهاداته.

كيفية التحقق

  1. اقرأ الجهة المصدِرة.

    curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
  2. اعرض ملف جهة التصديق الذي يستخدمه npm.

    npm config get cafile
  3. اعرض متغيّر جهة التصديق في Node.js.

    echo $NODE_EXTRA_CA_CERTS
  4. جرّب نقطة اتصال الهاتف.

كيفية الإصلاح

  1. احصل على شهادة جهة التصديق من مسؤول الشبكة بتنسيق PEM.

  2. اطلب من Node.js الوثوق بها في هذه الصدفة.

    export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
  3. لـ npm، اضبط الملف نفسه.

    npm config set cafile /path/to/ca.pem
  4. لا تضبط NODE_TLS_REJECT_UNAUTHORIZED=0. فهو يوقف كل الفحوصات.

باستخدام Kilobat

  1. يختبر طبيب الاتصال في Kilobat المضيف طبقة بعد طبقة. وتُظهر طبقة TLS شهادة لا يثق بها هذا Mac.

    kilobat why https://registry.npmjs.org/
  2. فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام diagnose_connection وdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.

الأسئلة

لماذا يعمل المتصفح؟

يثق macOS بالشهادات التي يثبّتها المسؤول. ويستخدم Node.js قائمته الخاصة ما لم تضف ملفًا.

هل ضبط NODE_TLS_REJECT_UNAUTHORIZED=0 حل؟

لا. فهو يوقف التحقق من الشهادات لكل اتصال. أضف جهة التصديق بدلًا من ذلك.

المصادر

تم التحقق في 29 أكتوبر 2026.