> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# Forgejo أم Gitea أم GitLab CE؟ الترحيل خطوة بخطوة
- URL: https://arabroot.io/articles/forgejo-ام-gitea-ام-gitlab-ce-الترحيل-خطوة-بخطوة/
- Published: 2026-11-03T18:38:40.000Z
- Updated: 2026-11-03T19:38:16.000Z
- Description: قصة انقسام Forgejo عن Gitea وما يعنيه الترخيص والحوكمة لفريقك، ومقارنة مع GitLab CE، ثم ترحيل حقيقي من Gitea 28.3 إلى Forgejo 17 يبين ما ينتقل وما يضيع في الطريق.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, DevOps والتشغيل, DevOps وCI/CD, الاستضافة الذاتية, Forgejo

إذا كنت تشغل Gitea لفريقك منذ سنوات، فغالباً مر عليك اسم Forgejo في نقاش ما، مع جملة مثل «Forgejo هو Gitea الحقيقي» أو «Gitea أصبح شركة». ثم تفتح الموقعين فتجد واجهتين متشابهتين لدرجة أنك قد تخلط بينهما، وأوامر متشابهة، وتوثيقاً متشابهاً، وتسأل السؤال العملي الذي يهمك أنت: هل يجب أن أنتقل؟ وإذا انتقلت، هل أبدل الصورة في ملف Compose وينتهي الأمر؟ وماذا عن GitLab الذي يقول عنه زميلك إنه «يأتي معه كل شيء»؟ وفي فريقنا هذا الأسبوع كان السؤال نفسه على الطاولة: سيرفر Gitea 28.3 عليه مستودع خدمة المتجر، فيه الكود والتذاكر وطلبات الدمج والإصدارات والويكي، والإدارة تريد قراراً موثقاً وليس رأياً.

وفي هذا المقال نبدأ من القصة نفسها، لأنك لن تفهم الفرق بين Forgejo وGitea دون أن تعرف كيف انقسما، ثم نضع المشاريع الثلاثة Forgejo وGitea وGitLab CE في جدول واحد بالأشياء التي تهمك عند الاختيار. وبعدها ننفذ الترحيل فعلاً من Gitea 28.3.0 إلى Forgejo 17.0.1 في مختبر: نجرب الطريق المختصر الذي يخطر على بال الجميع ونرى لماذا يرفضه Forgejo، ثم ننقل المستودع بأداة الترحيل المدمجة، ونقارن ما انتقل وما لم ينتقل بنداً بنداً، ومعه ثلاث مشكلات حقيقية ظهرت في الطريق. وسوف نناقش في هذا المقال ما يلي:

- قصة الانقسام: من Gogs إلى Gitea في 2016، ثم شركة Gitea Limited في 2022، ثم ولادة Forgejo مع Codeberg.
- الترخيص: MIT في Gitea وGPLv3+ في Forgejo منذ الإصدار 9.0، وماذا يعني ذلك لمن يستضيف لنفسه.
- أين يقف GitLab CE، وماذا يكلف تشغيله مقارنة بالاثنين.
- جدول مقارنة للقرار.
- الطريق المختصر: تشغيل Forgejo على بيانات Gitea الحديثة، والخطأ الذي يوقفه.
- الترحيل من الواجهة: رمز الوصول، ورفض HTTP، وما انتقل وما لم ينتقل، والويكي الذي لم ينتقل دون أي رسالة.
- تحويل نسخ المطورين، وخطة ترحيل للفريق، ومتى تبقى على Gitea ومتى تختار GitLab.

## قصة الانقسام History

### من Gogs إلى Gitea

