🐙 تثبيت Gitea — خدمة Git ذاتية الاستضافة

انشر Gitea على Ubuntu مع Docker — منصة Git خفيفة وسريعة البرق لاستضافة المستودعات، المشاكل، طلبات الدمج، الويكي وـ CI/CD hooks. GitHub الخاص بك تحت سيطرتك الكاملة.

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

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

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

سكريبت تثبيت آلي — Gitea مع PostgreSQL بأمر واحد.
عرض على GitHub

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

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

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

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

يثبّت السكريبت Docker ويشغّل Gitea مع قاعدة بيانات PostgreSQL ويُهيّئ SSH على المنفذ 2222.

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

2 إكمال معالج الإعداد

افتح المتصفح وانتقل إلى Gitea. ستظهر لك معالج الإعداد الأولي — أكّد إعدادات قاعدة البيانات وأنشئ حساب المشرف:

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

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

بعد تسجيل الدخول، انقر أيقونة '+' وأنشئ مستودعاً جديداً. استنسخه عبر HTTP أو SSH من صفحة المستودع.

4 إعداد SSH

أضف مفتاحك العام SSH تحت الإعدادات ← مفاتيح SSH. ثم استنسخ المستودعات عبر SSH على المنفذ 2222.

git clone ssh://git@<your-server-ip>:2222/username/repo.git

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

المنفذالغرض
3100Gitea Web UI & HTTP Git
2222Gitea SSH Git Access

نظرة عامة

Gitea هي خدمة Git خفيفة الوزن ذاتية الاستضافة مكتوبة بـ Go. توفر واجهة شبيهة بـ GitHub لإدارة المستودعات ومراجعة الكود وتتبع المشكلات وويكي المشاريع. تتميز Gitea بكفاءة الموارد الاستثنائية — تعمل بشكل مريح على VPS بـ 512 MB RAM — مما يجعلها مثالية لـ DevOps ذاتي الاستضافة بميزانية محدودة.

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

Gitea تمنحك سير عمل تطوير كامل شبيه بـ GitHub — مستودعات وطلبات سحب ومراجعة كود ومشكلات وويكي وخطافات ويب CI — بدون رسوم لكل مقعد وبملكية كاملة للبيانات. تعمل على 512 MB RAM، مما يعني استضافتها على أرخص طبقات VPS بجانب خدمات أخرى. للفرق التي لا تريد الكود على GitHub (مخاوف الملكية الفكرية أو الامتثال أو الشبكات المعزولة)، Gitea هي الخيار الأكثر كفاءة في الموارد.

متى تحتاجه

  • فريقك يتعامل مع كود مملوك لا يمكن تخزينه على GitHub أو GitLab
  • تحتاج forge Git خاصة تعمل على أجهزة بسيطة بجانب خدمات أخرى
  • تريد DevOps كامل ذاتي الاستضافة — Gitea مع Woodpecker CI وHarbor يغطي خط الأنابيب الكامل
  • تحتاج webhooks ومفاتيح نشر بدون دفع أسعار GitHub Enterprise
  • تعمل في بيئة معزولة عن الإنترنت حيث الخدمات السحابية غير متاحة
  • تريد نسخ المستودعات العامة محلياً للوصول بدون إنترنت أو الأرشفة

