SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor · آخر تحديث في 2026-10-18

خادم Git ذاتي الاستضافة: Forgejo أم Gitea أم cgit؟

قارن أربعة خيارات لخادم Git ذاتي الاستضافة حسب استهلاك RAM: مستودعات SSH وcgit وForgejo أو Gitea وGitLab، واعرف ما يناسب VPS بسعة 1 GB.

ما خادم Git الذي ينبغي أن تشغّله

خادم Git المستضاف ذاتياً ليس منتجاً واحداً، وتحدد ذاكرة RAM (ذاكرة الوصول العشوائي) في VPS الإصدار الذي يمكنك تشغيله. لا يحتاج Git إلى daemon خاص به؛ فالمستودع العاري مع حساب SSH (الصدفة الآمنة) يشكّلان خادماً عاملاً على أصغر خادم يمكنك استئجاره. كل ما يتجاوز ذلك هو تطبيق ويب تختار تشغيله إلى جانبه، وكل مستوى إضافي يستهلك جزءاً من الذاكرة قد لا يتوفر في VPS صغير.

هناك أربعة مستويات. مستودع عارٍ عبر SSH، من دون أي خدمة تستمع إلى الاتصالات غير الخدمات التي كانت تستمع إليها مسبقاً. وcgit، وهو عرض ويب سريع للقراءة فقط ولا يحتاج إلى قاعدة بيانات. وForgejo أو Gitea، وهما forge متكامل يوفّر الحسابات وissues وpull requests باستهلاك بضع مئات من الميغابايتات. وGitLab، الذي يتطلب خادماً أكبر من الخوادم الأخرى مرات عديدة.

حدّد اختيارك وفق العمل الذي تحتاج إلى إنجازه، ثم قارن مقدار الذاكرة بمواصفات الخطة التي تدفع مقابلها.

مقدار RAM الذي يحتاجه كل خيار فعلياً

ينشر مشروعان فقط من هذه المشاريع رقماً لمتطلبات العتاد. اعتبر الرقم المنشور حداً أدنى، لا ضماناً، وقِس مثيلك بنفسك بعد تشغيله باستخدام systemd-cgtop أو ps -o rss= -C forgejo.

رسم بيانيRAM the projects document, official docs, October 2026
البيانات وراء هذا الرسم البياني
[
  {
    "label": "Gitea, small team",
    "ram_gb": 1
  },
  {
    "label": "GitLab, memory constrained",
    "ram_gb": 8
  },
  {
    "label": "GitLab, single node baseline",
    "ram_gb": 16
  }
]

تذكر وثائق Gitea أن 1 GB من RAM مع نواتي CPU تكون كافية عادةً للفرق والمشاريع الصغيرة، وتذكر أن Raspberry Pi 3 يكفي لأحمال العمل الصغيرة. وتذكر وثائق GitLab أن 16 GB هو الحد الأساسي لتثبيت على عقدة واحدة، وأن 8 GB هو الحد الأدنى لبيئة مقيّدة بالذاكرة، وفق تسمية الصفحة نفسها. لا تنشر Forgejo أي متطلبات للعتاد. وهو fork من Gitea ويتصرف مثله، لذلك فإن رقم Gitea هو أقرب إرشاد منشور متاح لك.

ماذا يعني ذلك على VPS بسعة 1 GB: تناسب المستودعات العارية وcgit هذا الخادم مع بقاء مساحة، لأن أياً منهما لا يشغّل خدمة مقيمة. سيبدأ Forgejo أو Gitea، وسيخدم فريقاً صغيراً باستخدام SQLite، لكنك تعمل عند الحد الأدنى الموثق، لذلك اترك PostgreSQL وCI (التكامل المستمر) runner خارج ذلك الخادم. إذا اختفت واجهة الويب دون ظهور خطأ، فنفّذ sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' وابحث عن سطر مثل Out of memory: Killed process 1181 (forgejo). يعني ذلك أن kernel out of memory killer أنهى العملية. تشغيل GitLab على خادم بسعة 1 GB ليس مشكلة ضبط. لن يعمل.

المستوى 0: مستودع عارٍ عبر SSH

