---
title: "«UNABLE_TO_GET_ISSUER_CERT_LOCALLY» على Mac · أدلة Kilobat"
url: "https://kilobat.app/ar/guides/npm-unable-to-get-issuer-cert-locally"
description: "يتوقف Node.js أو npm على Mac مع UNABLE_TO_GET_ISSUER_CERT_LOCALLY. جهة مصدِرة للشهادة غير معروفة. أضف ملف جهة التصديق الصحيح، ولا تعطّل الفحوصات."
---

# «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](https://kilobat.app/ar/guides/corporate-proxy-certificates).
- **جهة خاصة.** يستخدم سجل شركة أو بوابة شهادة من جهة لا يعرفها 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 واحد](https://kilobat.app/ar/guides/recipes/why-cant-it-connect).

## الأسئلة

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

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

**هل ضبط NODE_TLS_REJECT_UNAUTHORIZED=0 حل؟**

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

## المصادر

- [وثائق npm: الأخطاء الشائعة](https://docs.npmjs.com/common-errors)
- [Claude Code: إعداد شبكة المؤسسات](https://code.claude.com/docs/en/network-config.md)

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

## أدلة ذات صلة

- [«SELF_SIGNED_CERT_IN_CHAIN» في npm على Mac](https://kilobat.app/ar/guides/npm-self-signed-cert-in-chain): يعني SELF_SIGNED_CERT_IN_CHAIN أن سلسلة الشهادات تضم شهادة لم توقّعها أي جهة معروفة.
- [شهادات وكيل الشركة تعطل أدوات Terminal على Mac](https://kilobat.app/ar/guides/corporate-proxy-certificates): تفحص بعض شبكات الشركات حركة HTTPS.
- [«curl: (60) SSL certificate problem» على Mac](https://kilobat.app/ar/guides/curl-60-ssl-certificate-problem): يشير رمز الخروج 60 في curl إلى خطوة فاشلة.
- [«npm error code ECONNRESET» على Mac](https://kilobat.app/ar/guides/npm-econnreset): يشير ECONNRESET إلى إعادة تعيين الاتصال قسرًا.
