💻 تثبيت OneDev — خادم Git المتكامل وخطوط البناء CI/CD وتتبع المهام على Docker

نشر منصة OneDev على Ubuntu باستخدام Docker — خادم استضافة مستودعات Git المتكامل الذي يجمع محرر خطوط البناء (CI/CD) المرئي، والبحث الذكي في الأكواد، ولوحات كانبان لإدارة المشاريع.

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

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

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

سكريبت تثبيت مؤتمت — أمر واحد ينشر OneDev على المنفذ 6610 (HTTP) ومنفذ 6611 (SSH) مع تخزين دائم وتكامل مباشر مع محرك Docker.
عرض على GitHub

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

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

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

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/dev/onedev/onedev-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x onedev-ubuntu.sh

3 تشغيل المثبت

يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين للمستودعات وخطوط البناء وتشغيل حاوية OneDev مع فتح المنفذين 6610 و6611 وتمرير مقبس Docker لتنفيذ عمليات البناء.

sudo bash onedev-ubuntu.sh

4 إتمام الإعداد عبر الويب

افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:6610. اتبع المعالج لإنشاء حساب المشرف الأساسي وضبط عنوان السيرفر العام.

http://:6610
# First run opens the setup wizard — create the admin account there

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

المنفذالغرض
6610OneDev Web UI (HTTP)
6611Git over SSH

نظرة عامة

تعد OneDev منصة تطوير DevOps متكاملة ومفتوحة المصدر تجمع استضافة مستودعات Git، ومحرك خطوط البناء والتشغيل الآلي (CI/CD) الرسومي، والبحث الذكي في الأكواد (الانتقال للتعريف وتتبع الدوال كبيئات التطوير IDE)، ونظام إدارة المهام والتذاكر عبر لوحات كانبان، ومراجعة طلبات السحب (Pull Requests) في نظام موحد. تعمل المنصة على المنفذ 6610 (الويب) ومنفذ 6611 (Git عبر SSH)، وتتصل مباشرة بمقبس Docker في السيرفر (`/var/run/docker.sock`) لتشغيل مهام البناء والاختبار داخل حاويات معزولة تلقائياً.

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

الاعتماد على برامج منفصلة لإدارة الأكواد (مثل Gitea)، وخوادم منفصلة لخطوط البناء (مثل Jenkins)، وأدوات لإدارة المهام (مثل Jira) يستهلك الكثير من موارد السيرفر ويعقد الربط بينها. تجمع OneDev كل هذه الميزات في تطبيق واحد خفيف يستهلك أقل من 1.5 جيجابايت RAM. ويتميز بمحرر خطوط البناء المرئي الذي يتيح لك تصميم سيناريوهات CI/CD المعقدة بنقرات بسيطة دون الحاجة لكتابة وتصحيح ملفات YAML اليدوية.

متى تحتاجه

  • ترغب في بديل متكامل ومستضاف ذاتياً لمنصات GitHub أو GitLab يجمع الأكواد وخطوط البناء وتتبع المهام
  • تحتاج إلى مصمم خطوط بناء CI/CD بصري بالكامل يغنيك عن أخطاء صياغة ملفات YAML المعقدة
  • تريد محرك بحث وفهرسة ذكي للأكواد البرمجية يتيح التنقل المباشر بين تعريفات الدوال والمتغيرات داخل المتصفح
  • تريد تشغيل مهام البناء والاختبار داخل حاويات Docker دون الحاجة لتثبيت برامج وسيطة (Runners) منفصلة
  • يحتاج فريقك إلى لوحات كانبان مرنة وإدارة لسبرنتات العمل Agile مع تقارير الإنجاز التلقائية