لا يوفّر Git خادماً شبكياً تحتاج إلى تشغيله. يشغّل git push عبر SSH الأمر git-receive-pack على الطرف البعيد كعملية Unix عادية، لذلك فإن أي حساب يمكنك الوصول إليه باستخدام مفتاح يُعدّ بالفعل مستودع Git بعيداً. أنشئ حساباً واحداً للمستودعات، واحتفظ بالمستودعات خارج دليله الرئيسي، لأن الدليل الرئيسي الجديد في Ubuntu 24.04 تكون صلاحياته 0750، ولن تتمكن واجهة ويب تضيفها لاحقاً من القراءة داخله.

sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
  --group --disabled-password --home /home/git git
sudo install -d -m 0755 -o git -g git /srv/git
sudo -u git git init --bare /srv/git/project.git

ينشئ --bare مستودعاً بلا نسخة عمل، وهذا هو الشكل الذي يحتفظ به الخادم. يُرفض الدفع إلى الفرع المسجّل في مستودع لديه نسخة عمل افتراضياً باستخدام refusing to update checked out branch: refs/heads/main، وهذا هو الخطأ الأكثر شيوعاً في هذا المستوى.

امنح الحساب الآن مفتاحاً واستنسخ المستودع.

sudo -u git install -d -m 700 /home/git/.ssh
sudo -u git tee -a /home/git/.ssh/authorized_keys <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop
EOF
sudo -u git chmod 600 /home/git/.ssh/authorized_keys
git remote add origin git@vps.example.com:/srv/git/project.git
git push -u origin main

ينتهي أول دفع ناجح بالرسالة * [new branch] main -> main. أما الدفع الذي ينتهي بالرسالة git@vps.example.com: Permission denied (publickey) فلم تتم مصادقته أصلاً، لذا اقرأ سجل الخادم باستخدام sudo journalctl -u ssh -n 20. وتعني قراءة السطر Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys أن وضع الملف غير صحيح، لأن sshd يتجاهل ملف مفتاح يمكن لمستخدمين آخرين الكتابة فيه.

أزل بعد ذلك shell من الحساب.

command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" git

لا يقبل git-shell إلا الأوامر القليلة التي يرسلها Git عبر SSH، لذلك يتوقف تسجيل الدخول التفاعلي الآن برسالة بدلاً من عرض موجّه الأوامر:

fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.

هذا هو الخادم بالكامل. لا توجد قاعدة بيانات، ولا عملية ويب تحتاج إلى ترقية. ما تتخلى عنه هو كل ما يوفّره forge: لا تصفح، ولا متتبّع مشكلات، ولا pull requests، ولا أذونات منفصلة لكل مستخدم. يمكن لكل مفتاح في ذلك الملف قراءة كل مستودع يملكه المستخدم git والكتابة فيه.

المستوى 1: يمنحك cgit واجهة ويب من دون قاعدة بيانات

cgit هو برنامج CGI (واجهة البوابة العامة) مكتوب بلغة C. يشغّله خادم الويب مرة واحدة لكل طلب، ويقرأ المستودعات مباشرة من القرص، ولا يخزّن أي حالة خاصة به. يتوفر في Ubuntu 24.04 ضمن المكوّن universe.

sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgit

وجّهه إلى دليل المستودعات في /etc/cgitrc:

root-title=Git on example.com
css=/cgit.css
logo=/cgit.png
cache-size=1000
cache-root=/var/cache/cgit
snapshots=tar.gz zip
scan-path=/srv/git

يفحص scan-path ذلك الدليل ويسرد كل مستودع يعثر عليه، لذلك يظهر أي مستودع bare جديد من دون إعداد إضافي. يحدد cache-size عدد الصفحات المخزّنة مؤقتاً، ويبقى التخزين المؤقت معطلاً عندما تكون قيمته صفراً. اقرأ ما أضافته الحزمة المثبّتة لديك مسبقاً إلى /etc/cgitrc قبل إضافة الأسطر، لأن حزمة Debian وUbuntu تتضمن بعض الإعدادات الافتراضية الخاصة بها.

يعرض كل إدخال السطر الأول من ملف description الخاص بالمستودع، لذلك يظهر المستودع bare الجديد باسم Unnamed repository; edit this file 'description' to name the repository. أصلح ذلك مرة واحدة لكل مستودع:

echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/description
ملف موقع nginx وكيفية التحقق منه
server {
    listen 80;
    server_name git.example.com;
    root /usr/share/cgit;

    try_files $uri @cgit;

    location @cgit {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME /usr/lib/cgit/cgit.cgi;
        fastcgi_param PATH_INFO $uri;
        fastcgi_param QUERY_STRING $args;
        fastcgi_param HTTP_HOST $server_name;
        fastcgi_pass unix:/run/fcgiwrap.socket;
    }
}
sudo systemctl enable --now fcgiwrap.socket
sudo nginx -t && sudo systemctl reload nginx
systemctl show fcgiwrap.socket -p Listen

يقدّم root /usr/share/cgit كلّاً من cgit.css وcgit.png كملفات عادية، بينما يمرّر try_files كل ما عدا ذلك إلى CGI في /usr/lib/cgit/cgit.cgi. تعني صفحة الخطأ 502، مع وجود connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) في /var/log/nginx/error.log، أن وحدة socket لا تعمل أو أنها تستمع على مسار آخر. يطبع السطر systemctl show المسار الذي تستخدمه فعلياً.

هناك حدّان ينبغي معرفتهما قبل الاعتماد عليه. cgit للقراءة فقط ولا يتضمن تسجيل دخول، لذلك كل ما يوجد ضمن scan-path عام: أبقِ المستودع الخاص خارج ذلك الدليل، أو ضع مصادقة HTTP الأساسية أمام الموقع بالكامل. كما يعمل CGI باستخدام مستخدم خادم الويب، ولذلك يجب أن يتمكن ذلك المستخدم من عبور /srv/git وقراءة كل مستودع. يظهر الدليل الذي لا يستطيع دخوله كفهرس فارغ بدلاً من ظهور خطأ.

المستوى 2: Forgejo أو Gitea لإدارة issues وpull requests

Forgejo وGitea مبنيان على الفكرة نفسها: ملف ثنائي واحد مكتوب بلغة Go يوفّر منصة forge على الويب مع مستخدمين ومؤسسات وissues وpull requests وreleases وسجل للحزم ونظام CI مدمج. يكفي الملف الثنائي مع SQLite لإكمال التثبيت، ولذلك يمكن تشغيلهما على عتاد لا يستطيع GitLab تشغيله. ملف Compose أدناه هو الملف الوارد في توثيق Forgejo، مع وسم الصورة الذي ما زال التوثيق يسميه حتى 16 October 2026.

networks:
  forgejo:
    external: false

services:
  server:
    image: codeberg.org/forgejo/forgejo:16
    container_name: forgejo
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    networks:
      - forgejo
    volumes:
      - ./forgejo:/data
      - /etc/localtime:/etc/localtime:ro
    ports:
      - '3000:3000'
      - '222:22'

يتبع وسم 16 سلسلة v16، التي لا يدعمها Forgejo إلا حتى 29 October 2026. الإصدار المستقر الحالي هو Forgejo v17.0.0، الذي صدر في 15 October 2026. لذلك، اضبط الوسم عند التثبيت الجديد على الإصدار الرئيسي الذي تنوي تشغيله، وهو 17 وفق مخطط الوسوم نفسه. الانتقال لاحقاً من إصدار رئيسي إلى الإصدار الرئيسي التالي هو ترقية يدوية، ولذلك يكون البدء بالإصدار الحالي أقل تكلفة.

docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1

يجب أن يطبع السطر curl سطر حالة HTTP. قبل إكمال إعداد التشغيل الأول، قد تكون النتيجة إعادة توجيه إلى /install، وهذا يعني أن الخدمة تعمل. إذا خرجت الحاوية بدلاً من ذلك، فالسبب المعتاد هو الملكية: يجب أن يكون دليل ./forgejo مملوكاً لـUID (معرّف المستخدم) الموجود في USER_UID، وإلا فلن تتمكن العملية من الكتابة إلى دليل بياناتها. يشرح Docker Compose على VPS تخطيط الملفات وقاعدة ملكية volume بالكامل.