من يحتاجه

  • فرق التطوير في الشركات الناشئة والمتوسطة الذين يريدون سيادة البيانات
  • مهندسو DevOps الذين يبنون خطوط CI/CD كاملة ذاتية الاستضافة
  • المطورون الأفراد الذين يستضيفون مشاريع شخصية بعيداً عن GitHub
  • المؤسسات في القطاعات المنظَّمة (الدفاع والرعاية الصحية والمال) حيث يجب بقاء الكود داخلياً
  • مسؤولو الأنظمة الذين يريدون إدارة مستودعات البنية التحتية كـ كود بشكل خاص
  • المعلمون الذين يُعدّون بيئات Git خاصة للطلاب

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

  • استضافة مستودعات Git خاصة للمشاريع الشخصية أو الفرق الداخلية
  • إدارة مراجعات الكود عبر طلبات السحب مع التعليق المضمّن وسير عمل الموافقة
  • تتبع الأخطاء والميزات والمهام باستخدام متتبع المشكلات المدمج في Gitea
  • نسخ مستودعات GitHub أو GitLab العامة لنسخة خاصة للأرشفة
  • التكامل مع Woodpecker CI لخط أنابيب CI/CD ذاتي الاستضافة كامل
  • إدارة مفاتيح SSH ومفاتيح النشر للنشر التلقائي

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

  • إدارة مستودعات Git كاملة — استنساخ ودفع وتشعيب ونسخ وأرشفة
  • سير عمل طلبات السحب — مراجعة كود مضمّنة وطلبات مراجعة والدمج بعد الموافقة
  • متتبع المشكلات — تصنيفات ومعالم ومسؤولون وإغلاق عبر كلمات مفتاحية في الالتزامات
  • ويكي مدمج — ويكي Markdown لكل مستودع مع تاريخ التحريرات
  • Webhooks — خطافات HTTP صادرة عند push وPR والمشكلات والإصدارات
  • إدارة مفاتيح نشر ومفاتيح SSH لكل مستودع ومستخدم
  • موفر OAuth2 — استخدم Gitea كـ SSO لـ Woodpecker CI وأدوات أخرى
  • سجل الحزم — استضف حزم npm وPyPI وMaven وDebian وصيغ أخرى

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

  • افتح https://your-domain.com وأكمل معالج الإعداد — اضبط base URL لنطاقك الفعلي
  • أنشئ حساب المسؤول أثناء الإعداد — استخدم كلمة مرور قوية واحفظها في Vaultwarden
  • أنشئ منظمة للفريق: + > New Organization
  • أنشئ مستودعات داخل المنظمة — اضبط الرؤية كـ Private
  • أضف أعضاء الفريق تحت Organization > Teams وخصّص الوصول القراءة/الكتابة/المسؤول لكل مستودع
  • اضبط SMTP في Site Administration > Settings لعمل إشعارات البريد وإعادة تعيين كلمة المرور
  • فعّل المصادقة الثنائية لحسابك الإداري فوراً في User Settings > Security
  • أنشئ تطبيق OAuth2 لـ Woodpecker CI إذا كنت تنشر خط CI/CD

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

  • فعّل المصادقة الثنائية لجميع الحسابات — طبّقها في Site Administration > Required 2FA
  • عطّل تسجيل المستخدمين الذاتي إذا كانت هذه نسخة فريق خاصة — Site Admin > Settings
  • ضع Gitea خلف Nginx Proxy Manager مع HTTPS — لا تكشف المنفذ 3000 مباشرة
  • عطّل SSH إذا كنت تستخدم HTTPS git فقط — يقلل سطح الهجوم في Site Admin
  • حافظ على تحديث Gitea — الإصدارات تحتوي تصحيحات أمنية
  • استخدم مفاتيح نشر (للقراءة فقط) للنشر الآلي — لا تستخدم بيانات مسؤول في CI
  • اضبط الحد الأدنى لطول وتعقيد كلمة المرور في Site Administration > Security
  • راجع حسابات المستخدمين ورموز الوصول دورياً وأبطل الوصول لمن غادر الفريق

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