القصة تبدأ قبل Gitea نفسه، مع Gogs، وهو خادم Git خفيف مكتوب بلغة Go يعمل بملف تنفيذي واحد. وفي 2016 نسخ عدد من المساهمين كوده وبدأوا مشروعاً جديداً اسمه Gitea يديره مجتمعه. ويقول [توثيق Gitea](https://docs.gitea.com/?ref=arabroot.io) إن المشروع بدأ نسخة من Gogs، وإن أغلب الكود تغير منذ ذلك الوقت، وما زال ملف الترخيص في المستودع يحمل سطري حقوق «Copyright (c) 2016 The Gitea Authors» و«Copyright (c) 2015 The Gogs Authors» تحت [ترخيص MIT](https://github.com/go-gitea/gitea/blob/main/LICENSE?ref=arabroot.io). وهذا الانقسام الأول يستحق أن تتذكره، لأن ما حدث بعده تكرار للنمط نفسه: مشروع مفتوح، ثم خلاف على من يقرر، ثم نسخة جديدة.

### شركة Gitea Limited في 2022

في 24 أكتوبر 2022 نشرت مدونة Gitea [إعلاناً](https://blog.gitea.com/open-source-sustainment/?ref=arabroot.io) بمناسبة مرور ست سنوات على المشروع، تقول فيه إن الفريق أسس شركة اسمها Gitea Limited لتكون راعية للمشروع، وإن مؤسس المشروع نقل إليها أسماء النطاقات والعلامات التجارية، وإن الشركة سوف تقدم استضافة Gitea كخدمة، ونسخة مؤسسية محسنة، ودعماً فنياً وتدريباً. ويقول الإعلان إن المشروع سوف يبقى مفتوح المصدر ومشروعاً مجتمعياً، ويذكر أن شركات كثيرة تستخدم Gitea دون أن تساهم فيه، وهذا من أسباب البحث عن طريقة لتمويل التطوير. والدافع مفهوم، فصيانة مشروع بهذا الحجم بمتطوعين فقط صعبة، ولكن الطريقة أغضبت جزءاً من المساهمين، لأن القرار وانتقال النطاقات والعلامة التجارية حدث دون استشارتهم.

### ولادة Forgejo مع Codeberg

بعد أقل من شهرين، في 15 ديسمبر 2022، أعلن عدد من المساهمين عن [Forgejo](https://forgejo.org/2022-12-15-hello-forgejo/?ref=arabroot.io). ويقول الإعلان إن المشروع جاء رداً على أخذ السيطرة على Gitea من المجتمع بواسطة الشركة الربحية الجديدة دون استشارة مسبقة، وإن جمعية Codeberg e.V. غير الربحية، التي تشغل منصة Codeberg لاستضافة المشاريع المفتوحة، هي الوصية على المشروع ونطاقاته وعلامته التجارية، وتستخدمه في خدماتها. والاسم من كلمة forĝejo بلغة الإسبرانتو، وتعني ورشة الحدادة Forge، وهي الكلمة التي يستخدمها مجتمع البرمجيات لمنصات استضافة الكود.

وفي سنته الأولى كان Forgejo نسخة لينة Soft Fork: مجموعة تعديلات فوق Gitea، يأخذ كل إصدار من Gitea ويضيف إليه تغييراته. ثم في 2024 أصبح [نسخة صلبة Hard Fork](https://forgejo.org/2024-02-forking-forward/?ref=arabroot.io) يتطور كوده وحده، وبدأ المشروعان يتباعدان. وهذا التباعد هو سبب كل ما سوف نراه في المختبر، لأن قاعدة بيانات كل مشروع أصبحت تتغير بطريقته، كما يشرح [إعلان Forgejo عن حدود التوافق](https://forgejo.org/2024-12-gitea-compatibility/?ref=arabroot.io): آخر إصدار من Gitea يمكن ترقيته مباشرة إلى Forgejo هو 1.22، والإصدار Forgejo 10.0 الذي صدر في 15 يناير 2025 هو آخر إصدار يقبل هذه الترقية، والإصدارات التالية لا تدعم الترقية من Gitea 1.23 أو أحدث.

![خط زمني: Gogs في 2014، ثم Gitea نسخة منه في 2016 بترخيص MIT، ثم شركة Gitea Limited في 24 أكتوبر 2022، ثم إعلان Forgejo تحت Codeberg e.V. في 15 ديسمبر 2022 كنسخة لينة، ثم نسخة صلبة في 2024، ثم ترخيص GPLv3+ من الإصدار 9.0، ثم Forgejo 10.0 في 15 يناير 2025 آخر إصدار يقبل الترقية من Gitea 1.22، ثم في 2026 Forgejo 17.0.1 وGitea 28.3.0](https://arabroot.io/content/images/2026/11/forgejo-01-timeline.webp)

انقسامان في عشر سنوات، وبعد 2024 لم يعد الانتقال المباشر من Gitea الحديث ممكناً

### الترخيص License: MIT مقابل GPLv3+

في أغسطس 2024 أعلن Forgejo أن [الإصدارات من 9.0 وما بعدها](https://forgejo.org/2024-08-gpl/?ref=arabroot.io) تصدر بترخيص GPL الإصدار الثالث أو أحدث، أي GPLv3+، بينما بقيت الإصدارات السابقة مثل 7.0 و8.0 بترخيص MIT. والأسباب التي ذكرها الإعلان: أن الترخيص الحر المتبادل Copyleft يسمح للمشروع أن يستخدم أعمالاً أخرى بالترخيص نفسه، وأن بعض الاعتماديات كانت غير متوافقة مع الترخيص السابق واضطروا لإزالتها، وأنه يحمي المستخدمين من ممارسات مثل الحبس عند مزود واحد Vendor Lock-in. أما Gitea فما زال بترخيص MIT.

وقد تسأل: هل يغير هذا شيئاً لفريق يشغل Forgejo على سيرفره لاستخدامه الداخلي؟ والجواب غالباً لا. فترخيص GPL يفرض شروطه عندما توزع البرنامج أو نسخة معدلة منه لغيرك، فعندها يجب أن تعطيهم الكود المصدري بالترخيص نفسه، أما تشغيله لفريقك فلا يفرض عليك شيئاً. ويهمك الفرق في حالتين: إذا كانت شركتك تبني منتجاً تجارياً فوق كود المنصة نفسها وتبيعه، أو إذا كانت عندك سياسة داخلية تمنع تراخيص Copyleft. وفي أي حالة غير واضحة اسأل المختص القانوني عندكم، لأن هذا المقال لا يغني عن ذلك. وفي المقابل يقول Forgejo في [صفحة مقارنته مع Gitea](https://forgejo.org/compare-to-gitea/?ref=arabroot.io) إن Gitea يطلب من المساهمين التنازل عن حقوق النشر Copyright Assignment، وإنه يتبع نموذج Open Core بميزات غير حرة في نسخته المؤسسية، وهذه أوصاف من طرف واحد في خلاف قائم، فاقرأها كذلك، واقرأ ما تقوله Gitea عن نفسها أيضاً.

والحوكمة ليست كلاماً نظرياً لمن يدير سيرفراً. فالسؤال العملي هو: من سوف يصدر الإصلاح الأمني عندما تظهر ثغرة، وبأي سرعة، وهل ستعرف عنها قبل غيرك أم بعده؟ وتقول صفحة المقارنة في Forgejo إن الإشعار المسبق بالإصدارات الأمنية متاح للجميع في Forgejo، ولعملاء Gitea فقط في Gitea. وبغض النظر عن رأيك في الخلاف، فالخطوة التي تنطبق على المشروعين واحدة: اشترك في قناة الإعلانات الأمنية للمشروع الذي تختاره، وضع في خطتك وقتاً للترقية خلال أيام من أي إصدار أمني، لأن سيرفر Git فيه كود الشركة كله، وغالباً أسرار خطوط CI أيضاً.

## أين يقف GitLab CE؟

GitLab مشروع من عالم آخر من حيث الحجم. فهو منصة كاملة لدورة حياة البرمجيات: استضافة الكود، وطلبات الدمج، وخطوط CI/CD مدمجة منذ سنوات طويلة، وسجل Container Images، وإدارة المشاريع، وأدوات أمنية، وغيرها. ونسخته المجتمعية Community Edition مفتوحة المصدر، وملف الترخيص في [مستودعها](https://gitlab.com/gitlab-org/gitlab-foss/-/blob/master/LICENSE?ref=arabroot.io) يقول إن الكود خارج المجلدات المستثناة بترخيص MIT Expat. أما الميزات المتقدمة فهي في النسخة المؤسسية المدفوعة، وهذا هو نموذج Open Core بوضوح.

والفرق العملي الأول هو الموارد. يقول [توثيق متطلبات GitLab](https://docs.gitlab.com/install/requirements/?ref=arabroot.io) إن الأساس لتثبيت على سيرفر واحد 8 vCPU و16 GB من الذاكرة، وإنه يمكن أن يعمل بثمانية جيجابايت على الأقل في البيئات محدودة الذاكرة، ويحتاج PostgreSQL. وفي مختبرنا، بعد الترحيل وهما دون عمل، كان Gitea يستخدم نحو 107 MiB من الذاكرة، وForgejo نحو 196 MiB، كما قرأناها من `docker stats`، وكلاهما على SQLite. والأرقام وهما خاملان لا تمثل سيرفراً عليه فريق يعمل، ولكن الفرق في الترتيب نفسه، أي ميغابايتات مقابل جيجابايتات، وهذا يحسم القرار لكثير من الفرق الصغيرة: GitLab يحتاج سيرفراً خاصاً به، وGitea أو Forgejo يعملان بجانب خدماتك الأخرى.

والفرق الثاني هو المجتمع والأدوات حوله. GitLab منتشر في الشركات الكبيرة، وكثير من المطورين يعرفونه، وله تكاملات مع أغلب الأدوات. فإذا كانت شركتك ستنمو إلى مئات المطورين، أو تحتاج ميزات مثل إدارة المشاريع على مستوى المؤسسة، فقد يكون الاستثمار في GitLab من البداية أرخص من ترحيل ثان بعد سنتين.

### الترحيل إلى GitLab من Gitea Import

وإذا اخترت GitLab، فالطريق من Gitea يشبه ما سوف نراه مع Forgejo. يذكر [توثيق مستورد Gitea في GitLab](https://docs.gitlab.com/user/project/import/gitea/?ref=arabroot.io) أنه ينقل وصف المستودع وبيانات Git والتذاكر وطلبات الدمج والمراحل والتسميات وتعليقات الفروقات في طلبات الدمج، وأنه يحتاج Gitea 1.0.0 أو أحدث ورمز وصول شخصياً من Gitea. ويذكر أيضاً أن الكاتب أو المكلف لا يمكن ربطه بمستخدمي GitLab وقت الاستيراد، فيصبح منشئ المشروع هو الكاتب، ويبقى اسم الكاتب الأصلي ظاهراً على التذاكر، ويقترح ربط المستخدمين بعد الترحيل بميزة خاصة لذلك. أي أن مشكلة أصحاب التذاكر التي سوف نراها بعد قليل ليست خاصة بForgejo، وإنما طبيعة الترحيل بين منصتين لكل منهما حساباتها. والفرق أن GitLab يقدم أداة لربط المستخدمين بعد الترحيل.

## المقارنة Comparison

| المعيار                        | Forgejo                               | Gitea                         | GitLab CE                              |
| ------------------------------ | ------------------------------------- | ----------------------------- | -------------------------------------- |
| من يملك القرار                 | جمعية Codeberg e.V. غير الربحية       | شركة Gitea Limited            | شركة GitLab Inc.                       |
| الترخيص                        | GPLv3+ منذ 9.0                        | MIT                           | MIT للنسخة المجتمعية، والمؤسسية مدفوعة |
| آخر إصدار في المختبر           | 17.0.1، والإصدار طويل الدعم 15.0      | 28.3.0                        | لم نشغله في المختبر                    |
| الذاكرة في المختبر دون عمل     | نحو 196 MiB                           | نحو 107 MiB                   | التوثيق: أساس 16 GB                    |
| CI مدمج                        | Forgejo Actions مع Runner منفصل       | Gitea Actions مع Runner منفصل | GitLab CI مع Runner منفصل              |
| سياسة الدعم الطويل             | إصدار LTS كل سنة يدعم سنة وثلاثة أشهر | بحسب صفحة الإصدارات           | بحسب صفحة الإصدارات                    |
| الترقية من Gitea 1.23 أو أحدث  | غير مدعومة، الترحيل بالأداة فقط       | ليست ترقية                    | ترحيل بالأداة                          |
| الاتحاد بين الخوادم Federation | قيد التطوير بحسب المشروع              | لا يوجد عمل عليه بحسب Forgejo | لا                                     |

وفي الجدول نقطتان تحتاجان توضيحاً. الأولى أن Actions في المشروعين متشابهة في الفكرة، وكلاهما يشبه GitHub Actions، ولكن [توثيق Forgejo Actions](https://forgejo.org/docs/latest/user/actions/overview/?ref=arabroot.io) يقول بوضوح إنه مصمم ليكون مألوفاً لمستخدمي GitHub Actions، وليس ليكون متوافقاً معه، وإن نقل Workflow سوف يحتاج غالباً تعديلات صغيرة، والأمر نفسه بين Forgejo وGitea مع تباعدهما، فاختبر خطوطك قبل أن تنقل. والثانية سياسة الدعم: يقول [دليل الترقية في Forgejo](https://forgejo.org/docs/latest/admin/upgrade/?ref=arabroot.io) إن الإصدار طويل الدعم LTS هو الذي يصدر في الربع الأول من كل سنة، ويحصل على إصلاحات الأخطاء الحرجة والأمنية لمدة سنة وثلاثة أشهر، وتعرض [صفحة الإصدارات](https://forgejo.org/releases/?ref=arabroot.io) اليوم الإصدار 17.0.1 كإصدار مستقر ينتهي دعمه في يناير 2027، والإصدار 15.0.11 كإصدار طويل الدعم ينتهي في يوليو 2027\. وهذا يعني لفريق صغير قراراً بسيطاً: إذا كنت لا تريد ترقية كبيرة كل ثلاثة أشهر، فابق على LTS.

![ثلاث بطاقات: Forgejo تحت Codeberg e.V. بترخيص GPLv3+ ونحو 196 MiB في المختبر وإصدار LTS سنوي، وGitea تحت Gitea Limited بترخيص MIT ونحو 107 MiB، وGitLab CE تحت GitLab Inc. بترخيص MIT للنسخة المجتمعية وأساس 8 vCPU و16 GB بحسب التوثيق، وتحت البطاقات سهم يبين أن الترقية المباشرة من Gitea إلى Forgejo تتوقف عند Gitea 1.22](https://arabroot.io/content/images/2026/11/forgejo-02-comparison.webp)

المشروعان الخفيفان متقاربان في الموارد والميزات، والفرق في من يقرر والترخيص، وGitLab في حجم آخر

## تجهيز المختبر Lab Setup

شغلنا السيرفرين جنباً إلى جنب على شبكة واحدة، Gitea القديم وForgejo الجديد، ومعهما جهاز مطور:

```bash
docker network create dv2g-net
docker run -d --name dv2g-gitea --network dv2g-net -p 3484:3000 \
  -e GITEA__security__INSTALL_LOCK=true -e GITEA__server__ROOT_URL=http://dv2g-gitea:3000/ \
  -e GITEA__database__DB_TYPE=sqlite3 -e GITEA__service__DISABLE_REGISTRATION=true \
  -v dv2g-gitea-data:/data gitea/gitea:28.3.0

docker run -d --name dv2g-forgejo --network dv2g-net -p 3485:3000 \
  -e FORGEJO__security__INSTALL_LOCK=true -e FORGEJO__server__ROOT_URL=http://dv2g-forgejo:3000/ \
  -e FORGEJO__database__DB_TYPE=sqlite3 -e FORGEJO__service__DISABLE_REGISTRATION=true \
  -e FORGEJO__migrations__ALLOW_LOCALNETWORKS=true \
  -v dv2g-forgejo-data:/data codeberg.org/forgejo/forgejo:17.0.1

docker exec -u git dv2g-forgejo forgejo --version
```

والمخرج سوف يكون كما يلي، للأمر الأخير:

```bash
forgejo version 17.0.1+gitea-1.22.0 (release name 17.0.1) built with GNU Make 4.4.1, go1.26.10 : bindata, timetzdata, sqlite, sqlite_unlock_notify
```

في الإعداد أعلاه لاحظ التالي:

- متغيرات البيئة في Forgejo تبدأ بالكلمة `FORGEJO__` بدلاً من `GITEA__`، والصيغة نفسها: القسم ثم المفتاح. وصورة Forgejo من سجل Codeberg، كما في [دليل التثبيت مع Docker](https://forgejo.org/docs/latest/admin/installation/docker/?ref=arabroot.io).
- `ALLOW_LOCALNETWORKS` في القسم `[migrations]` يسمح لForgejo أن يرحل من عناوين في شبكة خاصة، وهو مغلق افتراضياً لأن أداة الترحيل تجعل السيرفر يتصل بعنوان يكتبه المستخدم، وهذا باب لهجمات SSRF على الشبكة الداخلية. وفي فريق يرحل من Gitea داخلي ستحتاجه مؤقتاً، ثم أغلقه.
- لاحظ الجزء `+gitea-1.22.0` في رقم الإصدار. فForgejo يعلن أنه متوافق مع واجهة Gitea 1.22، وهذا ما تراه الأدوات التي تسأل عن الإصدار عبر API، وهو أيضاً آخر إصدار من Gitea يقبل Forgejo بياناته كما سوف نرى.

ثم ملأنا سيرفر Gitea بما يشبه مستودعاً حقيقياً: مستودع `shop` فيه Commitان ووسم v1.0.0، وفرع `feature/vat`، وثلاث تسميات Labels، ومرحلة Milestone، وتذكرتان إحداهما بتعليق، وطلب دمج بمراجعة، وإصدار Release، وصفحة ويكي، وWebhook، وسر Actions، وحماية للفرع main. وكل الأوامر في ملف `fill-gitea.sh` في مجلد المختبر، وهذا ما عده API على السيرفر القديم:

```bash
issues?state=all&type=issues       2
pulls?state=all                    1
labels                             3
milestones?state=all               1
releases                           1
hooks                              1
branch_protections                 1
actions/secrets                    1
wiki/pages                         1
```

## الطريق المختصر: تبديل الصورة What If: Binary Swap

أول فكرة تخطر على بال كل من يدير Gitea: Forgejo نسخة من Gitea، والمجلدات نفسها، وملف الإعداد نفسه، فلماذا لا أبدل `gitea/gitea` بالصورة `codeberg.org/forgejo/forgejo` في ملف Compose وأعيد التشغيل؟ وهذا بالضبط ما كانت تسمح به الإصدارات القديمة. جربناه على نسخة من Volume بيانات Gitea، وليس على الأصل، فأوقفنا Gitea حتى تكون النسخة متسقة، ونسخنا البيانات، ثم شغلنا Forgejo عليها:

```bash
docker stop dv2g-gitea
docker run --rm -v dv2g-gitea-data:/from -v dv2g-copy:/to alpine:3.24 cp -a /from/. /to/
docker start dv2g-gitea
docker run -d --name dv2g-swap --network dv2g-net -v dv2g-copy:/data codeberg.org/forgejo/forgejo:17.0.1
docker logs dv2g-swap 2>&1 | grep -iE 'version|AppPath|Migration'
```

والمخرج سوف يكون كما يلي:

```bash
2026/11/03 19:11:51 cmd/web.go:114:showWebStartupMessage() [I] Forgejo version: 17.0.1+gitea-1.22.0 built with GNU Make 4.4.1, go1.26.10 : bindata, timetzdata, sqlite, sqlite_unlock_notify
2026/11/03 19:11:51 cmd/web.go:116:showWebStartupMessage() [I] * AppPath: /usr/local/bin/gitea
2026/11/03 19:11:52 ...ations/migrations.go:496:Migrate() [F] Migration Error: Your database (migration version: 358) is for a newer Forgejo, you can not use the newer database for this old Forgejo release (305).
Forgejo will exit to keep your database safe and unchanged. Please use the correct Forgejo release, do not change the migration version manually (incorrect manual operation may lose data).
```

وخرج Container بالحالة Exited. وهذا المخرج يستحق أن نقرأه بهدوء، لأن فيه القصة كلها:

- كل قاعدة بيانات في هذه المشاريع تحمل رقماً يسمى رقم الترحيل Migration Version، يزيد كلما غير إصدار جديد شكل الجداول. وعند التشغيل يقارن البرنامج رقم القاعدة برقمه هو، فإذا كانت القاعدة أقدم طبق عليها الترحيلات الناقصة، وإذا كانت أحدث توقف.
- قاعدة Gitea 28.3 رقمها 358، وForgejo 17 يقبل حتى الرقم 305\. فمن وجهة نظر Forgejo هذه قاعدة من برنامج أحدث منه، والحقيقة أنها قاعدة من برنامج آخر: الترحيلات التي أضافها Gitea بعد أن افترق المشروعان لا يعرفها Forgejo، وForgejo أضاف بدلاً منها تغييراته الخاصة، كما يشرح إعلان حدود التوافق.
- وتوقف البرنامج بخطأ قاتل `[F]` بدلاً من أن يحاول، وهذا هو السلوك الصحيح: «Forgejo سوف يخرج ليحافظ على قاعدة بياناتك آمنة ودون تغيير». ولو حاول أن يعمل على قاعدة لا يفهمها لكان أفسدها.
- والرسالة تحذر بوضوح من تعديل رقم الترحيل يدوياً. وستجد على الإنترنت من يقترح ذلك، أو يقترح إرجاع القاعدة إلى شكل Gitea 1.22 يدوياً، وإعلان Forgejo نفسه يقول إن هذا الطريق ممكن فقط لمن هو مستعد لتعديل قاعدة البيانات بيده، مع مساعدة بأفضل جهد. ولا نقترحه لفريق يريد أن ينام ليلته.
- وانظر إلى السطر `AppPath: /usr/local/bin/gitea`: الملف التنفيذي داخل صورة Forgejo ما زال اسمه gitea. وتشرح صفحة المقارنة السبب: الخطافات والإعدادات في التثبيتات الموجودة تشير إلى هذا الاسم، فأبقوه، مع رابط باسم forgejo.

والخلاصة العملية: إذا كان Gitea عندك 1.22 أو أقدم، فالترقية المباشرة ممكنة بحسب دليل الترقية، عبر Forgejo 10.0 أولاً ثم إلى الإصدار الذي تريده، بعد نسخة احتياطية كاملة. وإذا كان 1.23 أو أحدث، مثل فريقنا على 28.3، فالطريق المدعوم هو نقل المستودعات واحداً واحداً بأداة الترحيل. ثم حذفنا Container التجربة وال Volume المنسوخ، والأصل لم يلمسه شيء.

### إذا كان Gitea عندك 1.22 أو أقدم Older Gitea

بعض الفرق ما زالت على Gitea 1.21 أو 1.22، لأنها لم تجد سبباً للترقية. وهؤلاء عندهم طريق أقصر، بشرط أن يتبعوه بالترتيب الذي يذكره دليل الترقية: أولاً ترقية من Gitea إلى Forgejo 10.0.x، لأنه الإصدار الذي يعرف كيف يحول قاعدة Gitea حتى 1.22، ثم من Forgejo 10.0.x إلى الإصدار الذي تريده، خطوة بعد خطوة. ولا تقفز مباشرة من Gitea 1.22 إلى Forgejo 17، ولا ترق Gitea إلى 1.23 «لتكون على آخر إصدار» قبل أن تقرر، لأنك بذلك تغلق الطريق المختصر على نفسك. وفي كل خطوة: نسخة احتياطية كاملة، ثم تبديل الصورة، ثم قراءة السجل حتى تنتهي الترحيلات، ثم `forgejo doctor check`، ثم فتح الواجهة والتأكد من مستودع وتذكرة وطلب دمج، قبل الخطوة التالية. والفرق الكبير عن طريق أداة الترحيل أن كل شيء ينتقل لأنه القاعدة نفسها: المستخدمون والمفاتيح والإعدادات وWebhooks والأسرار، فهو أفضل بكثير إذا كان متاحاً لك.

![مخطط طريقين من Gitea إلى Forgejo: الطريق الأول تبديل الصورة على نسخة من البيانات، وفيه قاعدة Gitea 28.3 برقم ترحيل 358 وForgejo 17.0.1 يعرف حتى 305 فيخرج بخطأ Migration Error، ويصلح فقط من Gitea 1.22 أو أقدم عبر Forgejo 10.0، والطريق الثاني أداة الترحيل عبر Gitea API وhttps مع رمز وصول، تنقل الكود والتذاكر وطلبات الدمج والتسميات والمراحل والإصدارات، ولا تنقل الويكي في المختبر ولا Webhooks ولا الأسرار ولا حماية الفروع](https://arabroot.io/content/images/2026/11/forgejo-03-two-paths.webp)

تبديل الصورة يتوقف عند رقم الترحيل، وأداة الترحيل هي الطريق المدعوم من Gitea الحديث

## الترحيل من الواجهة In-app Migration

أداة الترحيل في Forgejo تفتحها من القائمة New Migration، وتعرض مصادر كثيرة، كما في الصورة التالية من المختبر. واخترنا Gitea، لأن هذا الخيار لا ينقل الكود فقط كما يفعل خيار Git العادي، وإنما يستخدم Gitea API لينقل التذاكر وطلبات الدمج وغيرها:

![صفحة Migrate repository في Forgejo 17.0.1 فيها بطاقات المصادر: Git وGitHub وGitLab وForgejo وGitea وGogs وOneDev وGitBucket وغيرها، وكل بطاقة تذكر ما تنقله](https://arabroot.io/content/images/2026/11/forgejo-04-migrate-page.webp)

مصادر الترحيل في Forgejo 17.0.1، وخيار Gitea ينقل البيانات عبر API

### رمز الوصول على Gitea Access Token

ليقرأ Forgejo التذاكر وطلبات الدمج من Gitea يحتاج رمز وصول Access Token من حساب له صلاحية القراءة على المستودع. وأنشأناه بأقل صلاحيات تكفي، أي قراءة المستودعات والتذاكر والمستخدم، لأن هذا الرمز سوف يلصق في سيرفر آخر:

```bash
curl -s -u team:Lab-Pass-2026! -H 'Content-Type: application/json' -X POST \
  http://dv2g-gitea:3000/api/v1/users/team/tokens \
  -d '{"name":"to-forgejo","scopes":["read:repository","read:issue","read:user"]}' | jq '{name, scopes}'
```

والمخرج سوف يكون كما يلي:

```bash
{
  "name": "to-forgejo",
  "scopes": [
    "read:issue",
    "read:repository",
    "read:user"
  ]
}
```

ولا توجد في الرمز أي صلاحية كتابة، فحتى لو تسرب من سجلات Forgejo لا يستطيع أحد أن يغير به شيئاً في Gitea، واحذفه بعد انتهاء الترحيل. ورمز الرمز نفسه، أي القيمة السرية، يظهر مرة واحدة عند الإنشاء في حقل `sha1`، فاحفظه في متغير مباشرة.

### مشكلة حقيقية: unencrypted transfer protocols

طلبنا الترحيل عبر API، وهو الطلب نفسه الذي ترسله الواجهة، بعنوان Gitea الداخلي:

```bash
curl -s -u team:Lab-Pass-2026! -H 'Content-Type: application/json' -X POST \
  http://dv2g-forgejo:3000/api/v1/repos/migrate \
  -d '{"clone_addr":"http://dv2g-gitea:3000/team/shop.git","service":"gitea","repo_owner":"team","repo_name":"shop"}'
```

والمخرج سوف يكون كما يلي:

```bash
{"message":"Unknown error type (ErrInvalidCloneAddr): migration/cloning from 'http://dv2g-gitea:3000/team/shop.git' is not allowed: unencrypted transfer protocols are disabled because the authenticity of the remote cannot be validated","url":"http://dv2g-forgejo:3000/api/swagger"}
```

Forgejo يرفض الترحيل من عنوان HTTP غير مشفر، والسبب في الرسالة نفسها: لا يمكن التحقق من هوية الطرف الآخر، فمن يقف في وسط الشبكة يستطيع أن يقدم مستودعاً مزيفاً، أو يقرأ رمز الوصول الذي يرسله Forgejo. ولم نجد في دليل الإعدادات خياراً يسمح بالترحيل من HTTP، فالطريق الصحيح أن يكون Gitea خلف HTTPS، وهو كذلك في أي تثبيت إنتاجي كما شرحنا في [دليل تثبيت Gitea](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-gitea-%D9%85%D8%B9-docker-compose/). ولكن هذه المشكلة تظهر فعلاً عندما يحاول الفريق أن يرحل عبر العنوان الداخلي للسيرفر ليتجنب ال Reverse Proxy، كما فعلنا نحن. وفي المختبر وضعنا Caddy أمام Gitea بشهادة داخلية، وأضفنا إلى Forgejo الإعداد `FORGEJO__migrations__SKIP_TLS_VERIFY=true` لأن الشهادة غير موقعة من جهة معروفة، وهذا للمختبر فقط، ففي الإنتاج استخدم العنوان العام بشهادة صحيحة، ولا تطفئ التحقق.

### فشل يترك مستودعاً Failed Migration

وفي المحاولة التالية عبر HTTPS ظهرت مشكلة ثالثة لم نتوقعها. أعدنا تشغيل سكربت المختبر، فحاول أن ينشئ رمز وصول باسم موجود من التشغيل السابق، ففشل الطلب، ووصل إلى Forgejo رمز فارغ، فرفضه Gitea. وفي سجل Forgejo:

```bash
.../gitea_downloader.go:68:New() [E] Failed to create NewGiteaDownloader for: https://gitea-tls. Error: invalid username, password or token
...i/v1/repo/migrate.go:266:handleMigrateError() [E] MigrateRepository: invalid username, password or token
```

أصلحنا الرمز وأعدنا الطلب، فجاء الرد:

```bash
{"message":"The repository with the same name already exists.","url":"http://dv2g-forgejo:3000/api/swagger"}
```

الترحيل الفاشل ترك خلفه مستودعاً باسم `team/shop` على Forgejo، فرفضت المحاولة الجديدة لأن الاسم مستخدم. والحل أن تحذف المستودع الفاشل ثم تعيد، ولكن الدرس أعم: في ترحيل عشرات المستودعات بسكربت، تحقق بعد كل مستودع من نتيجته، واحذف ما فشل قبل أن تعيد، وإلا وجدت في النهاية مستودعات فارغة بأسماء صحيحة تبدو كأنها انتقلت.

### ما الذي انتقل؟ What Moved

بعد حذف المستودع الفاشل نجح الترحيل في نحو ثلاث ثوان:

```bash
curl -s -u team:Lab-Pass-2026! -H 'Content-Type: application/json' -X POST \
  http://dv2g-forgejo:3000/api/v1/repos/migrate \
  -d '{"clone_addr":"https://gitea-tls/team/shop.git","service":"gitea","auth_token":"...","repo_owner":"team","repo_name":"shop","issues":true,"labels":true,"milestones":true,"pull_requests":true,"releases":true,"wiki":true}' | jq '{full_name, mirror, empty}'
```

والمخرج سوف يكون كما يلي:

```bash
{
  "full_name": "team/shop",
  "mirror": false,
  "empty": false
}
real	0m 2.99s
```

ثم سألنا السيرفرين عن كل نوع من البيانات، بالطلب نفسه، ووضعنا الرقمين جنباً إلى جنب:

```bash
what                       gitea    forgejo
issues?state=all&type=issues 2        2
pulls?state=all            1        1
labels                     3        3
milestones?state=all       1        1
releases                   1        1
wiki/pages                 1        3
hooks                      1        0
branch_protections         1        0
actions/secrets            1        0
issues/1/comments          1        1
pulls/3/reviews            1        1
```

في المخرج أعلاه لاحظ التالي:

- التذاكر وطلب الدمج والتسميات والمرحلة والإصدار والتعليق والمراجعة انتقلت كلها، وبالأرقام نفسها: التذكرة 1 بقيت 1، وطلب الدمج 3 بقي 3، فالروابط بينها مثل «Fixes #1» في وصف الطلب ما زالت صحيحة.
- الرقم 3 في سطر الويكي ليس ثلاث صفحات، وإنما عدد الحقول في رسالة خطأ رجعت بدلاً من قائمة، لأن الطلب أعاد «The target couldn't be found». أي أن الويكي لم ينتقل، وسوف نعود إليه.
- Webhooks وحماية الفرع وأسرار Actions صفر، وهذا متوقع: أداة الترحيل تنقل محتوى المستودع، وليس إعداداته الإدارية. والأسرار تحديداً لا يمكن أن تنتقل، لأن Gitea API لا يرجع قيمها أبداً، فحتى لو أرادت الأداة لما استطاعت.

وتأكدنا من الكود نفسه بمقارنة كل المراجع في نسختين كاملتين بالأمر `git clone --mirror` من السيرفرين:

```bash
24bf107 refs/heads/feature/vat
af7bac9 refs/heads/main
24bf107 refs/pull/3/head
8881259 refs/tags/v1.0.0
```

وكان المخرج متطابقاً حرفاً بحرف من السيرفرين: الفرعان، والوسم، والمرجع الخاص بطلب الدمج `refs/pull/3/head`، وكل رقم كما هو. وهذا مهم لأن تطابق الأرقام يعني أن التاريخ لم يعد كتابته، فالتوقيعات على ال Commits ما زالت صالحة، والروابط إلى Commits محددة في التذاكر ما زالت تشير إلى الشيء نفسه.

### أصحاب التذاكر Authors

فتحنا التذكرة الأولى على Forgejo عبر API:

```bash
curl -s -u team:Lab-Pass-2026! http://dv2g-forgejo:3000/api/v1/repos/team/shop/issues/1 | jq '{number, title, user: .user.login, labels: [.labels[].name], milestone: .milestone.title, created_at}'
```

والمخرج سوف يكون كما يلي:

```bash
{
  "number": 1,
  "title": "Total ignores VAT",
  "user": "Ghost",
  "labels": [
    "bug",
    "payments"
  ],
  "milestone": "v1.1",
  "created_at": "2026-11-03T19:11:08Z"
}
```

كل شيء صحيح، والتاريخ نفسه تاريخ إنشائها على Gitea، إلا صاحبها: `Ghost`، وهو المستخدم الوهمي الذي تستخدمه هذه المشاريع للحسابات المحذوفة أو غير المعروفة. ومع أن على Forgejo مستخدماً اسمه team ببريد team@example.com، بالضبط مثل صاحب التذكرة على Gitea، فلم يربط الترحيل بينهما. أما الواجهة فتعرض الاسم الأصلي مع ملاحظة المصدر، كما في الصورة:

![صفحة التذكرة Total ignores VAT #1 في Forgejo بعد الترحيل، فيها تعليقان باسم team مع الملاحظة Migrated from gitea-tls وصورة شعار Forgejo بدلاً من صورة المستخدم، والتسميات bug وpayments والمرحلة v1.1](https://arabroot.io/content/images/2026/11/forgejo-05-issue-migrated.webp)

التعليقات تحمل الاسم الأصلي مع «Migrated from gitea-tls»، ولكنها غير مرتبطة بحساب على Forgejo

وهذا يعني عملياً أن التذاكر القديمة لن تظهر في صفحة «تذاكري» لصاحبها، ولن تصله إشعارات عليها، ولا يستطيع أن يعدل تعليقاته القديمة. وفي فريق صغير هذا مقبول غالباً، فالتاريخ محفوظ للقراءة، والعمل الجديد يبدأ بالحسابات الجديدة. وفي فريق يعتمد على التذاكر المفتوحة كثيراً، أغلقها أو أنهها قبل الترحيل حيث يمكن، وأخبر الفريق بأن التذاكر المنقولة تحتاج من يتبناها.

وإذا كانت عندك تذاكر مفتوحة كثيرة، فخطوتان صغيرتان تقللان الأثر. قبل الترحيل صدر قائمة بالتذاكر المفتوحة مع المكلف بكل واحدة من Gitea API، لأن هذه المعلومة هي ما سوف تفقده فعلاً. وبعد الترحيل اكتب سكربتاً صغيراً يمر على القائمة ويكلف كل تذكرة بصاحبها على Forgejo عبر API، فتعود التذاكر إلى صفحات أصحابها وتصلهم الإشعارات. أما التعليقات القديمة فتبقى بالاسم الأصلي، وهذا يكفي للقراءة والبحث، ولا يستحق أن تحاول تغييره في قاعدة البيانات.

### الويكي الذي لم ينتقل Wiki

طلبنا الويكي في الترحيل بالحقل `"wiki":true`، ولم ينتقل، ولم يرجع الطلب أي خطأ، ولم نجد في سجل Forgejo أي سطر عنه. وهذه أخطر نتيجة في المختبر كله، لأنها صامتة: من لا يقارن بنفسه لن يعرف حتى يبحث أحدهم عن صفحة «Deploy» بعد أسبوع. والويكي في هذه المشاريع مستودع Git منفصل باسم المستودع مع `.wiki.git`، فنقلناه بأدوات Git مباشرة:

```bash
git clone -q --mirror http://dv2g-gitea:3000/team/shop.wiki.git /work/wiki.git && git -C /work/wiki.git log --oneline
git -C /work/wiki.git push --mirror http://dv2g-forgejo:3000/team/shop.wiki.git
```

والمخرج سوف يكون كما يلي:

```bash
5464cc2 Add "Deploy"

fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
```

الدفع فشل، لأن مستودع الويكي على Forgejo لا يوجد قبل أن تنشأ أول صفحة. فأنشأنا صفحة مؤقتة عبر API، ثم دفعنا تاريخ الويكي القديم فوقها بالخيار `--force`:

```bash
curl -s -u team:Lab-Pass-2026! -H 'Content-Type: application/json' -X POST \
  http://dv2g-forgejo:3000/api/v1/repos/team/shop/wiki/new -d '{"title":"Home","content_base64":"SG9tZQ=="}' | jq -c '{title}'
git -C /work/wiki.git push --mirror --force http://dv2g-forgejo:3000/team/shop.wiki.git
curl -s -u team:Lab-Pass-2026! http://dv2g-forgejo:3000/api/v1/repos/team/shop/wiki/pages | jq -c '[.[] | .title]'
```

والمخرج سوف يكون كما يلي:

```bash
{"title":"Home"}

To http://dv2g-forgejo:3000/team/shop.wiki.git
 + 779cafe...5464cc2 main -> main (forced update)

["Deploy"]
```

العلامة `+` و`forced update` تعني أن الصفحة المؤقتة استبدلت بتاريخ الويكي القديم كاملاً، فأصبحت صفحة Deploy موجودة بتاريخها، والصفحة المؤقتة اختفت. ولاحظ أن الفرع اسمه main في الطرفين، وإذا اختلف اسم فرع الويكي بين السيرفرين فادفع إلى الاسم الذي يتوقعه السيرفر الجديد.

![جدول بما انتقل من Gitea 28.3.0 إلى Forgejo 17.0.1 في المختبر: الكود والفروع والوسوم وrefs/pull بأرقام مطابقة، والتذاكر وطلب الدمج بالأرقام نفسها، والتسميات والمرحلة والإصدار والتعليقات والمراجعات، وأصحابها بالاسم الأصلي دون ربط بالحسابات، والويكي لم ينتقل دون رسالة فنقل بالأمر git push --mirror، وWebhooks وحماية الفروع والأسرار لم تنتقل وتعاد يدوياً](https://arabroot.io/content/images/2026/11/forgejo-06-moved.webp)

ما انتقل بالأداة، وما احتاج Git، وما يعاد بيد المدير

## تحويل نسخ المطورين Remote Switch

بعد الترحيل كل مطور عنده نسخة محلية تشير إلى Gitea. ولا يحتاج أن يستنسخ من جديد، فالتاريخ متطابق كما رأينا، وأمر واحد يغير العنوان:

```bash
git remote set-url origin http://dv2g-forgejo:3000/team/shop.git && git remote -v
git fetch origin; git status -sb | head -n 1
git commit -qam "feat: total with VAT" && git push origin main
```

والمخرج سوف يكون كما يلي:

```bash
origin	http://dv2g-forgejo:3000/team/shop.git (fetch)
origin	http://dv2g-forgejo:3000/team/shop.git (push)

## main...origin/main

To http://dv2g-forgejo:3000/team/shop.git
   af7bac9..c1ec40f  main -> main
```

السطر `## main...origin/main` دون أي «ahead» أو «behind» يعني أن main المحلي يطابق main على Forgejo تماماً، لأن الأرقام نفسها. ثم دفعنا أول Commit إلى السيرفر الجديد مباشرة. وفي الإنتاج غالباً لن يحتاج أحد هذا الأمر، إذا نقلت اسم النطاق نفسه، مثل git.example.com، من Gitea إلى Forgejo، فتبقى روابط الاستنساخ كما هي. ولكن انتبه عندها إلى مفاتيح SSH للسيرفر: Forgejo الجديد له مفتاح Host Key مختلف، فسوف يرى كل مطور خطأ «Host key verification failed» الذي شرحناه في [أول مستودع Git لك](https://arabroot.io/articles/%D8%A7%D9%88%D9%84-%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9-git-%D9%84%D9%83-%D9%85%D9%86-git-init-%D8%A7%D9%84%D9%89-%D8%A7%D9%88%D9%84-push-%D8%B9%D9%84%D9%89-gitea/)، إلا إذا نقلت مفاتيح السيرفر القديم إلى الجديد.

## التشغيل اليومي بعد الانتقال Day-2 Operations

بعد أن انتقل المستودع، يأتي السؤال الذي يهم من يدير السيرفر كل يوم: ماذا تغير في عملي؟ والجواب المختصر: أقل مما تتوقع، وفي أماكن محددة. والأمر `forgejo doctor check` يعطيك صورة سريعة عن السيرفر الجديد:

```bash
docker exec -u git dv2g-forgejo forgejo doctor check
```

والمخرج سوف يكون كما يلي، دون أكواد الألوان:

```bash
[1] Check paths and basic configuration
 - [I] Configuration File Path:    "/data/gitea/conf/app.ini"
 - [I] Repository Root Path:       "/data/git/repositories"
 - [I] Data Root Path:             "/data/gitea"
 - [I] Custom File Root Path:      "/data/gitea"
 - [I] Work directory:             "/data/gitea"
 - [I] Log Root Path:              "/data/gitea/log"
OK

[2] Check Database Version
 - [I] Expected database version: 305
OK

[3] Check if user with wrong type exist
OK

[4] Check if OpenSSH authorized_keys file is up-to-date
 - [I] AppPath set to '/usr/local/bin/gitea' (was '/usr/local/bin/forgejo')
OK

[5] Synchronize repo HEADs
 - [I] All 1 repos have their HEADs in the correct state
OK

All done (checks: 5).
```

في المخرج أعلاه لاحظ التالي:

- المسارات كلها تحمل الاسم gitea: ملف الإعداد في `/data/gitea/conf/app.ini`، والبيانات في `/data/gitea`. فسكربتات النسخ الاحتياطي التي تنسخ هذه المجلدات تعمل كما هي، وكذلك أي أداة تقرأ ملف الإعداد.
- رقم قاعدة البيانات المتوقع 305، وهو الرقم الذي رأيناه في رسالة الخطأ في تجربة تبديل الصورة، فهذا الفحص مفيد قبل كل ترقية لتعرف أين تقف.
- الفحص الرابع غير مسار البرنامج من forgejo إلى gitea، وهو المسار الذي يكتب في ملف `authorized_keys` لمفاتيح SSH، وهذا يؤكد ما رأيناه في السجل: الاسم القديم مقصود حتى تبقى الأشياء التي تعتمد عليه تعمل.

أما الأوامر الإدارية فهي نفسها باسم جديد: `forgejo admin user create` بدلاً من `gitea admin user create`، و`forgejo dump` للنسخة الاحتياطية الكاملة بدلاً من `gitea dump`، كما في [مرجع سطر الأوامر](https://forgejo.org/docs/latest/admin/command-line/?ref=arabroot.io). ومتغيرات البيئة في ملف Compose تبدأ بالكلمة `FORGEJO__`. ولخطوط CI تحتاج Forgejo Runner، وهو برنامج منفصل يثبت بحسب [دليل تثبيته](https://forgejo.org/docs/latest/admin/actions/runner-installation/?ref=arabroot.io)، وليس هو Gitea Runner، فلا تنقل Runner من Gitea إلى Forgejo وتتوقع أن يعمل، وإنما سجل Runner جديداً على السيرفر الجديد. والترقيات تتبع سياسة Forgejo: إصدار مستقر جديد كل بضعة أشهر، وإصدار طويل الدعم في الربع الأول من كل سنة، وقبل كل ترقية تأخذ نسخة احتياطية وتقرأ ملاحظات الإصدار، تماماً كما كنت تفعل مع Gitea.

وتذكر أن الإعدادين اللذين فتحناهما من أجل الترحيل، `ALLOW_LOCALNETWORKS` و`SKIP_TLS_VERIFY`، يجب أن يرجعا إلى قيمتيهما الافتراضيتين بعد الانتهاء. فالأول يسمح لأي مستخدم يستطيع أن ينشئ ترحيلاً بأن يجعل السيرفر يتصل بعناوين شبكتك الداخلية، والثاني يجعل السيرفر يقبل أي شهادة. وكلاهما يبقى مفتوحاً بصمت إذا نسيته، ولن يذكرك به أحد.

## خطة ترحيل لفريق Migration Plan

من كل ما رأيناه، هذه الخطوات التي نقترحها لفريق ينقل سيرفر Gitea حديثاً إلى Forgejo، بالترتيب:

1. **الجرد:** قائمة بكل المستودعات، ولكل مستودع: هل فيه ويكي، وWebhooks، وأسرار Actions، وحماية فروع، وحزم في سجل الحزم، وخطوط CI. والسكربت الذي استخدمناه للمقارنة يصلح للجرد أيضاً.
2. **نسخة احتياطية كاملة** لGitea بالأمر `gitea dump` قبل أي شيء، كما في [النسخ الاحتياطي بقاعدة 3-2-1](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/)، مع اختبار الاستعادة.
3. **تجهيز Forgejo** بإصدار LTS إذا كنت لا تريد ترقيات متكررة، خلف HTTPS، وربطه بالدخول الموحد نفسه إن وجد، كما شرحنا لGitea في [ربط Gitea مع Authentik](https://arabroot.io/articles/%D8%B1%D8%A8%D8%B7-gitea-%D9%85%D8%B9-authentik-%D8%B9%D8%A8%D8%B1-oidc/)، حتى ينشئ كل مطور حسابه بالبريد نفسه.
4. **مستودع تجريبي** يرحل أولاً، وتقارن فيه كل البيانات كما فعلنا، وتجرب عليه خط CI بعد أن تشغل Runner لForgejo، لأن ملفات Workflow قد تحتاج تعديلات.
5. **تجميد قصير:** وقت متفق عليه لا يدفع فيه أحد إلى Gitea، ويفضل أن تجعل المستودعات للقراءة فقط بأرشفتها.
6. **الترحيل بسكربت** يتحقق من كل مستودع بعد ترحيله، ويحذف الفاشل قبل إعادته، وينقل الويكي بأدوات Git.
7. **إعادة الإعدادات:** Webhooks، وحماية الفروع، والأسرار من مصدرها الأصلي وليس من Gitea، ومفاتيح SSH للمستخدمين، ومفتاح Host Key إذا بقي النطاق نفسه.
8. **تحويل الفريق:** رابط النطاق إلى Forgejo، أو أمر `git remote set-url` لكل مطور، ورمز الوصول المؤقت يحذف من Gitea.
9. **إبقاء Gitea للقراءة فقط** مدة متفقاً عليها، ثم إيقافه مع الاحتفاظ بنسخته الاحتياطية الأخيرة.

![تسع خطوات مرقمة لترحيل فريق من Gitea إلى Forgejo: الجرد، والنسخة الاحتياطية gitea dump، وتجهيز Forgejo LTS خلف HTTPS، ومستودع تجريبي مع مقارنة وCI، وتجميد قصير بأرشفة المستودعات، والترحيل بسكربت يتحقق من كل مستودع وينقل الويكي، وإعادة Webhooks والحماية والأسرار، وتحويل الفريق، وإبقاء Gitea للقراءة فقط ثم إيقافه](https://arabroot.io/content/images/2026/11/forgejo-07-plan.webp)

الترحيل نفسه دقائق، والعمل الحقيقي في الجرد قبله وإعادة الإعدادات بعده

## متى تبقى ومتى تنتقل؟ Decision

بعد التجربة كتب الفريق قراره في ثلاث حالات، ونضعها هنا كما هي لأنها تصلح لأغلب الفرق:

- **ابق على Gitea** إذا كان يعمل جيداً، وليس عندك سبب محدد للانتقال، مثل سياسة تفضل الحوكمة غير الربحية أو ترخيص Copyleft. فالانتقال من 1.23 أو أحدث ليس تبديل صورة، وإنما مشروع ترحيل كما رأينا، ويستحق سبباً حقيقياً.
- **اختر Forgejo** إذا كنت تبدأ سيرفراً جديداً اليوم، أو كان Gitea عندك 1.22 أو أقدم ولم ترقه بعد، أو كانت الحوكمة المجتمعية والإصدار طويل الدعم السنوي مهمين لك، أو كنت تريد الاتحاد بين الخوادم عندما يكتمل. والفرق في الموارد والواجهة عن Gitea صغير، فالقرار هنا قرار ثقة بمن يطور المشروع.
- **اختر GitLab CE** إذا كنت تحتاج منصة واحدة متكاملة لفريق كبير، وعندك سيرفر بموارده الموثقة وشخص يديره، وتريد أن يجد المطورون الجدد أداة يعرفونها من وظائفهم السابقة.

وهناك خيار رابع لم نضعه في الجدول لأنه ليس استضافة ذاتية: إذا كان مشروعك مفتوح المصدر ولا يحتاج سيرفراً خاصاً، فمنصة Codeberg نفسها تشغل Forgejo كما يذكر إعلان المشروع، وتديرها جمعية غير ربحية. وهذا مناسب لمكتبة مفتوحة يريد فريقك أن يستضيفها خارج سيرفراته، بينما يبقى الكود الداخلي على سيرفرك. ولكن تأكد من شروط استخدام المنصة قبل أن تضع عليها شيئاً، فهي مخصصة للمشاريع الحرة.

ولاحظ أن أدوات حول هذه المنصات بدأت تفرق بينها أيضاً، فمثلاً أداة تحديث الاعتماديات Renovate لها [منصة خاصة باسم forgejo](https://docs.renovatebot.com/modules/platform/forgejo/?ref=arabroot.io)، وتقول صفحة منصة Gitea عندها إن دعم Forgejo عبر منصة Gitea سوف يزال في إصدار قادم. فكلما تباعد المشروعان، احتاجت كل أداة تستخدمها أن تعرف أيهما عندك.

والسبب العملي لذلك رأيناه في المختبر: Forgejo يجيب عن طلب الإصدار في `/api/v1/version` بالقيمة `17.0.1+gitea-1.22.0`. فأداة كتبت لGitea وتقرأ رقم الإصدار لتعرف أي ميزات تستخدم سوف ترى 1.22، حتى لو كان في Forgejo ما يقابل ميزة أحدث، أو العكس. وتوثيق Renovate نفسه يذكر ميزات لا يدعمها على Gitea قبل الإصدار 1.24\. لذلك عندما تنتقل، راجع كل أداة تتصل بسيرفر Git عبر API، مثل أدوات تحديث الاعتماديات وأدوات المراجعة الآلية وإضافات المحررات، وتأكد أنها تدعم Forgejo باسمه، وليس فقط لأنها تدعم Gitea.

## أخطاء شائعة Common Mistakes

- **تبديل الصورة على Gitea 1.23 أو أحدث:** يتوقف Forgejo بخطأ رقم الترحيل، وأسوأ من ذلك أن تجربه على البيانات الأصلية دون نسخة.
- **تعديل رقم الترحيل يدوياً:** الرسالة نفسها تحذر منه، وقد تخسر بيانات.
- **الترحيل من عنوان HTTP داخلي:** يرفضه Forgejo، فرحل من العنوان العام بشهادة صحيحة.
- **إطفاء التحقق من الشهادة في الإنتاج:** `SKIP_TLS_VERIFY` للمختبر فقط.
- **ترك ALLOW\_LOCALNETWORKS مفتوحاً بعد الترحيل:** يجعل أداة الترحيل بابا لطلبات إلى شبكتك الداخلية.
- **الثقة بأن الويكي انتقل:** قارن بنفسك، وانقله بأدوات Git إذا لم ينتقل.
- **نسيان الإعدادات الإدارية:** Webhooks وحماية الفروع والأسرار لا تنتقل بأي أداة.
- **رمز وصول بصلاحيات كتابة أو دون حذف:** القراءة تكفي، واحذفه بعد الانتهاء.
- **إعادة ترحيل فاشل دون حذف المستودع الذي تركه:** فتظهر رسالة «already exists» أو تبقى مستودعات فارغة.

## قائمة تحقق Checklist

- إصدار Gitea معروف، والطريق مختار بحسبه: ترقية عبر Forgejo 10.0 حتى 1.22، أو أداة الترحيل بعده.
- نسخة احتياطية مختبرة قبل البدء.
- Forgejo بإصدار LTS أو مستقر مع خطة ترقية، خلف HTTPS، ومتغيرات `FORGEJO__` في ملف Compose.
- رمز وصول للقراءة فقط على Gitea، يحذف بعد الترحيل.
- مقارنة بعد كل مستودع: التذاكر، وطلبات الدمج، والإصدارات، والويكي، و`git show-ref` من الطرفين.
- Webhooks وحماية الفروع والأسرار ومفاتيح SSH أعيدت يدوياً.
- Runner لForgejo يعمل، وخطوط CI مجربة على مستودع تجريبي.
- `ALLOW_LOCALNETWORKS` أغلق بعد الانتهاء.

## ماذا تقرأ بعد ذلك؟ Next Steps

[![](https://arabroot.io/content/images/2026/10/gitea-cover-cover.webp)دليلGitea: خادم Git خاص لفريقك على سيرفرككيف تثبت Gitea على سيرفرك حتى يبقى كود فريقك عندك بتجربة تشبه GitHub، مع النسخ الاحتياطي والتحديث.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-gitea-%D9%85%D8%B9-docker-compose/)[![](https://arabroot.io/content/images/2026/10/gitea-actions-cover-cover-2.webp)دليلGitea Actions: تشغيل CI/CD وبناء Docker Images على سيرفركاجعل سيرفرك يختبر الكود ويبني Docker Images تلقائياً مع كل push، دون أن يخرج كودك أو أسرارك إلى خدمة CI خارجية.](https://arabroot.io/articles/gitea-actions-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-ci-cd-%D8%B9%D9%84%D9%89-%D8%AE%D8%A7%D8%AF%D9%85%D9%83/)[![](https://arabroot.io/content/images/2026/10/gitea-authentik-cover-cover.webp)دليلدخول موحد إلى Gitea بحسابات authentikاجعل موظفيك يدخلون إلى Gitea بحساباتهم في authentik، فتنشأ حساباتهم تلقائياً وتتبع صلاحياتهم المجموعة التي ينتمون إليها.](https://arabroot.io/articles/%D8%B1%D8%A8%D8%B7-gitea-%D9%85%D8%B9-authentik-%D8%B9%D8%A8%D8%B1-oidc/)[![](https://arabroot.io/content/images/2026/10/backup-321-cover-cover.webp)دليلالنسخ الاحتياطي بقاعدة 3-2-1 واختبار الاستعادةكيف تحدد كم بيانات تقبل أن تخسر، وتبني نسخاً لا يستطيع المخترق حذفها، وتتأكد أنك تستطيع استعادتها فعلاً.](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/)

أغلب ما في أدلة Gitea ينطبق على Forgejo بتغيير اسم الصورة وبادئة المتغيرات، فابدأ من [تثبيت Gitea مع Docker Compose](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-gitea-%D9%85%D8%B9-docker-compose/) لتجهيز السيرفر، ثم [Gitea Actions](https://arabroot.io/articles/gitea-actions-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-ci-cd-%D8%B9%D9%84%D9%89-%D8%AE%D8%A7%D8%AF%D9%85%D9%83/) لخطوط CI مع ملاحظة الفروق التي ذكرناها، و[ربط Gitea مع Authentik](https://arabroot.io/articles/%D8%B1%D8%A8%D8%B7-gitea-%D9%85%D8%B9-authentik-%D8%B9%D8%A8%D8%B1-oidc/) للدخول الموحد. وإذا كنت ستعيد بناء فحوص الدفع على السيرفر الجديد فاقرأ [Git Hooks مع pre-commit](https://arabroot.io/articles/git-hooks-%D9%85%D8%B9-pre-commit-%D8%A7%D9%81%D8%AD%D8%B5-%D8%A7%D9%84%D9%83%D9%88%D8%AF-%D9%82%D8%A8%D9%84-%D8%A7%D9%86-%D9%8A%D8%AF%D8%AE%D9%84-%D8%A7%D9%84%D9%85%D8%B3%D8%AA%D9%88%D8%AF%D8%B9/).

## الخلاصة Summary

- Gitea بدأ نسخة من Gogs في 2016، وForgejo بدأ نسخة من Gitea في ديسمبر 2022 بعد تأسيس Gitea Limited، تحت جمعية Codeberg غير الربحية، وأصبح نسخة صلبة في 2024.
- Forgejo بترخيص GPLv3+ منذ 9.0 وGitea بترخيص MIT، والفرق لا يمس غالباً من يشغل المنصة لنفسه دون توزيعها.
- GitLab CE منصة متكاملة في حجم آخر، وأساس موارده الموثق 8 vCPU و16 GB، مقابل مئات الميغابايتات للاثنين في المختبر.
- الترقية المباشرة من Gitea إلى Forgejo تتوقف عند Gitea 1.22، وعلى Gitea 28.3 توقف Forgejo 17 بخطأ رقم الترحيل 358 مقابل 305 ليحمي البيانات.
- أداة الترحيل نقلت الكود بأرقامه والتذاكر وطلبات الدمج والتسميات والإصدارات، وأصحابها بالاسم دون ربط بالحسابات، ولم تنقل الويكي دون رسالة، ولا تنقل الإعدادات الإدارية والأسرار.
- العمل الحقيقي في الترحيل هو الجرد قبله والمقارنة وإعادة الإعدادات بعده، وليس الأمر نفسه.
- بعد الانتقال تبقى المسارات واسم الملف التنفيذي كما هي، وتتغير بادئة المتغيرات والأوامر الإدارية وال Runner، وكل أداة تتصل عبر API يجب أن تدعم Forgejo باسمه لأنه يعلن توافقه مع Gitea 1.22 فقط.

## سجل التحديثات Changelog

- نوفمبر 2026: كتابة المقال، وتنفيذ تجربة تبديل الصورة والترحيل من Gitea 28.3.0 إلى Forgejo 17.0.1 عبر HTTPS بواسطة Caddy 2.11.4، مع git 2.54.0 داخل Container من alpine:3.24.