🚢 تثبيت Harbor — سجل حاويات خاص

انشر Harbor على Ubuntu مع Docker — سجل حاويات مفتوح المصدر على مستوى المؤسسات مع فحص الثغرات، RBAC، نسخ الصور، وواجهة ويب. استضف Docker registry خاصاً بك مع الأمان مدمجاً.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — سجل حاويات خاص مع الفحص بأمر واحد.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/harbor/harbor-ubuntu.sh
chmod +x harbor-ubuntu.sh
sudo bash harbor-ubuntu.sh

خطوات التنفيذ

1 تحميل وتشغيل السكريبت

يثبّت السكريبت Docker ويُنزّل مُثبّت Harbor الرسمي ويُولّد كلمة مرور آمنة ويشغّل جميع خدمات Harbor.

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/dev/harbor/harbor-ubuntu.sh
chmod +x harbor-ubuntu.sh
sudo bash harbor-ubuntu.sh

2 الدخول إلى واجهة الويب

افتح المتصفح وانتقل إلى بوابة Harbor. سجّل الدخول ببيانات المشرف المُولَّدة تلقائياً:

http://<your-server-ip>:5080

Username: admin
Password: (shown at end of install script)

3 إنشاء مشروع

في واجهة Harbor، اذهب إلى المشاريع ← مشروع جديد. سمّه وحدد التحكم بالوصول (عام أو خاص). المشاريع تُنظّم مستودعات الصور.

4 رفع أول صورة

سجّل الدخول للـ registry من عميل Docker ثم ضع الوسم وارفع الصورة.

docker login <your-server-ip>:5080

docker tag myapp:latest <your-server-ip>:5080/my-project/myapp:latest
docker push <your-server-ip>:5080/my-project/myapp:latest

المنافذ المستخدمة

المنفذالغرض
5080Harbor Web UI & Registry API

نظرة عامة

Harbor هو سجل حاويات مفتوح المصدر يخزن صور الحاويات ويوقّعها ويفحصها. يوسّع Docker Registry بميزات المؤسسات: التحكم في الوصول المستند إلى الأدوار وفحص ثغرات الصور عبر Trivy وتوقيع المحتوى ونسخ الصور بين السجلات وسجل تدقيق كامل. وهو مشروع تخرّج في CNCF.

لماذا تستخدمه

Harbor يحل مشكلتين في آنٍ واحد: منحك سجل Docker خاص بدون حدود معدل Docker Hub وطبقاته المدفوعة، وإضافة فحص أمني لا توفره Docker Hub المجانية. كل صورة مدفوعة لـ Harbor تُفحص تلقائياً بـ Trivy عن CVEs المعروفة — يمكنك حجب نشر الصور ذات الثغرات الحرجة. RBAC يعني أن المطورين يمكنهم الدفع لمشاريعهم لكن لا يستطيعون الكتابة فوق صور الإنتاج. لأي فريق يشغّل عبء عمل حاويات في الإنتاج، Harbor يسد الثغرة الأمنية التي تتركها سجلات Docker العادية.

متى تحتاجه

  • تحتاج سجل Docker خاص بدون دفع رسوم لمستودعات Docker Hub الخاصة
  • تريد فحص ثغرات تلقائي لكل صورة مدفوعة قبل وصولها للإنتاج
  • فريقك يحتاج تحكماً في الوصول بالأدوار — المطورون يدفعون، CI فقط يُوسِّم صور الإنتاج
  • تسحب من Docker Hub بكثرة وتصطدم بحدود المعدل (100 سحب كل 6 ساعات على المجاني)
  • تحتاج نسخ الصور عبر مواقع أو مناطق سحابية متعددة للتعافي من الكوارث
  • مؤسستك تتطلب سجل تدقيق لكل push وpull وحذف صورة للامتثال

من يحتاجه

  • مهندسو DevOps الذين يديرون دورة حياة صور الحاويات في بيئات الإنتاج
  • فرق المنصة التي توفر سجلاً داخلياً مشتركاً لفرق تطوير متعددة
  • مهندسو الأمن الذين يحتاجون فحص الثغرات كبوابة إلزامية في خط CI/CD
  • المؤسسات ذات متطلبات الامتثال (SOC2، PCI-DSS) التي تحتاج سجلات تدقيق الصور
  • الفرق في الشبكات المعزولة التي لا تصل لـ Docker Hub وتحتاج سجلاً محلياً
  • مزودو الخدمات المُدارة الذين يستضيفون تطبيقات في حاويات لعملاء متعددين