تحدّد إجابتان في صفحة الإعداد ما إذا كانت عناوين clone ستعمل. يجب أن يكون منفذ SSH هو 222، لأن ملف Compose يربط منفذ المضيف 222 بمنفذ الحاوية 22، ويجب أن يكون النطاق هو الاسم الذي سيكتبه المستخدمون فعلياً. إذا أخطأت في أي منهما، فستعرض كل صفحة مستودع أمراً لـclone يفشل لدى كل من ينسخه. يوجد كلا الإعدادين لاحقاً في قسم [server] من app.ini، بالقيم SSH_PORT وSSH_DOMAIN وROOT_URL.

بالنسبة إلى instance عامة، انشر منفذ الويب على عنوان loopback فقط ('127.0.0.1:3000:3000')، وضع nginx أمامه لتوفير TLS (أمان طبقة النقل). يثبّت Gitea بالطريقة نفسها من صورة docker.gitea.com/gitea التي يستخدمها توثيقه، أو كملف ثنائي واحد مع وحدة systemd واحدة وملف app.ini واحد. إصداره المستقر الحالي هو v28.1.0، وقد نُشر في 6 October 2026. في نهاية September، ومع الإصدار v28.0.0، أسقط المشروع البادئة القديمة 1.، ولذلك فإن الإصدار الذي يلي 1.27 هو 28، وليس 1.28.

ابقَ على SQLite ما دمت قادراً. فهي تُبقي instance في عملية واحدة وملف واحد، وتستمر في العمل بعد إعادة التشغيل دون خدمة إضافية تحتاج إلى مراقبة. تصبح PostgreSQL مبررة عندما يكتب عدة أشخاص في الوقت نفسه، لأن SQLite تسلسل عمليات الكتابة، كما أن عمليات CI الطويلة تكتب باستمرار. يستطيع كلا المشروعين نقل instance موجودة إلى PostgreSQL لاحقاً، لذلك فهذا ليس قراراً لا يمكن التراجع عنه.

Forgejo أو Gitea: ما الذي يختلف فعلياً

يشترك المشروعان في الأصل. تفرّع Gitea من Gogs في 2016. في أواخر 2022، انتقلت السيطرة على نطاق Gitea والعلامة التجارية إلى شركة هي Gitea Ltd، وبدأ عدة مشرفين، بالتعاون مع Codeberg، مشروع Forgejo. تنشر Codeberg e.V.، وهي جمعية غير ربحية مسجّلة في ألمانيا، Forgejo. وانتقل ترخيصه من MIT إلى GPLv3 (الإصدار 3 من رخصة GNU العامة) في 2024. أما Gitea فما زال مرخّصاً بموجب MIT ويُطوَّر بدعم تجاري.

في الاستخدام اليومي، مجموعتا الميزات متقاربتان. لكن مسار الانتقال بينهما ليس كذلك. كان Forgejo v10.0، الصادر في January 2025، آخر إصدار يستطيع استيراد قاعدة بيانات Gitea مباشرة، وكان ذلك متاحاً فقط من Gitea v1.22 أو أقدم. أصبح Gitea في v28.1.0 حتى October 2026، لذلك لا توجد طريقة مدعومة لنقل instance حديثة من Gitea إلى Forgejo في مكانها. اختر أحدهما قبل ملئه بالبيانات، وتعامل مع أي انتقال لاحق على أنه تصدير ثم إعادة استيراد.

قاعدة مختصرة للاختيار: إذا كانت الحوكمة مهمة لك، أو كنت تريد بقاء المشروع لدى جهة غير ربحية، فشغّل Forgejo. إذا كنت تريد قاعدة تثبيت أكبر وخيار دعم تجاري، فشغّل Gitea. كلاهما يُطوَّر علناً ويصدر تحديثات باستمرار: يصدر Forgejo إصداراً مستقراً كل ثلاثة أشهر، وإصدار LTS (دعم طويل الأمد) كل عام. وحتى 16 October 2026، كان v17.0.0 هو الإصدار الحالي، وكان v15.0.10 هو إصدار LTS. يدعم Forgejo الإصدار v17 حتى 28 January 2027، والإصدار v15 حتى 15 July 2027، بينما ينتهي دعم v16 في 29 October 2026. لذلك راجع صفحة الإصدارات قبل تثبيت إصدار رئيسي محدد.

المستوى 3: تكلفة GitLab قبل أن ينفّذ أي شيء