من يحتاجه

  • فرق هندسة وتطوير البرمجيات الباحثون عن منصة موحدة لإدارة الكود وأتمتة النشر
  • مهندسو DevOps لبناء خطوط اختبار وبناء ونشر التطبيقات وحاويات Docker برمجياً
  • مديرو المشاريع التقنية وسكرام ماسترز لمتابعة المهام والمراجعات في واجهة واحدة
  • وكالات البرمجة والشركات التي تستضيف أكواد عملائها على سيرفرات خاصة لحماية الملكية الفكرية
  • أصحاب السيرفرات المنزلية لتشغيل وبناء مشاريعهم البرمجية وأتمتة تحديث الحاويات

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

  • استضافة مستودعات Git خاصة مع قواعد صارمة لحماية الفروع (Branch Protection) والمراجعات الإلزامية
  • أتمتة خطوط البناء CI/CD: تجميع الكود، وإجراء الاختبارات الأحادية، وبناء صور Docker، والنشر التلقائي
  • البحث السريع في الأكواد البرمجية والتنقل بين مراجع الكلاسات والدوال عبر مختلف المستودعات
  • إدارة سبرنتات العمل عبر لوحات كانبان مع التحديث التلقائي لحالة المهام عند دمج الأكواد
  • تشغيل اختبارات التكامل الليلية المجدولة واستخراج تقارير حزم البناء بصيغ جاهزة للتحميل

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

  • محرر خطوط بناء CI/CD مرئي بالكامل يدعم البناء المصفوفي، والشروط التفاعلية، ورسم المخططات البيانية
  • نظام ذكاء أكواد متقدم مبني بـ Tree-sitter يتيح القفز للتعريف والبحث عن المراجع داخل المتصفح
  • تنفيذ مباشر لمهام البناء عبر محرك Docker السيرفر مع تخزين مؤقت لمجلدات العمل لتسريع البناء
  • إدارة مهام وتذاكر متطورة: حقول مخصصة، لوحات كانبان، جداول زمنية، ومتابعة ساعات العمل
  • مراجعة متقدمة لطلبات السحب مع مقارنة الفروقات سطراً بسطر والتعليقات المباشرة على الكود
  • تحكم دقيق في الصلاحيات والمشاريع ودعم تسجيل الدخول الموحد (LDAP وOAuth2 وSAML)
  • سجل حزم مدمج لاستضافة وتخزين حزم Maven وNPM وPyPI وصور حاويات Docker
  • نشر في حاوية موحدة مع ربط مجلد ./data لحفظ المستودعات وقواعد البيانات بشكل دائم

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

  • افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:6610 لبدء معالج إعداد OneDev
  • أنشئ حساب المشرف العام بالبريد الإلكتروني وكلمة مرور قوية
  • اضبط عنوان السيرفر العام (مثل https://onedev.yourdomain.com) وتأكد من تعيين منفذ SSH على 6611
  • أنشئ أول مشروع لك: انتقل إلى Projects ← Add Project وأنشئ مستودعاً جديداً أو استورده من GitHub
  • انسخ المستودع لجهازك عبر Git باستخدام رابط SSH: git clone ssh://git@ip-سيرفرك:6611/project.git
  • أنشئ أول خط بناء آلي بالضغط على 'Build Spec' في القائمة الجانبية للمشروع واستخدم المصمم المرئي
  • ضع OneDev خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx أو Caddy) مع شهادة SSL لحماية العمليات في الإنتاج

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

  • استخدم وكيلاً عكسياً مشفراً بـ HTTPS لتشفير الأكواد المرفوعة وأسرار البناء وبيانات تسجيل الدخول
  • غيّر كلمة مرور حساب المشرف فوراً وافرض سياسات مصادقة قوية أو اربطه بتسجيل الدخول الموحد
  • انتبه إلى أن ربط /var/run/docker.sock يمنح مهام البناء وصولاً لمحرك Docker؛ لذا حدد صلاحيات إنشاء مهام البناء في البيئات المشتركة
  • احفظ كلمات المرور ومفاتيح SSH المستخدمة في النشر كأسرار مشفرة (Job Secrets) في إعدادات OneDev
  • فعل قواعد حماية الفروع لمنع الدفع المباشر (Force Push) لفرع الإنتاج الرئيسي دون مراجعة
  • حدّث حاوية 1dev/server دورياً للحصول على التحديثات الأمنية وإصلاحات الثغرات

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

