«UNABLE_TO_GET_ISSUER_CERT_LOCALLY» على Mac
يعني UNABLE_TO_GET_ISSUER_CERT_LOCALLY أن Node.js لا يجد الجهة التي وقّعت الشهادة. السبب المعتاد وكيل يفحص TLS أو جهة خاصة.
يواجه 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 مع
UNABLE_TO_GET_ISSUER_CERT_LOCALLY. - قد تقول الرسالة
unable to get local issuer certificate. - قد تفتح المتصفحات الموقع نفسه.
الأسباب المحتملة
- وكيل يفحص TLS. يوقّع وكيل العمل حركة البيانات بشهادته الخاصة. راجع شهادات وكيل الشركة تعطل أدوات Terminal على Mac.
- جهة خاصة. يستخدم سجل شركة أو بوابة شهادة من جهة لا يعرفها Node.js.
- تطبيق أمان يفحص HTTPS. يضيف جذره الخاص، ولا يستخدمه Node.js افتراضيًا.
- شهادة وسيطة مفقودة. قد يُغفل الخادم جزءًا من سلسلة شهاداته.
كيفية التحقق
اقرأ الجهة المصدِرة.
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuerاعرض ملف جهة التصديق الذي يستخدمه npm.
npm config get cafileاعرض متغيّر جهة التصديق في Node.js.
echo $NODE_EXTRA_CA_CERTSجرّب نقطة اتصال الهاتف.
كيفية الإصلاح
احصل على شهادة جهة التصديق من مسؤول الشبكة بتنسيق PEM.
اطلب من Node.js الوثوق بها في هذه الصدفة.
export NODE_EXTRA_CA_CERTS=/path/to/ca.pemلـ npm، اضبط الملف نفسه.
npm config set cafile /path/to/ca.pemلا تضبط
NODE_TLS_REJECT_UNAUTHORIZED=0. فهو يوقف كل الفحوصات.
باستخدام Kilobat
يختبر طبيب الاتصال في Kilobat المضيف طبقة بعد طبقة. وتُظهر طبقة TLS شهادة لا يثق بها هذا Mac.
kilobat why https://registry.npmjs.org/فحوصات Kilobat هذه مجانية. يشغّلها وكلاء الذكاء الاصطناعي عبر MCP باستخدام
diagnose_connectionوdiagnose_network. راجع معرفة سبب تعذّر اتصال موقع أو API واحد.
الأسئلة
لماذا يعمل المتصفح؟
يثق macOS بالشهادات التي يثبّتها المسؤول. ويستخدم Node.js قائمته الخاصة ما لم تضف ملفًا.
هل ضبط NODE_TLS_REJECT_UNAUTHORIZED=0 حل؟
لا. فهو يوقف التحقق من الشهادات لكل اتصال. أضف جهة التصديق بدلًا من ذلك.
المصادر
تم التحقق في 29 أكتوبر 2026.