GitLab CE فئة مختلفة من البرمجيات. يتكوّن المثيل الواحد من مجموعة خدمات متعاونة: Puma لتطبيق الويب، وSidekiq للمهام في الخلفية، وPostgreSQL، وRedis، وGitaly للوصول إلى المستودعات، وnginx في الواجهة. تثبّت حزمة Omnibus هذه المكونات معاً، ما يجعل التثبيت بسيطاً ويجعل الحد الأدنى لاستهلاك الذاكرة مرتفعاً.

توثّق صفحة متطلبات GitLab ذاكرة RAM بسعة 16 GB و8 vCPU باعتبارهما الحد الأساسي لتثبيت على عقدة واحدة، وتذكر 8 GB باعتبارها الحد الأدنى في بيئة مقيّدة الذاكرة. وتطلب منك الصفحة نفسها تعطيل swap، لأن استخدامه تحت الحمل يؤدي إلى تدهور أداء المثيل بشدة. هذه هي الأرقام المنشورة اعتباراً من October 2026، وقد ارتفعت على مر السنين، لذلك راجع الصفحة مرة أخرى قبل تحديد مواصفات الخادم.

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

نموذج الوصول عبر SSH: مستخدم git واحد ومفاتيح متعددة

تستخدم كل طبقة هنا أسلوب المصادقة نفسه. يوجد حساب Unix واحد اسمه git، وتُضاف كل المفاتيح العامة إلى ملف ~/.ssh/authorized_keys الخاص بذلك الحساب. المفتاح هو وسيلة المصادقة. أما التفويض فيحدده كل ما تكتبه قبل المفتاح في السطر نفسه.

يمنح سطر المفتاح العادي حامله كل الصلاحيات التي يستطيع ذلك الحساب استخدامها. ويقيّده الأمر الإجباري بعمليات Git:

restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop

يوقف restrict، المتاح منذ OpenSSH 7.2، إعادة توجيه المنافذ، وإعادة توجيه الوكيل، وX11، وتخصيص PTY (طرفية وهمية) بكلمة واحدة. ويستبدل command= الطلب الذي أرسله العميل بالأمر الذي تحدده، ويستمر Git في العمل لأن Git يرسل طلبه في $SSH_ORIGINAL_COMMAND.

ينشئ forge هذا الملف نيابةً عنك، وهذا هو الفرق الفعلي بين tier 0 وtier 2. وعندما يعملان خلف خادم OpenSSH الخاص بالنظام، وهو الإعداد الافتراضي لهما، يعيد Forgejo وGitea كتابة authorized_keys بحيث يحتوي على سطر لكل مفتاح مسجل، ويتضمن كل سطر أمراً إجبارياً يعرّف المفتاح بواسطة معرّف قاعدة بياناته:

command="/usr/local/bin/forgejo --config=/etc/forgejo/app.ini serv key-3",no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty,no-user-rc,restrict ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice

يمثل هذا الأمر الإجباري الطريقة التي يتحول بها حساب Unix مشترك إلى صلاحيات منفصلة لكل مستخدم: يخبر key-3 الـforge بالمستخدم المتصل، ثم يتحقق من هذا المستخدم مقابل المستودع قبل نقل أي كائنات. لا تعدّل هذا الملف يدوياً على خادم يديره forge، لأنه يُعاد إنشاؤه من قاعدة البيانات ويختفي سطرك. إذا فعّلت خادم SSH المضمّن في forge، أو جعلت OpenSSH يطلب المفاتيح من forge عبر AuthorizedKeysCommand، فلن يحتاج forge إلى هذا الملف أصلاً، ويطلب منك كلا المشروعين تعطيل إنشائه في الحالة الثانية. وتأتي مفاتيح النشر من الآلية نفسها: مفتاح النشر هو مفتاح SSH عادي مسجل لمستودع واحد، ويكون عادةً للقراءة فقط، مع إجراء التحقق في forge بدلاً من sshd.

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

هل يمكنني تشغيل GitHub Actions على خادم Git الخاص بي؟