يقدم OneDev واجهة الويب والواجهات البرمجية وGit عبر HTTP على منفذ TCP 6610، ويستقبل اتصالات Git عبر SSH على منفذ TCP 6611. في الإنتاج، قم بتهيئة وكيل عكسي مشفر على المنفذ 443 ووجهه لمنفذ 6610. وافتح المنفذ 6611 في جدار الحماية (ufw allow 6611/tcp) لتمكين المطورين من سحب ورفع الأكواد عبر بروتوكول SSH.

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

  • انسخ مجلد ./data (/opt/onedev) احتياطياً، والذي يحتوي على كافة مستودعات Git وبيانات المشاريع والتذاكر والمستخدمين
  • استخدم ميزة النسخ الاحتياطي التلقائي المدمجة في OneDev من Administration ← System Setting ← Backup
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية آمنة عبر restic أو rsync
  • احتفظ بنسخة من ملفات إعداد الوكيل العكسي وشهادات SSL
  • اختبر الاستعادة بربط مجلد البيانات بحاوية تجريبية للتأكد من استرجاع كافة المشاريع والتذاكر بنجاح

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

  • نسيان تمرير مقبس Docker (`/var/run/docker.sock`)، مما يمنع OneDev من تشغيل خطوات البناء CI/CD داخل الحاويات
  • تشغيل OneDev على سيرفر بذاكرة أقل من 2 جيجابايت، مما يسبب تعطل بيئة Java اثناء تنفيذ عمليات البناء المتزامنة
  • كتابة localhost في إعداد عنوان السيرفر العام (Server URL)، مما يؤدي لظهور روابط استنساخ خاطئة في واجهة الموقع
  • عدم ربط مجلد التخزين الدائم ./data، مما يسبب فقدان المستودعات والتذاكر بالكامل عند تحديث الحاوية
  • فتح المنفذ 6610 للإنترنت العام مباشرة عبر HTTP غير المشفر دون وكيل عكسي آمن

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

  • فشل مهام البناء برسالة 'Cannot connect to Docker daemon' — تأكد من تمرير مقبس /var/run/docker.sock وصلاحياته
  • فشل استنساخ الكود عبر SSH — تأكد من فتح منفذ TCP 6611 في جدار الحماية وإضافة مفتاح SSH العام في ملفك الشخصي
  • بطء استجابة السيرفر أثناء البناء — راجع استهلاك الرامات (`free -m`) وزد حجم ذاكرة Java Heap في إعدادات OneDev
  • واجهة الويب لا تفتح — افحص سجلات الحاوية بالأمر: docker logs onedev -f
  • عدم ظهور مقارنة الفروقات (Diff) في طلبات السحب — تأكد من صحة سجلات الكود وعدم وجود تعارض تالف في ملفات Git

البدائل

منصة GitLab CE هي المنصة المؤسسية الأشهر للـ DevOps ولكنها تتطلب موارد ضخمة (4 جيجابايت RAM كحد أدنى). منصتا Gitea وForgejo خوادم Git فائقة الخفة بلغة Go ولكنها تتطلب مشغلات CI منفصلة. منصة Woodpecker CI محرك خطوط بناء خفيف ومستقل.

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

تجنب استخدام OneDev إذا كنت تحتاج فقط إلى مستودع كود بسيط للغاية لتخزين الملفات دون الحاجة لخطوط بناء أو بحث ذكي أو لوحات مهام (حاوية Gitea أو Forgejo تستهلك 100 ميجابايت فقط وتكفي لهذه الحالات). وإذا كانت شركتك تعتمد بالفعل على منظومة GitLab Enterprise، فإن البقاء عليها يوفر توافقاً أفضل لفرق العمل القائمة.

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

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

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

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

ما الذي يميز OneDev عن Gitea وGitLab؟

يجمع OneDev بين خادم استضافة Git، ومصمم خطوط بناء CI/CD مرئي بالكامل دون الحاجة لكتابة YAML، والبحث الذكي في الأكواد في حاوية واحدة خفيفة تستهلك أقل من 1.5 جيجابايت RAM، مقارنة بـ GitLab الذي يتطلب 4 جيجابايت فأكثر.

كيف يقوم OneDev بتنفيذ مهام خطوط البناء CI/CD؟

ينفذ OneDev مهام البناء عبر محرك Docker السيرفر مباشرة باستخدام مقبس /var/run/docker.sock الممرر للحاوية، حيث يتم تشغيل كل خطوة بناء داخل حاوية Docker معزولة ونظيفة.

هل يمكن استخدام Git عبر SSH على المنفذ 6611؟

نعم، يشغل OneDev خادم SSH مدمج يستمع على المنفذ 6611. ويمكن للمطورين سحب ورفع الأكواد عبر روابط SSH مثل: `git clone ssh://git@ip-سيرفرك:6611/project.git`.

هل يدعم OneDev لوحات كانبان لإدارة المشاريع؟

نعم، يحتوي OneDev على نظام إدارة مهام Agile متكامل يضم لوحات كانبان تفاعلية وسبرنتات وتحديثاً تلقائياً لحالة المهام ورسوم بيانية للإنجاز.

كم يستهلك OneDev من الذاكرة العشوائية؟

يعمل OneDev داخل بيئة Java (JVM) ويستهلك عادة ما بين 1 إلى 2 جيجابايت من الذاكرة العشوائية أثناء العمليات العادية وتنفيذ خطوط البناء.