تعمل Gitea على المنفذ 3000 (HTTP) وبالاختيار 22 (SSH لـ git). ضعها خلف Nginx Proxy Manager على HTTPS المنفذ 443. إذا استخدمت استنساخ git عبر SSH، اكشف المنفذ 22 أو منفذ SSH مخصصاً. عمليات واجهة الويب وgit عبر HTTPS تحتاج المنفذ 443 فقط. لا يجب كشف المنفذ 3000 مباشرة للإنترنت — Nginx فقط يصل إليه.

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

  • استخدم النسخ الاحتياطي المدمج في Gitea: gitea dump — ينشئ zip بالمستودعات وقاعدة البيانات والضبط والمرفقات
  • جدولة هذا الأمر يومياً عبر cron ونسخ الناتج لتخزين بعيد (S3 أو SFTP أو Backblaze)
  • انسخ مجلد البيانات (المستودعات والتحميلات والصور الرمزية) بشكل منفصل للنسخ الاحتياطي التزايدي
  • احتفظ بنسخة من ملف app.ini في نسخة احتياطية منفصلة
  • لنشر Docker، انسخ volumes المثبّتة: /data وvolume قاعدة البيانات
  • اختبر الاستعادة بتشغيل حاوية Gitea جديدة ببيانات نسختك الاحتياطية ربع سنوياً

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

  • ضبط base URL الخاطئ أثناء الإعداد — الـ webhooks وعناوين URL للاستنساخ ستكون خاطئة وإصلاحه مؤلم
  • استخدام حساب مستخدم بدلاً من منظمة لمستودعات الفريق — يحد من إدارة الأذونات
  • عدم ضبط SMTP — لن تعمل رسائل إعادة تعيين كلمة المرور والإشعارات
  • كشف المنفذ 3000 مباشرة بدلاً من استخدام reverse proxy مع HTTPS
  • عدم تفعيل 2FA للحسابات الإدارية — الخطوة الأمنية الأهم
  • تخزين مفاتيح نشر بصلاحية كتابة في خطوط CI — استخدم مفاتيح للقراءة فقط أو رموز
  • عدم جدولة نسخ احتياطية gitea dump منتظمة — فقدان كود مملوك كارثي

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

  • لا يمكن الدفع عبر HTTPS → تحقق من أن base URL في app.ini يطابق نطاقك بالضبط
  • الـ Webhooks لا تُطلق → تحقق من أن URL الـ webhook قابل للوصول من داخل حاوية Gitea
  • البريد لا يُرسل → تحقق من إعدادات SMTP في Site Admin > Settings > Email وأرسل اختباراً
  • مفتاح SSH مرفوض → تأكد من إضافة المفتاح لصفحة SSH Keys إعدادات المستخدم
  • 502 في واجهة الويب → حاوية Gitea على الأرجح لم تبدأ؛ تحقق: docker compose logs gitea
  • دمج طلب السحب محجوب → تحقق من قواعد حماية الفرع التي تتطلب موافقات
  • عمليات المستودع بطيئة → تحقق من I/O القرص على volume البيانات؛ Gitea محدودة بالقرص للمستودعات الكبيرة
  • OAuth2 لـ Woodpecker فاشل → تحقق من أن URI إعادة التوجيه في تطبيق OAuth يطابق تماماً URL callback لـ Woodpecker

البدائل

Forgejo هي fork Gitea الأكثر نشاطاً — بحوكمة مجتمعية، وتوافق مع بيانات Gitea، وأكثر صيانة نشطة من Gitea اعتباراً من 2024. GitLab أكثر اكتمالاً بكثير في المزايا (CI مدمج وسجل حاويات وSAST) لكنه يتطلب 4+ GB RAM كحد أدنى. Gogs هو السلف البسيط لـ Gitea لكنه أقل صيانة. GitHub وGitLab السحابيان خيارات ممتازة إذا لم تحتج الاستضافة الذاتية. Soft-serve forge Git بسيط يعتمد على SSH للوصول عبر الطرفية.

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

تجنب Gitea إذا كنت بحاجة لـ CI/CD مدمج بدون نشر أداة منفصلة — GitLab CE يتضمن runner CI خاص. لا تستخدم Gitea إذا كان فريقك سعيداً على GitHub ولا يوجد سبب امتثال أو خصوصية للاستضافة الذاتية. تفتقر Gitea أيضاً لفحص الأمان المتقدم (SAST/DAST) وتتبع ثغرات التبعيات وسجلات تدقيق الامتثال التي توفرها GitLab Enterprise.

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

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

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

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

ما الفرق بين Gitea وForgejo؟

Forgejo هي fork مجتمعية من Gitea أُنشئت عام 2022 عند ظهور مخاوف بشأن حوكمة Gitea واتجاهها التجاري. Forgejo متوافقة تماماً مع بيانات Gitea وAPIs، وتتمتع بصيانة مجتمعية أكثر نشاطاً، وموقف أقوى من الحوكمة المفتوحة. كلاهما خيار ممتاز؛ يوصي كثيرون في مجتمع الاستضافة الذاتية بـ Forgejo للنشر الجديد. كلاهما يستورد من الآخر ويصدر إليه دون أي مشكلة.

