🦊 تثبيت Forgejo — منصة استضافة Git ذاتية مملوكة للمجتمع
انشر Forgejo على Ubuntu بـ Docker — نسخة Gitea المشتقة بقيادة المجتمع والتي يعمل عليها Codeberg، مع استضافة Git وطلبات الدمج وسجلات الحزم وأتمتة CI/CD مدمجة.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/dev/forgejo/forgejo-ubuntu.sh
chmod +x forgejo-ubuntu.sh
sudo bash forgejo-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/dev/forgejo/forgejo-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x forgejo-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker إن لزم، يسحب صورة Forgejo الرسمية، ويُشغّل الحاوية مع تخزين دائم للمستودعات وقاعدة البيانات ومفاتيح SSH المضيفة.
sudo bash forgejo-ubuntu.sh
4 الدخول إلى واجهة الويب
افتح المتصفح وأكمل معالج التثبيت لإنشاء حساب المشرف:
http://:3000
# First run opens the setup wizard — create the admin account there
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3000 | Forgejo Web UI (HTTP) |
| 222 | Git over SSH (maps to container port 22) |
نظرة عامة
Forgejo هي منصة استضافة Git ذاتية الاستضافة ومملوكة للمجتمع — نسخة متفرعة بالكامل (hard fork) من Gitea أُنشئت في أكتوبر 2022 بعد أن انتقلت إدارة Gitea إلى شركة ربحية. تجمع Forgejo بين استضافة المستودعات وتتبع المشكلات وطلبات الدمج والويكي ولوحات المشاريع وسجلات الحزم وأتمتة Forgejo Actions لـ CI/CD في ملف تنفيذي واحد خفيف مكتوب بلغة Go. تشغّل Forgejo منصة Codeberg، إحدى أكبر منصات استضافة الأكواد غير الربحية، وتُدار بشفافية عبر جمعية Forgejo e.V. بدلاً من شركة تجارية واحدة.
لماذا تستخدمه
تخزّن GitHub وGitLab.com وBitbucket أكوادك ومشكلاتك وخطوط CI الخاصة بك على بنية تحتية مملوكة لجهة أخرى يمكنها تغيير الأسعار أو الشروط في أي وقت. تمنحك Forgejo تجربة عمل مطابقة تقريباً — طلبات دمج، مراجعة كود، مشكلات، CI قائم على Actions — بالكامل على سيرفرك الخاص، تحت رخصة copyleft تديرها جهة مجتمعية غير ربحية بدلاً من شركة تسعى لبيع نفسها. Forgejo أخف بكثير من GitLab CE وتعمل بارتياح على VPS صغير، ومحرك Actions فيها يفهم جزءاً كبيراً من صياغة YAML الخاصة بـ GitHub Actions، ما يجعل نقل خطوط العمل الحالية مسألة توجيهها لمشغّلاتك (runners) الخاصة فقط.
متى تحتاجه
- تريد مستودعات Git خاصة وذاتية الاستضافة لمشاريع الشركة أو الشخصية دون تسعير لكل مستخدم كخدمة سحابية
- تحتاج خطوط CI/CD تعمل على مشغّلاتك الخاصة بدلاً من بنية تحتية مشتركة تابعة لطرف ثالث
- لدى مؤسستك متطلبات امتثال أو إقامة بيانات تمنع تخزين الكود المصدري على سحابات عامة
- تصون مشاريع مفتوحة المصدر وتريد نموذج حوكمة لا تتحكم فيه شركة ربحية واحدة
- تجاوزت إعداد Git عبر SSH البسيط وتحتاج المشكلات وطلبات الدمج ومراجعة الكود في مكان واحد
من يحتاجه
- فرق التطوير الصغيرة والشركات الناشئة التي تريد تعاوناً شبيهاً بـ GitHub دون فاتورة شهرية لكل مستخدم
- مشرفو المشاريع مفتوحة المصدر الذين يفضلون منصة تُدار بشكل غير ربحي بدلاً من منصة مملوكة تجارياً
- عشاق الاستضافة الذاتية الذين يبنون مختبراً منزلياً أو سيرفر Git شخصياً للمشاريع الجانبية وملفات dotfiles
- المؤسسات ذات متطلبات سيادة البيانات الصارمة أو الشبكات المعزولة (air-gapped) لكودها المصدري
- الوكالات والمستقلون الذين يستضيفون مستودعات العملاء ويحتاجون تحكماً كاملاً في الوصول والنسخ الاحتياطي
- فرق DevOps المهاجرة من Gitea والراغبة في استمرار الحوكمة المفتوحة والتطوير المدفوع بالمجتمع
- المؤسسات التعليمية التي تُشغّل استضافة Git داخلية لمشاريع الطلاب والأبحاث
- المطورون المهتمون بالخصوصية الذين لا يريدون تتبعاً أو تحليلات من طرف ثالث على سجل التزاماتهم البرمجية
حالات الاستخدام الشائعة
- استضافة مستودعات Git خاصة وعامة للفرق مع قواعد حماية فروع ومراجعة دقيقة
- تشغيل خطوط CI/CD عبر Forgejo Actions باستخدام workflows بصيغة YAML متوافقة مع صياغة GitHub Actions
- نشر واستهلاك الحزم عبر سجلات npm وMaven وPyPI والحاويات المدمجة
- تتبع المشكلات والمعالم (milestones) ولوحات المشاريع جنباً إلى جنب مع الكود المرتبط بها
- استنساخ (mirror) مستودعات من GitHub أو GitLab لأغراض النسخ الاحتياطي أو الترحيل
- توفير استضافة Git للأدوات الداخلية ومستودعات البنية التحتية ككود خلف VPN
الميزات الرئيسية
- استضافة Git كاملة مع طلبات دمج ومراجعة كود وحماية فروع وطوابير دمج
- Forgejo Actions — محرك CI/CD مدمج متوافق مع جزء كبير من صياغة workflows الخاصة بـ GitHub Actions
- دعم سجلات الحزم لـ npm وMaven وPyPI وNuGet وCargo وComposer وDocker/OCI والحزم العامة
- متتبع مشكلات مع تصنيفات ومعالم ولوحات مشاريع بأسلوب Kanban
- ويكي مدمج لكل مستودع لتوثيق يعيش جنباً إلى جنب مع الكود
- دعم LDAP وOAuth2 وOpenID Connect للمصادقة المركزية وتسجيل الدخول الموحد
- اتحاد (federation) تجريبي قائم على ActivityPub لمتابعة المستودعات والمستخدمين عبر نسخ Forgejo مختلفة
- ملف تنفيذي خفيف بلغة Go يعمل بارتياح على أجهزة متواضعة، بما فيها Raspberry Pi أو VPS بمعالج واحد
كيفية الاستخدام بعد التثبيت
- أكمل معالج التثبيت بضبط عنوان الموقع وقاعدة البيانات وبيانات حساب المشرف
- اضبط إعدادات سيرفر SSH ليتمكن المطورون من الاستنساخ والدفع عبر Git+SSH على المنفذ 222
- أنشئ منظمة (organization) لتجميع المستودعات المرتبطة وإدارة صلاحيات الفرق
- أعدّ Forgejo Actions بتسجيل مشغّل ذاتي الاستضافة وتفعيل الـ actions في إعدادات المستودع
- فعّل المصادقة الثنائية لحساب المشرف تحت Settings → Security
- اضبط البريد الصادر (SMTP) لضمان وصول رسائل إعادة تعيين كلمة المرور والتنبيهات بشكل موثوق
- استورد المستودعات الموجودة من GitHub أو GitLab باستخدام أداة ترحيل المستودعات المدمجة
- أعدّ قواعد حماية الفرع الافتراضي لتتطلب مراجعة قبل دمج طلبات الدمج
أفضل ممارسات الأمان
- ضع Forgejo خلف وكيل عكسي مع HTTPS — لا تكشف المنفذ 3000 مباشرة للإنترنت بنص HTTP عادي
- عطّل التسجيل العام تحت Settings → Security إذا كانت هذه نسخة خاصة بفريق داخلي، لمنع تسجيلات غير مرغوبة
- فرض المصادقة الثنائية لجميع حسابات المشرفين والمشرفين على المستودعات
- أبقِ وصول SSH على منفذ مخصص (222 في هذا الإعداد) وقيّده بـ fail2ban أو قائمة سماح في الجدار الناري
- راجع قائمة تطبيقات OAuth2 المثبتة دورياً وألغِ رموز API غير المستخدمة
- حدّث صورة Forgejo Docker باستمرار — تصدر تحديثات أمنية بانتظام من المشروع الأساسي
- قيّد مشغّلات Forgejo Actions حتى لا تنفّذ طلبات الدمج غير الموثوقة كوداً عشوائياً باستخدام أسرار المستودع
- احتفظ بنسخة احتياطية من قيمتي SECRET_KEY وINTERNAL_TOKEN من app.ini — فقدانهما يجعل الجلسات والرموز الحالية غير قابلة للاسترداد
المنافذ وإعدادات جدار الحماية
تستمع Forgejo على المنفذ 3000 لواجهة الويب وواجهة API عبر HTTP، وعلى المنفذ 22 داخل الحاوية لـ Git عبر SSH، والذي يربطه هذا الإعداد بالمنفذ 222 على المضيف لتجنب التعارض مع خدمة SSH الخاصة بالمضيف نفسه. يجب أن يكون المنفذ 3000 خلف وكيل عكسي مثل Nginx Proxy Manager ينهي HTTPS على المنفذ 443 — لا تحتاج Forgejo نفسها لأن تكون متاحة مباشرة. يمكن ترك المنفذ 222 (SSH) مفتوحاً للإنترنت إذا أردت للمطورين الاستنساخ والدفع عن بُعد، لأن Git عبر SSH يُصادَق بمفتاح عام، لكن قيّده بنطاقات IP معروفة قدر الإمكان. احظر الوصول المباشر للمنفذ 3000 في الجدار الناري لحركة المرور الخارجية.
النسخ الاحتياطي والصيانة
- انسخ احتياطياً حجم بيانات Forgejo الذي يحتوي المستودعات وقاعدة SQLite أو الخارجية والصور الرمزية والمرفقات
- صدّر app.ini مع حجم البيانات — يحتوي على SECRET_KEY وINTERNAL_TOKEN وكل إعدادات السيرفر
- إذا كنت تستخدم قاعدة بيانات خارجية (PostgreSQL أو MySQL)، خذ نسخة احتياطية منها بشكل منفصل ومجدول بالإضافة إلى حجم البيانات
- انسخ احتياطياً مفاتيح SSH المضيفة المخزنة في دليل البيانات حتى لا تتعطل روابط SSH الحالية بعد الاستعادة
- خزّن النسخ الاحتياطية خارج المضيف — نسخة على نفس القرص الذي عليه البيانات الحية لا تحميك من عطل القرص
- اختبر الاستعادة دورياً على سيرفر احتياطي للتأكد من عودة المستودعات والمشكلات وحسابات المستخدمين سليمة
الأخطاء الشائعة
- كشف المنفذ 3000 مباشرة للإنترنت دون وكيل عكسي أو إنهاء TLS
- نسيان نسخ app.ini احتياطياً — فقدان SECRET_KEY يُبطل كل جلسات المستخدمين ورموز API الحالية
- تشغيل مشغّلات Forgejo Actions بوصول لأسرار الإنتاج على مستودعات تقبل طلبات دمج عامة
- ربط منفذ SSH في الحاوية بالمنفذ الافتراضي 22 على المضيف، ما يتعارض مع خدمة SSH الخاصة بالمضيف
- ترك التسجيل العام مفعّلاً على نسخة مخصصة لفريق داخلي فقط
- تخطي النسخ الاحتياطي لقاعدة البيانات عند استخدام PostgreSQL أو MySQL بدلاً من SQLite المدمجة
- عدم ضبط ROOT_URL بشكل صحيح في app.ini بعد الانتقال خلف وكيل عكسي، ما يكسر روابط الاستنساخ والـ webhooks
- تجاهل ملاحظات الترقية بين الإصدارات الرئيسية، والتي تتضمن أحياناً تغييرات إعداد جذرية
استكشاف الأخطاء وإصلاحها
- لا يمكن الاستنساخ عبر SSH — تحقق أن ربط منفذ SSH في الحاوية (222) يطابق ما تستخدمه في رابط git remote وأن الجدار الناري يسمح به
- واجهة الويب غير متاحة بعد إعداد الوكيل العكسي — تأكد أن ROOT_URL في app.ini يطابق نطاق HTTPS الخارجي وليس عنوان الحاوية الداخلي
- مشغّل Forgejo Actions لا يستلم المهام — تحقق أن المشغّل مسجّل برمز صالح وأن الـ actions مفعّلة في إعدادات المستودع
- فشل رفع الحزم في سجل الحزم — تحقق من نقطة نهاية نوع الحزمة الصحيحة وأن للمستخدم المصادَق صلاحية كتابة على المالك المستهدف
- إشعارات البريد لا تُرسَل — راجع إعدادات SMTP في app.ini واختبرها بأداة 'إرسال بريد تجريبي' المدمجة في لوحة الإدارة
- عمليات بطيئة على المستودعات الكبيرة — فعّل Git LFS للملفات الثنائية وفكّر في زيادة حد ذاكرة الحاوية
- حلقة تسجيل دخول أو أخطاء جلسة بعد الاستعادة — تأكد أن SECRET_KEY وINTERNAL_TOKEN استُعيدا مع حجم البيانات
- توقف الترحيل من GitHub عند المستودعات الكبيرة — زد مهلة الترحيل أو رحّل عبر git clone --mirror ثم الدفع يدوياً
البدائل
Gitea هو المشروع الأصلي الذي تفرعت منه Forgejo — لا يزال يعمل بكامل ميزاته وشبيهاً في الوظائف، لكن حوكمته انتقلت نحو شركة ربحية (Gitea Ltd)، وهو السبب في وجود Forgejo كبديل مستقل تُدار حوكمته بشكل غير ربحي. يقدم GitLab Community Edition مجموعة أدوات DevOps مدمجة أوسع (سجل حاويات، فحص أمني، CI أكثر تقدماً) لكنه أثقل بكثير على الذاكرة والمعالج. Gogs هو سيرفر Git الأصلي الخفيف المكتوب بـ Go الذي تفرعت منه Gitea نفسها قبل سنوات، وصيانته أقل نشاطاً اليوم. GitHub وGitLab.com هما المعادلان المستضافان سحابياً (غير ذاتيي الاستضافة) — مريحان لكن بتكاليف متكررة وكودك مخزن على خوادم جهة أخرى. كمنصة Git خفيفة نشطة الصيانة ومُدارة مجتمعياً مع CI/CD حقيقي مدمج، Forgejo هي الخيار الواضح.
متى لا تستخدمه
إذا كنت تحتاج ميزات DevOps المدمجة الأكثر تقدماً في GitLab — فحص أمني للحاويات، فحص التبعيات، أو خط نشر متكامل بالكامل مع Kubernetes — فإن GitLab CE خيار أنسب رغم استهلاكه الأكبر للموارد. إذا كنت تحتاج فقط عدداً قليلاً من المستودعات الخاصة دون اهتمام بالاستضافة الذاتية أو الصيانة، فإن الخطة المجانية من GitHub أبسط بدون أي صيانة سيرفر. Forgejo Actions، رغم توافقها مع جزء كبير من صياغة GitHub Actions، لا تدعم كل action من GitHub Marketplace، لذا يجب على الفرق ذات خطوط GitHub Actions المعقدة التحقق من التوافق قبل الترحيل الكامل.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل Forgejo مجانية فعلاً، وما الفرق بينها وبين Gitea؟
نعم، Forgejo مجانية بالكامل ومفتوحة المصدر تحت رخصة GPL. إنها نسخة متفرعة بالكامل من Gitea أُنشئت في أكتوبر 2022 بعد أن انتقل تطوير Gitea تحت شركة Gitea Ltd الربحية. بدلاً من ذلك، تُدار Forgejo عبر جمعية Forgejo e.V. غير الربحية، ما يبقي المشروع مدفوعاً بالمجتمع دون تحكم شركة واحدة في اتجاهه.
هل تدعم Forgejo خطوط CI/CD؟
نعم، عبر Forgejo Actions، وهو محرك CI/CD مدمج متوافق مع جزء كبير من صياغة YAML الخاصة بـ GitHub Actions. تسجّل مشغّلات (runners) ذاتية الاستضافة على نسختك، وتعمل workflows المعرّفة في .forgejo/workflows/ تلقائياً عند الدفع أو طلب الدمج أو حسب جدول زمني، تماماً مثل GitHub Actions.
هل يمكنني ترحيل مستودعاتي الحالية من GitHub أو GitLab إلى Forgejo؟
نعم. تتضمن Forgejo أداة ترحيل مستودعات مدمجة تستورد المستودعات والمشكلات وطلبات الدمج والإصدارات والويكي مباشرة من GitHub وGitLab وGitea ومضيفي Git آخرين بتوفير رابط المصدر ورمز وصول إذا لزم الأمر.
ما هو Codeberg وما علاقته بـ Forgejo؟
Codeberg هي منصة استضافة أكواد غير ربحية كبيرة تديرها جمعية Codeberg e.V. وتعمل على Forgejo كبرمجية أساسية. توضح Codeberg كيف تعمل Forgejo على نطاق واسع، وغالباً ما يُستشهد بها كأبرز مثال علني على شكل نسخة Forgejo في بيئة إنتاجية.
ما هي أدنى متطلبات السيرفر لتشغيل Forgejo؟
Forgejo خفيفة جداً — يمكنها العمل بذاكرة 512 ميغابايت فقط ومعالج افتراضي واحد للفرق الصغيرة، لأنها ملف تنفيذي واحد مكتوب بـ Go بحد أدنى من الاعتماديات. الفرق الكبيرة ذات المستودعات الكثيرة ومشغّلات CI وسجلات الحزم يجب أن تحجم السيرفر حسب عدد المستودعات وحمل CI بدلاً من خط أساس ثابت.