يمكنك تشغيل مسارات العمل المكتوبة بصيغة GitHub Actions. لكن لا يمكنك تشغيل GitHub نفسه. تكون Forgejo Actions مفعّلة افتراضياً منذ Forgejo v1.21، وتقرأ ملفات مسارات العمل من .forgejo/workflows في كل مستودع. تعمل Gitea Actions بالطريقة نفسها، وتقرأ .gitea/workflows. يحتاج كلا النظامين إلى برنامج ثانٍ، هو runner، ويجب تثبيته وتسجيله مقابل مثيلك باستخدام token من إعدادات الإدارة. تعمل العديد من الإجراءات المنشورة دون تعديل، لكن أي إجراء يستدعي GitHub API أو يتوقع بنية أساسية مستضافة لدى GitHub لن يعمل.

خطط لتبعات اثنتين. باستخدام تسميات الحاويات المعتادة، يبدأ runner حاوية لكل job، ولذلك يحتاج إلى container engine وإلى ميزانية ذاكرة خاصة به. لهذا السبب لا ينبغي وضعه على الخادم نفسه ذي الذاكرة 1 GB الذي يشغّل forge. يمكن لكلا runnerين أيضاً تشغيل jobs مباشرة على المضيف، من خلال label ينتهي بـ :host في Forgejo. لا يتطلب ذلك engine، لكنه لا يضع أي حاوية بين job وهذا الجهاز. كما ينفّذ runner كل ما يحدده ملف مسار العمل. وتذكر وثائق Forgejo ذلك بوضوح: ينفّذ runner تعليمات برمجية عن بُعد. خصّص له مضيفاً مستقلاً إن أمكن، أو على الأقل مستخدماً غير ذي امتيازات وregistration token محصوراً في مستودع واحد.

إذا بقيت مستودعاتك على GitHub وأردت فقط تشغيل الحسابات على أجهزة تملك التحكم فيها، فهذا إعداد مختلف بخطوات مختلفة: يرتبط runner مستضاف ذاتياً لـ GitHub Actions بمستودع GitHub ولا يحتاج إلى أي مما سبق. وإذا كنت لا تزال تقيّم تكلفة المغادرة، فإن ما الذي يقدمه لك GitHub فعلياً يفصل استضافة Git عن الشبكة المحيطة بها.

النسخ الاحتياطية: المستودعات لا تمثل سوى نصف الحالة

المستودع العاري هو مجلد، لذلك يؤدي نسخه إلى نسخ كل ما يحتوي عليه. ويُعد الاستنساخ المتطابق من جهاز آخر نسخة احتياطية فعلية، كما أنه يحدّث النسخة في مكانها:

git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote update

يسحب ذلك كل ref وكل object. لكنه لا يسحب server-side hooks أو الملف description، لذلك احتفظ أيضاً بنسخة على مستوى الملفات من المجلد إذا كنت تستخدم hooks.

يحتفظ forge بالـissues وpull requests والمستخدمين والمفاتيح والأذونات في قاعدة بياناته، ونسخ المستودعات وحدها يتخلص من كل ذلك. يوفّر كلا المشروعين أمراً لإنشاء dump يكتب قاعدة البيانات والمستودعات والإعدادات والمرفقات في archive واحد:

sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zip

في Docker، يُشغَّل الأمر نفسه داخل الحاوية، ويعتمد مسار الإعدادات على image، لذلك تحقّق منه قبل الكتابة:

docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.ini

شغّل الأمر بصلاحيات المستخدم الذي يملك البيانات، واكتب archive في مجلد يستطيع ذلك المستخدم الكتابة فيه. ثم انسخ archive خارج الخادم، لأن النسخة الاحتياطية الموجودة فقط على الجهاز الذي تُجرى له النسخ ليست نسخة احتياطية. الاستعادة هي الخطوة التي يتخطاها الناس: فكّ أحد ملفات dump على جهاز احتياطي الآن، حتى تتعلم الإجراء في وقت هادئ بدلاً من تعلمه أثناء انقطاع الخدمة.

اختيار الحل وفق السيناريو

شخص واحد لديه حاسوب محمول وVPS ولا يحتاج إلى التصفح: استخدم مستودعات bare عبر SSH. لا توجد خدمة إضافية قيد التشغيل، ولا شيء يحتاج إلى الترقية.

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

فريق يراجع أفراده شيفرة بعضهم ويتتبع المشكلات: استخدم Forgejo أو Gitea على خادم بسعة 2 GB من RAM أو أكثر. انقل CI runner إلى خادم ثانٍ عندما تصبح المهام فعلية.

