بدء مشروع برمجي بسرعة.

Verdaccio

Verdaccio — مسجّل npm/yarn خاص مستضاف ذاتياً على VPS.

< 128 ميغابايت ذاكرة عشوائية 1 vCPU المنفذ 4873 قيد التحقق

قيد التحقق

التثبيت التلقائي لهذا الحل جاهز ويخضع حاليًا لاختباراتنا على خادم حقيقي. سيُفتح الطلب فور اكتمال التحقق.

المنظومة التقنية

DockerNode.js
الحد الأدنى من RAM< 128 ميغابايت
الحد الأدنى من CPU1 vCPU
المنفذ الافتراضي4873
أنظمة التشغيل المتوافقةتوزيعات Linux حسب اختيارك

Verdaccio هو مسجّل npm خاص خفيف مفتوح المصدر (MIT)، مبني بـNode.js، يعمل وكيلاً ومستودعاً للحزم JavaScript.

كوكيل، يحوّل طلبات الحزم العامة إلى npmjs.org ويخزّنها محلياً، فتستمر بنيات CI حتى عند تعطّل السجل العام وتُخدَم عمليات التثبيت المتكررة فوراً من القرص. كمستودع خاص، يتيح نشر حزم داخلية تحت أي نطاق (`@company/...`) والإبقاء عليها بعيداً عن الإنترنت.

يُشغَّل Verdaccio في حاوية Docker واحدة دون قاعدة بيانات خارجية. يدعم بروتوكول npm بالكامل، لذا npm وYarn وpnpm تعمل دون تعديل: فقط غيّر عنوان السجل إلى VPS الخاص بك.

الميزات الرئيسية

وكالة npmjs.org — خزّن الحزم محلياً كيلا تفشل بنيات CI عند تعطّل السجل العام.
نشر الحزم الخاصة — انشر مكتبات JavaScript الداخلية بنطاقك الخاص دون كشفها للعموم.
دعم متعدد العملاء — يعمل مع npm وYarn وpnpm دون تعديل إعدادات العميل.
نشر في حاوية واحدة خفيفة — يعمل بأقل من 128 ميغابايت RAM على VPS ServOrbit.
تحكم بالوصول بالرمز المميز — أنشئ حسابات ورموز API للتحكم في من يقرأ أو ينشر.
وضع عدم الاتصال — يخدم الحزم المخزنة دون إنترنت لبنيات قابلة للاستنساخ.

متى تستخدم هذا الحل؟

1

مسجّل حزم خاص لفريقك

انشر مكتبات JavaScript الداخلية تحت نطاقك. يثبّتها كل عضو كما لو كانت حزماً عامة، دون روابط Git اليدوية أو النسخ واللصق.

2

تخزين مؤقت موثوق لـCI

وكّل npmjs.org عبر Verdaccio وخزّن كل حزمة محمّلة. إذا تعطّل السجل العام أثناء البناء، يُخدم الإصدار المخزّن شفافياً.

3

بيئات بلا اتصال بالإنترنت

امل التخزين المؤقت مرة واحدة بالإنترنت ثم افصله. يستمر Verdaccio في خدمة جميع الحزم السابقة دون حاجة لاتصال.

نشر Verdaccio على خادم VPS الخاص بك

دليل محسّن لخوادم VPS Cloud من ServOrbit.

01

الاتصال بالسجل

لا يحتاج Verdaccio لنطاق. افتح نفقاً SSH: ssh -L 4873:127.0.0.1:<port> root@<ip-vps>، ثم وجّه npm إليه: npm set registry http://localhost:4873. للوصول الدائم، أضف نطاقاً من لوحة ServOrbit.

02

إنشاء أول مستخدم

نفّذ npm adduser --registry http://localhost:4873. أدخل اسم المستخدم وكلمة المرور والبريد. يصبح هذا المستخدم مدير السجل.

03

نشر حزمة خاصة

في مجلد الحزمة، نفّذ npm publish --registry http://localhost:4873. تُخزَّن الحزمة على VPS وتتاح لأي مطوّر أو نظام CI مصادَق عليه.

04

ضبط قواعد توجيه النطاق (اختياري)

عدّل config.yaml داخل حجم الحاوية لتوجيه نطاقات محددة إلى سجلك الخاص وسائرها إلى npmjs.org. أعد تشغيل الحاوية: docker compose restart verdaccio.

الأسئلة الشائعة

لا. يُوكّل Verdaccio npmjs.org افتراضياً — تُحوَّل طلبات الحزم الغائبة إلى السجل العام وتُخزَّن محلياً. يمكنك الاستمرار في استخدام جميع الحزم العامة بشكل طبيعي.

بدء مشروع برمجي بسرعة.

لا يمكن طلب Verdaccio بعد.

التثبيت التلقائي لهذا الحل جاهز ويخضع حاليًا لاختباراتنا على خادم حقيقي. سيُفتح الطلب فور اكتمال التحقق.

بحاجة إلى مساعدة؟

تصفّح مركز المساعدة والأسئلة الشائعة، أو تواصل مع فريقنا — معاودة اتصال أو WhatsApp أو بريد إلكتروني. الدعم بـالعربية والفرنسية والإنجليزية.

راسلنا على WhatsAppيُفتح في علامة تبويب جديدة