حول Verdaccio
Verdaccio هو مسجّل npm خاص خفيف مفتوح المصدر (MIT)، مبني بـNode.js، يعمل وكيلاً ومستودعاً للحزم JavaScript.
كوكيل، يحوّل طلبات الحزم العامة إلى npmjs.org ويخزّنها محلياً، فتستمر بنيات CI حتى عند تعطّل السجل العام وتُخدَم عمليات التثبيت المتكررة فوراً من القرص. كمستودع خاص، يتيح نشر حزم داخلية تحت أي نطاق (`@company/...`) والإبقاء عليها بعيداً عن الإنترنت.
يُشغَّل Verdaccio في حاوية Docker واحدة دون قاعدة بيانات خارجية. يدعم بروتوكول npm بالكامل، لذا npm وYarn وpnpm تعمل دون تعديل: فقط غيّر عنوان السجل إلى VPS الخاص بك.
ما يُثبَّت
جاهز عند تشغيل الخادم
- أنظمة التشغيل المتوافقة
- توزيعات Linux حسب اختيارك
- التطبيق
- Verdaccio
- المنظومة التقنية
- DockerNode.js
- الحد الأدنى من RAM
- < 128 ميغابايت
- الحد الأدنى من CPU
- 1 vCPU
- المنفذ الافتراضي
- 4873
- الوصول
- root عبر SSH
الميزات الرئيسية
- وكالة npmjs.org — خزّن الحزم محلياً كيلا تفشل بنيات CI عند تعطّل السجل العام.
- نشر الحزم الخاصة — انشر مكتبات JavaScript الداخلية بنطاقك الخاص دون كشفها للعموم.
- دعم متعدد العملاء — يعمل مع npm وYarn وpnpm دون تعديل إعدادات العميل.
- نشر في حاوية واحدة خفيفة — يعمل بأقل من 128 ميغابايت RAM على VPS ServOrbit.
- تحكم بالوصول بالرمز المميز — أنشئ حسابات ورموز API للتحكم في من يقرأ أو ينشر.
- وضع عدم الاتصال — يخدم الحزم المخزنة دون إنترنت لبنيات قابلة للاستنساخ.
متى تستخدم هذا الحل؟
مسجّل حزم خاص لفريقك
انشر مكتبات JavaScript الداخلية تحت نطاقك. يثبّتها كل عضو كما لو كانت حزماً عامة، دون روابط Git اليدوية أو النسخ واللصق.
تخزين مؤقت موثوق لـCI
وكّل npmjs.org عبر Verdaccio وخزّن كل حزمة محمّلة. إذا تعطّل السجل العام أثناء البناء، يُخدم الإصدار المخزّن شفافياً.
بيئات بلا اتصال بالإنترنت
امل التخزين المؤقت مرة واحدة بالإنترنت ثم افصله. يستمر Verdaccio في خدمة جميع الحزم السابقة دون حاجة لاتصال.
الدليل
نشر Verdaccio على خادم VPS الخاص بك
الاتصال بالسجل
لا يحتاج 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يُفتح في علامة تبويب جديدة