كيف أضبط Gitea مع Woodpecker CI؟

في Gitea، اذهب لـ Settings > Applications > OAuth2 Applications وأنشئ تطبيقاً جديداً بـ URL callback لـ Woodpecker (https://woodpecker.yourdomain.com/authorize). انسخ client ID والسر. في docker-compose.yml لـ Woodpecker، اضبط WOODPECKER_GITEA=true وWOODPECKER_GITEA_URL وWOODPECKER_GITEA_CLIENT وWOODPECKER_GITEA_SECRET. ابدأ Woodpecker وسجّل دخولك — سيصادق تلقائياً عبر Gitea.

هل يمكنني نسخ مستودع GitHub إلى Gitea؟

نعم. في Gitea، انقر + > New Migration > GitHub. أدخل URL المستودع وبالاختيار رمز GitHub للمستودعات الخاصة. فعّل 'Mirror this repository' لإبقائه متزامناً تلقائياً. ستسحب Gitea الالتزامات والفروع والعلامات الجديدة من GitHub وفق جدول قابل للضبط. مفيد لنسخ المستودعات العامة المهمة احتياطياً أو العمل بدون إنترنت.

هل تدعم Gitea تخزين الملفات الكبيرة (LFS)؟

نعم، تدعم Gitea Git LFS مدمجاً. فعّله في app.ini تحت [server] و[lfs] (أو في متغيرات بيئة Docker). تُخزَّن كائنات LFS في مجلد بيانات Gitea افتراضياً. يمكنك أيضاً ضبط Gitea لاستخدام مخزن كائنات متوافق مع S3 لـ LFS — مستحسن للمستودعات الكبيرة ذات الأصول الثنائية الكثيرة.

كيف أنتقل من GitHub إلى Gitea؟

استخدم أداة الترحيل المدمجة في Gitea: انقر + > New Migration > GitHub. تستورد هذا المستودعات مع المشكلات وطلبات السحب والتصنيفات والمعالم والتعليقات والإصدارات. لكل متعاون، يحتاج لحساب Gitea لإجراء التعيين. بعد الترحيل، حدّث مستودعاتك المحلية: git remote set-url origin https://gitea.yourdomain.com/org/repo. حدّث أي webhooks CI/CD وتسجيلات مفاتيح نشر.

هل يمكن استخدام Gitea كموفر هوية OAuth2 لتطبيقات أخرى؟

نعم. تدعم Gitea العمل كموفر OAuth2. في Site Administration > Applications، أنشئ تطبيق OAuth2 لكل تطبيق يجب أن يستخدم تسجيل دخول Gitea. Woodpecker CI وGrafana وكثير من التطبيقات تدعم Gitea OAuth2 بشكل أصلي. هذا يعني أن فريقك يحتفظ بمجموعة واحدة فقط من البيانات — Gitea تصبح SSO الداخلي للأدوات ذاتية الاستضافة.

كيف أحدّث Gitea بأمان؟

شغّل gitea dump أولاً لإنشاء نسخة احتياطية كاملة. ثم اسحب صورة Docker الجديدة: docker compose pull && docker compose up -d. تُشغّل Gitea أي ترقيات قاعدة بيانات ضرورية تلقائياً عند بدء التشغيل. تحقق من ملاحظات الإصدار عن التغييرات الجذرية — ترقيات الإصدارات الرئيسية تتطلب أحياناً خطوات يدوية. احتفظ بأحدث نسختين على الأقل قبل الترقية.

هل Gitea مناسبة لفريق من 50 مطوراً؟

نعم، تتعامل Gitea مع 50+ مطوراً بسهولة على أجهزة متواضعة (2 vCPU، 2 GB RAM). بيئة تشغيل Go عالية التزامن وتم استخدام Gitea في الإنتاج على نطاق أوسع بكثير. للفرق ذات التزامن العالي، استخدم PostgreSQL بدلاً من SQLite وتأكد من وجود بيانات المستودع على تخزين SSD سريع. كفاءة موارد Gitea هي أحد مزاياها الرئيسية على GitLab للفرق المتوسطة الحجم.