حالات الاستخدام الشائعة

  • تخزين صور Docker الخاصة دون الدفع لحدود مستودع Docker Hub الخاص
  • فحص جميع الصور المدفوعة بحثاً عن CVEs باستخدام ماسح Trivy المدمج
  • نسخ الصور بين نسخ Harbor أو إلى Docker Hub للتعافي من الكوارث
  • تطبيق سياسات توقيع الصور حتى يمكن سحب الصور الموقّعة فقط في الإنتاج
  • تنظيم الصور في مشاريع مع التحكم في الوصول وحصص لكل مشروع
  • تخزين صور Docker Hub مؤقتاً محلياً لتجنب حدود المعدل وتسريع سحب الحاويات

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

  • سجل Docker وOCI المتوافق — push وpull لصور الحاويات المعيارية
  • تكامل Trivy — فحص تلقائي للـ CVE مع عتبات خطورة قابلة للضبط
  • التحكم في الوصول بالأدوار — مسؤول ومسؤول مشروع ومطور وضيف لكل مشروع
  • توقيع الصور والتحقق منها — ضمان أن الصور الموثوقة الموقّعة فقط تعمل في الإنتاج
  • النسخ — مزامنة الصور من/إلى نسخ Harbor أخرى أو Docker Hub
  • Proxy Cache — نسخ Docker Hub وGHCR وسجلات upstream أخرى محلياً لتجنب حدود المعدل
  • سياسات الاستبقاء — حذف تلقائي لعلامات الصور القديمة لإدارة التخزين
  • سجل التدقيق — كل push وpull وحذف وتسجيل دخول مسجّل بتوقيت ومستخدم

كيفية الاستخدام بعد التثبيت

  • افتح https://your-domain.com وسجّل دخولاً بـ admin / Harbor12345 — غيّر كلمة المرور فوراً
  • فعّل ماسح Trivy: Administration > Interrogation Services > New Scanner
  • أنشئ Project لفريقك أو تطبيقك — اضبط الرؤية كـ Private
  • خصّص أعضاء الفريق للمشروع بأدوار مناسبة (Developer، Maintainer)
  • على محطتك: docker login harbor.yourdomain.com — استخدم بيانات Harbor
  • ادفع صورة اختبارية: docker tag nginx harbor.yourdomain.com/myproject/nginx:test && docker push
  • فعّل الفحص التلقائي: في المشروع، اذهب لـ Configuration > Enable content trust وauto scan
  • اضبط سياسات الاستبقاء لحذف العلامات تلقائياً بعد 30 يوماً لإدارة مساحة القرص

أفضل ممارسات الأمان

  • غيّر كلمة المرور الافتراضية (Harbor12345) فوراً بعد أول تسجيل دخول
  • فعّل فحص Trivy وضبط حجب الثغرات الحرجة قبل نشر الإنتاج
  • استخدم RBAC على مستوى المشروع — المطورون يحصلون دور Developer، CI يحصل Robot Account بـ push فقط
  • فعّل HTTPS — سيرفض Docker push/pull من سجل HTTP العادي بدون إعداد insecure-registries
  • أنشئ Robot Accounts لخطوط CI/CD بدلاً من استخدام بيانات شخصية
  • فعّل content trust (Notary) لطلب توقيع الصور قبل نشر الإنتاج
  • راجع رموز robot accounts بانتظام وأبطل الرموز لخطوط الأنابيب المفككة
  • حافظ على تحديث Harbor — قاعدة بيانات Trivy تُحدَّث تلقائياً لكن Harbor نفسه يحتاج تحديثات يدوية

المنافذ وإعدادات جدار الحماية

يضبط مثبّت Harbor الاستماع على HTTP المنفذ 5080 وبالاختيار HTTPS 5443. ضعه خلف Nginx Proxy Manager على HTTPS المنفذ 443 وأعِدْ التوجيه لـ 5080 الخاص بـ Harbor. يحتاج Docker daemon على كل سيرفر يدفع/يسحب الصور للثقة بشهادة نطاقك — اضبط هذا في /etc/docker/daemon.json إذا كنت تستخدم CA غير عام. لـ Kubernetes، اضبط imagePullSecrets ببيانات Harbor وتأكد من وصول عقد المجموعة لنطاق Harbor على المنفذ 443.