مؤسسة تحتاج إلى container registry وسجلات تدقيق، ولديها 16 GB مخصصة للخادم: استخدم GitLab. إذا كانت الميزانية أقل من ذلك، فلا تبدأ بتشغيله.

الانتقال بين المستويات الثلاثة الأولى غير مكلف، لأن المستودعات في جميع هذه الحالات مجلدات Git عادية على القرص. ابدأ بأدنى مستوى يحقق الغرض. إذا كنت تحدد الخدمات الأخرى التي تستحق مساحة على الخادم نفسه، فإن القائمة المختصرة بما يستحق الاستضافة الذاتية تضع خادم Git بجانب الخدمات الأخرى التي تتنافس على سعة RAM.

FAQ

هل يمكن لـ VPS بسعة 1 GB تشغيل Forgejo أو Gitea؟

نعم، لفريق صغير، باستخدام SQLite، بشرط ألا توجد خدمات أخرى تستهلك موارد كبيرة على الخادم. توضح وثائق Gitea أن ذاكرة RAM بسعة 1 GB ونواتي CPU تكونان كافيتين عادةً للفرق والمشاريع الصغيرة، وForgejo هو fork من Gitea وله المتطلبات العامة نفسها. لا تضف PostgreSQL أو CI runner إلى ذلك الجهاز. إذا اختفت الخدمة من دون ظهور خطأ في سجلها، فنفّذ sudo dmesg -T | grep -Ei 'oom|out of memory|killed process': يشير سطر يذكر اسم العملية التي أُنهيت إلى أن kernel out of memory killer هو الذي أوقفها، وعندها تحتاج إلى خطة أكبر، لا إلى flag للضبط.

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

يشترك المشروعان في تاريخ codebase نفسه وفي معظم الميزات. تفرّع Gitea من Gogs في 2016، وتفرّع Forgejo من Gitea في أواخر 2022 بعد انتقال التحكم في العلامة التجارية Gitea إلى شركة. تنشر Codeberg e.V.، وهي مؤسسة غير ربحية في ألمانيا، Forgejo بموجب GPLv3؛ بينما يظل Gitea مرخّصاً بموجب MIT ومدعوماً تجارياً. الفرق العملي هو مسار الترحيل. كان Forgejo v10.0، الصادر في January 2025، آخر release يمكنه استخدام قاعدة بيانات Gitea مباشرة، وذلك فقط من Gitea v1.22 أو أقدم؛ لذلك لا يملك مثيل Gitea الحالي طريقة تبديل مدعومة داخل المكان نفسه.

هل يمكنني تشغيل workflows الخاصة بـ GitHub Actions على Git server مستضاف ذاتياً؟

يشغّل كل من Forgejo Actions وGitea Actions workflows مكتوبة بصيغة GitHub Actions YAML، وتُقرأ من .forgejo/workflows و.gitea/workflows. ثبّت برنامج runner منفصلاً وسجّله لدى مثيلك. تعمل كثير من actions المنشورة دون تعديل، بينما لا تعمل أي action تستدعي GitHub API. ينفّذ runner تعليمات برمجية عشوائية من مستودعاتك، ومع labels الحاويات المعتادة، يبدأ container لكل job. لذلك خصّص له خادماً مستقلاً، أو على الأقل مستخدماً غير مميّز مستقلاً، ولا تشغّله على خادم بسعة 1 GB يعمل عليه forge بالفعل.

كيف أنشئ نسخة احتياطية من Git server مستضاف ذاتياً؟

بالنسبة إلى bare repositories، ينسخ git clone --mirror من جهاز آخر كل ref وobject، ويحدّث git remote update داخل ذلك mirror محتواه. أما في Forgejo أو Gitea، فالمستودعات ليست سوى جزء من الحالة، لأن issues وpull requests والمستخدمين والمفاتيح موجودة في قاعدة البيانات. استخدم dump المضمّن، sudo -u git forgejo dump -c /etc/forgejo/app.ini، أو نفّذ الأمر نفسه داخل container عند استخدام Docker. انسخ الأرشيف إلى خارج الخادم، واستعد نسخة منه على جهاز احتياطي مرة واحدة حتى تتأكد من أن الإجراء يعمل.

هل كان هذا المقال مفيدًا؟