Verdaccio هو مسجّل npm خاص خفيف مفتوح المصدر (MIT)، مبني بـNode.js، يعمل وكيلاً ومستودعاً للحزم JavaScript.
كوكيل، يحوّل طلبات الحزم العامة إلى npmjs.org ويخزّنها محلياً، فتستمر بنيات CI حتى عند تعطّل السجل العام وتُخدَم عمليات التثبيت المتكررة فوراً من القرص. كمستودع خاص، يتيح نشر حزم داخلية تحت أي نطاق (`@company/...`) والإبقاء عليها بعيداً عن الإنترنت.
يُشغَّل Verdaccio في حاوية Docker واحدة دون قاعدة بيانات خارجية. يدعم بروتوكول npm بالكامل، لذا npm وYarn وpnpm تعمل دون تعديل: فقط غيّر عنوان السجل إلى VPS الخاص بك.
الميزات الرئيسية
متى تستخدم هذا الحل؟
مسجّل حزم خاص لفريقك
انشر مكتبات JavaScript الداخلية تحت نطاقك. يثبّتها كل عضو كما لو كانت حزماً عامة، دون روابط Git اليدوية أو النسخ واللصق.
تخزين مؤقت موثوق لـCI
وكّل npmjs.org عبر Verdaccio وخزّن كل حزمة محمّلة. إذا تعطّل السجل العام أثناء البناء، يُخدم الإصدار المخزّن شفافياً.
بيئات بلا اتصال بالإنترنت
امل التخزين المؤقت مرة واحدة بالإنترنت ثم افصله. يستمر Verdaccio في خدمة جميع الحزم السابقة دون حاجة لاتصال.
نشر Verdaccio على خادم VPS الخاص بك
دليل محسّن لخوادم VPS Cloud من ServOrbit.
الاتصال بالسجل
لا يحتاج Verdaccio لنطاق. افتح نفقاً SSH: ssh -L 4873:127.0.0.1:<port> root@<ip-vps>، ثم وجّه npm إليه: npm set registry http://localhost:4873. للوصول الدائم، أضف نطاقاً من لوحة ServOrbit.
إنشاء أول مستخدم
نفّذ npm adduser --registry http://localhost:4873. أدخل اسم المستخدم وكلمة المرور والبريد. يصبح هذا المستخدم مدير السجل.
نشر حزمة خاصة
في مجلد الحزمة، نفّذ npm publish --registry http://localhost:4873. تُخزَّن الحزمة على VPS وتتاح لأي مطوّر أو نظام CI مصادَق عليه.
ضبط قواعد توجيه النطاق (اختياري)
عدّل config.yaml داخل حجم الحاوية لتوجيه نطاقات محددة إلى سجلك الخاص وسائرها إلى npmjs.org. أعد تشغيل الحاوية: docker compose restart verdaccio.
الأسئلة الشائعة
إضافة زر النشر
هل تدير مشروعًا يستخدم Verdaccio؟ يتيح هذا الزر لقرّائك نشره على خادم VPS بنقرة واحدة، دون قراءة وثائق Docker.
[](https://servorbit.com/vps-cloud?template=verdaccio&utm_source=deploy-badge&utm_medium=referral&utm_campaign=verdaccio)<a href="https://servorbit.com/vps-cloud?template=verdaccio&utm_source=deploy-badge&utm_medium=referral&utm_campaign=verdaccio"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Verdaccio on ServOrbit" height="40"></a>يشير الزر إلى طلب خادم VPS مع تحديد القالب مسبقًا. تُقدَّم الصورة من servorbit.com — لا شيء تستضيفه من جهتك.
حلول تكميلية
Gitea
منصّة GitHub الخاصة بك، مستضافة ذاتيًا في دقائق. منصّة Git كاملة مع CI/CD (Gitea Actions)، وسِجِلّ حزم، وأذونات للفِرق — دون فوترة قائمة على الاستخدام.
التطويرOneDev
منصة Git متكاملة مع CI/CD مرئي ولوحات Kanban وسجل الحزم في حاوية واحدة، بدون رسوم لكل مطور.
نشر التطبيقات وDevOpsSemaphore UI
واجهة ويب مفتوحة المصدر لـ Ansible وTerraform وOpenTofu — شغّل المهام وجدوِلها وتابعها من لوحة تحكم دون سطر أوامر.
بحاجة إلى مساعدة؟
تصفّح مركز المساعدة والأسئلة الشائعة، أو تواصل مع فريقنا — معاودة اتصال أو WhatsApp أو بريد إلكتروني. الدعم بـالعربية والفرنسية والإنجليزية.
راسلنا على WhatsAppيُفتح في علامة تبويب جديدة