النسخ الاحتياطي والصيانة

  • انسخ قاعدة بيانات Harbor (PostgreSQL) — تحتوي المشاريع والمستخدمين والسياسات والبيانات الوصفية
  • انسخ مجلد تخزين الصور (مضبوط كـ --data-volume أثناء التثبيت، افتراضياً /data/registry)
  • انسخ harbor.yml — ملف الضبط الرئيسي بجميع الإعدادات
  • robot accounts وقواعد النسخ في قاعدة البيانات — مشمولة في نسخة DB
  • استخدم سكريبتات نسخ احتياطي لـ Harbor أو صدّر بيانات السجل بـ crane أو regctl للتنقلية
  • اختبر الاستعادة بنشر Harbor جديد واستيراد نسخة قاعدة البيانات — تحقق من إمكانية سحب الصور

الأخطاء الشائعة

  • استخدام HTTP العادي بدون reverse proxy — يرفض Docker سجلات HTTP إلا إذا كانت مدرجة في القائمة البيضاء
  • عدم تغيير كلمة المرور الافتراضية (Harbor12345) — معروفة للعموم
  • تخطي إعداد ماسح Trivy — Harbor بدون فحص مجرد تخزين وليس أداة أمان
  • عدم إنشاء Robot Accounts لـ CI — استخدام بيانات شخصية في خطوط الأنابيب خطر أمني
  • نسيان ضبط insecure-registries لـ Docker daemon أو الثقة بالـ CA — يسبب أخطاء سحب في Kubernetes
  • عدم ضبط سياسات الاستبقاء — التخزين يمتلئ بعلامات صور قديمة مع الوقت
  • إغفال ميزة proxy cache — تلغي حدود معدل Docker Hub مجاناً

استكشاف الأخطاء وإصلاحها

  • docker login يفشل → تحقق من أن HTTPS يعمل وأن Docker على تلك الجهاز يثق بالشهادة
  • docker push يفشل بـ 403 → تحقق من أن المستخدم لديه دور Developer أو Maintainer في المشروع
  • فحص Trivy عالق → تحقق من تحديث DB لـ Trivy: Administration > Interrogation Services > Log
  • الصور مفقودة بعد الاستعادة → تأكد من استعادة مجلد تخزين الصور جانباً مع قاعدة البيانات
  • Kubernetes لا يستطيع السحب → تحقق من ضبط imagePullSecret وإمكانية وصول المجموعة لـ Harbor
  • النسخ لا يتزامن → تحقق من URL الهدف وبيانات الاعتماد في Administration > Replications
  • 502 من Nginx لـ Harbor → حاوية Harbor متوقفة على الأرجح؛ تحقق من docker compose ps
  • البيانات الفحص قديمة → شغّل تحديث DB يدوياً في Interrogation Services > Edit Scanner

البدائل

Docker Hub هو الخيار الأسهل إذا لم تحتج تخزيناً محلياً — المستودعات الخاصة تبدأ من 5 دولارات/شهر لكن بحدود معدل. GitHub Container Registry (GHCR) مجاني للصور العامة ومتكامل مع GitHub Actions. GitLab Container Registry مضمّن في GitLab ذاتي الاستضافة. Nexus Repository OSS يتضمن سجل Docker مع Maven وnpm. Distribution (المعروف سابقاً بـ Docker Registry) هو الخيار الأدنى — لا واجهة، لا فحص، لا RBAC. Harbor هو الخيار الصحيح عند الحاجة للثلاثة: تخزين خاص وفحص وتحكم في الوصول.

متى لا تستخدمه

تجنب Harbor إذا كانت لديك صور قليلة وبدون متطلب فحص أمني — Docker Hub المجاني أو GHCR أبسط في التشغيل. يتطلب Harbor 2+ GB RAM وتخزيناً ملحوظاً لصور الحاويات؛ على VPS محدود الموارد يتنافس مع الخدمات الأخرى. إذا كان فريقك بالكامل على GitHub ويستخدم GitHub Actions، يُعدّ GHCR مع تكامل GitHub Actions الأصلي أبسط بكثير من Harbor ذاتي الاستضافة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

ما Robot Account في Harbor ولماذا يجب استخدامه؟

