«SELF_SIGNED_CERT_IN_CHAIN» في npm على Mac

يعني SELF_SIGNED_CERT_IN_CHAIN أن سلسلة الشهادات تضم شهادة لم توقّعها أي جهة معروفة. على شبكة عمل، المصدر المعتاد وكيل يفحص TLS.

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

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

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

الأعراض

  • يتوقف npm install مع ظهور npm error code SELF_SIGNED_CERT_IN_CHAIN.
  • تقول الرسالة self-signed certificate in certificate chain.
  • يبدأ على شبكة شركة، أو بعد تثبيت تطبيق أمان.

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

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

كيفية التحقق

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

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

    npm config get cafile
  3. تحقق من إصدار npm.

    npm --version
  4. جرّب نقطة اتصال الهاتف. إذا عمل، فالشبكة الأولى تفحص TLS.

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

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

  2. وجّه npm إليها.

    npm config set cafile /path/to/ca.pem
  3. حدّث npm إذا كان قديمًا.

    npm install npm -g
  4. لا تضبط strict-ssl على false. تنصح وثائق npm بعدم ذلك.

باستخدام Kilobat

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

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

الأسئلة

هل npm config set strict-ssl false آمن؟

فهو يوقف فحص الشهادات. تنصح وثائق npm بعدم ذلك لأخطاء الوكيل. أضف جهة تصديق الوكيل بدلًا من ذلك.

لماذا يظهر الخطأ في العمل فقط؟

يوقّع الوكيل الذي يفحص TLS حركة البيانات بشهادته الخاصة. ولا يثق Mac بها.

المصادر

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