Robot Account هو بيانات اعتماد حساب خدمة في Harbor مصمم للاستخدام الآلي — خطوط CI، Kubernetes، سكريبتات النشر. على عكس بيانات اعتماد المستخدم الشخصية، تمتلك Robot Accounts تاريخ انتهاء صلاحية ونطاق محدد لمشاريع وصلاحيات معينة (push فقط أو pull فقط) ويمكن إبطالها بسهولة دون التأثير على وصول أي شخص. استخدم دائماً Robot Accounts في CI/CD — لا تستخدم بياناتك الشخصية في Harbor داخل خط أنابيب.

كيف أضبط Harbor كـ Docker Hub proxy cache؟

في Harbor، اذهب لـ Administration > Registries > New Endpoint، اختر Docker Hub واحفظ. ثم أنشئ Project جديداً بنوع 'Proxy Cache' واختر نقطة نهاية Docker Hub. اضبط Docker daemon أو containerd لـ Kubernetes لاستخدام harbor.yourdomain.com/dockerhub-cache كـ registry mirror. السحب من هذا المشروع يجلب شفافياً من Docker Hub أول مرة ويخزن محلياً، مما يلغي حدود المعدل.

كيف أستخدم Harbor مع Kubernetes (imagePullSecret)؟

أنشئ Robot Account في Harbor بصلاحية pull لمشروعك. ثم أنشئ Kubernetes secret: kubectl create secret docker-registry harbor-secret --docker-server=harbor.yourdomain.com --docker-username=robot$myapp --docker-password=TOKEN -n your-namespace. أشر إليه في مواصفات pod: imagePullSecrets: [{name: harbor-secret}]. للوصول على مستوى المجموعة، انسخ السر لكل namespace يحتاجه.

كيف أحجب نشر الصور ذات الثغرات الحرجة؟

في مشروع Harbor، اذهب لـ Configuration وفعّل 'Prevent vulnerable images from running'. اضبط العتبة لـ Critical أو High. مع تفعيل هذا، سيفشل docker pull إذا كانت للصورة CVEs عند عتبتك أو أعلى. في Kubernetes، اقرن هذا مع Notary (content trust) لـ Harbor أو admission controller مثل OPA Gatekeeper لتطبيق الفحص على مستوى المجموعة.

ما حجم السيرفر المطلوب لتشغيل Harbor؟

الحد الأدنى لمتطلبات Harbor هو 2 vCPU و4 GB RAM مع تخزين يتناسب مع مكتبة صورك. فريق صغير بعشرات الصور يناسبه 20–50 GB بشكل مريح. للاستخدام في الإنتاج مع تفعيل فحص Trivy، 4 GB RAM أكثر ارتياحاً. يعمل Harbor كنحو 10 حاويات Docker لذا لا يناسب VPS صغيراً مشتركاً — خصّص جهازاً أو استخدم VPS بـ 4 GB RAM على الأقل.

هل يمكن لـ Harbor نسخ الصور إلى Docker Hub أو نسخة Harbor أخرى؟

نعم. تدعم ميزة Replication لـ Harbor النسخ الدفع أو السحب لـ Docker Hub وGHCR وAWS ECR وGCR وAzure ACR ونسخ Harbor أخرى. أعدّ Replication Rule في Administration > Replications: حدد مشروع المصدر وسجل الوجهة وتصفية باسم الصورة أو نمط العلامة والجدول (عند push أو مجدول أو يدوي). مفيد لتوزيع الصور عبر مناطق أو نسخ Docker Hub احتياطياً.

كيف أحدّث Harbor؟

تصدر Harbor إصدارات جديدة بانتظام. انسخ قاعدة البيانات ومجلد تخزين الصور أولاً. حمّل المثبّت الجديد من إصدارات GitHub لـ Harbor، شغّل سكريبت prepare، ثم docker compose down && docker compose up -d. يُشغّل Harbor ترقيات قاعدة البيانات تلقائياً. تحقق من دليل الترقية لزوج إصدارك المحدد — بعض ترقيات الإصدارات الرئيسية تتطلب تشغيل حاوية مساعدة للترحيل أولاً.

هل يعمل Harbor مع Podman بدلاً من Docker؟

نعم. Harbor متوافق مع OCI لذا أي عميل متوافق مع OCI يعمل — Podman وSkopeo وBuildah وCrane تتفاعل مع Harbor بنفس طريقة Docker. استخدم podman login harbor.yourdomain.com وpodman push وpodman pull — نفس الصيغة. في بيئات Kubernetes التي تستخدم CRI-O بدلاً من containerd، اضبط registry mirror في /etc/containers/registries.conf للإشارة لـ Harbor.