SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

انتخاب بهترین سرور Git شخصی: Forgejo، Gitea یا cgit

بررسی 4 روش راه‌اندازی سرور Git شخصی بر اساس میزان مصرف RAM. از مخازن bare روی SSH تا cgit، Forgejo و GitLab. ببینید کدام گزینه برای یک VPS با 1 GB رم مناسب است.

کدام سرور Git شخصی را باید اجرا کنید

یک سرور Git شخصی تنها یک محصول خاص نیست و میزان RAM (حافظه دسترسی تصادفی) در VPS شما تعیین می‌کند که کدام نسخه از آن را می‌توانید داشته باشید. Git به هیچ daemon اختصاصی نیاز ندارد: یک مخزن bare به همراه یک حساب SSH (پوسته امن)، همین حالا روی کوچک‌ترین سروری که می‌توانید اجاره کنید، یک سرور فعال است. هر چیزی فراتر از این سطح، یک برنامه تحت وب است که انتخاب می‌کنید در کنار آن اجرا شود و هر پله ارتقا، هزینه‌ای از حافظه را تحمیل می‌کند که ممکن است یک VPS کوچک از عهده آن برنیاید. اگر هنوز در تفاوت Git با GitHub و یک سرور Git شخصی تردید دارید، تفاوت Git، GitHub و سرور Git شخصی این مرز را پیش از انتخاب سطح سرویس برای شما مشخص می‌کند.

چهار سطح وجود دارد. یک مخزن bare روی SSH، بدون اینکه هیچ سرویس اضافه‌ای در حال گوش دادن باشد. cgit، یک رابط وب سریع و فقط‌خواندنی بدون نیاز به دیتابیس. Forgejo یا Gitea، یک پلتفرم کامل با قابلیت مدیریت حساب‌ها، issueها و pull requestها که به چند صد مگابایت حافظه نیاز دارد. GitLab، که انتظار دارد سروری با چندین برابر ظرفیت سایر گزینه‌ها در اختیار داشته باشید.

بر اساس کاری که باید انجام دهید تصمیم بگیرید، سپس میزان حافظه مورد نیاز را با پلنی که برای آن هزینه پرداخت می‌کنید، تطبیق دهید.

میزان رم مورد نیاز هر گزینه

تنها دو مورد از این پروژه‌ها عدد مشخصی برای سخت‌افزار منتشر کرده‌اند. عدد منتشرشده را به عنوان حداقل کفِ نیاز در نظر بگیرید، نه یک تضمین؛ و پس از راه‌اندازی، میزان مصرف نمونهٔ خود را با 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 رم به همراه 2 هسته CPU را برای تیم‌ها و پروژه‌های کوچک به‌طور معمول کافی می‌دانند و از Raspberry Pi 3 به عنوان دستگاهی که برای بارهای کاری کوچک کفایت می‌کند، نام می‌برند. مستندات GitLab مقدار 16 GB را به عنوان خط پایه برای نصب روی یک گره (node) و 8 GB را به عنوان حداقلِ پایین‌رده برای آنچه در صفحهٔ خود «محیط محدود از نظر حافظه» می‌نامند، ذکر کرده‌اند. مستندات نصب Forgejo هیچ عددی برای رم ارائه نمی‌دهد. از آنجا که این پروژه انشعابی (fork) از Gitea است و رفتاری مشابه آن دارد، عدد Gitea نزدیک‌ترین راهنمای منتشرشده‌ای است که در اختیار دارید.

این موضوع در یک VPS با 1 GB رم به این معناست: مخازن bare و cgit با فضای باقی‌مانده به‌خوبی اجرا می‌شوند، زیرا هیچ‌کدام سرویس مقیم (resident) ندارند. 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: مخزن bare روی SSH

Git هیچ daemon شبکه‌ای ندارد که نیاز به راه‌اندازی داشته باشد. git push روی SSH، برنامه git-receive-pack را در سمت مقصد به عنوان یک پردازش معمولی Unix اجرا می‌کند، بنابراین هر حسابی که بتوانید با یک کلید به آن دسترسی پیدا کنید، از قبل یک Git remote محسوب می‌شود. یک حساب کاربری برای مخازن بسازید و مخازن را خارج از دایرکتوری home آن نگه دارید تا اگر بعداً یک رابط وب اضافه کردید، نیازی به دسترسی به آن دایرکتوری home نداشته باشد.

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 یک مخزن بدون working copy ایجاد می‌کند که دقیقاً همان چیزی است که یک سرور باید نگهداری کند. push کردن به شاخه‌ای که در یک مخزن دارای working copy در وضعیت checkout قرار دارد، به‌صورت پیش‌فرض با خطای refusing to update checked out branch: refs/heads/main رد می‌شود و این رایج‌ترین اشتباه در این سطح است.

اکنون به حساب کاربری یک کلید بدهید و آن را clone کنید.

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

اولین push موفق با * [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 است به این معنی است که مالکیت یا مجوز فایل (mode) اشتباه است، زیرا sshd یک فایل کلید را که مالک غیرقابل اعتماد دارد یا مجوزهایی دارد که به سایر کاربران اجازه نوشتن می‌دهد، رد می‌کند.

اگر origin پروژه از قبل به GitHub اشاره می‌کند، git remote add origin با خطای error: remote origin already exists. متوقف می‌شود و افزودن این سرور به عنوان یک URL دوم برای push روی آن remote به شما اجازه می‌دهد با یک دستور git push، هر دو را به‌روزرسانی کنید.

سپس دسترسی shell را از حساب کاربری بگیرید.

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

git-shell فقط دستورات محدودی را که Git از طریق SSH ارسال می‌کند می‌پذیرد، بنابراین ورود تعاملی (interactive login) اکنون به‌جای نمایش prompt، با یک پیام متوقف می‌شود:

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

این تمام چیزی است که سرور شامل می‌شود. هیچ پایگاه داده‌ای وجود ندارد و هیچ پردازش وبی برای ارتقا نیاز نیست. آنچه از دست می‌دهید تمام امکاناتی است که یک پلتفرم مدیریت مخزن (forge) ارائه می‌دهد: امکان مرور کد، سیستم ردیابی مشکلات (issue tracker)، pull requestها و مجوزهای سطح کاربر وجود ندارد. هر کلیدی که در آن فایل باشد، می‌تواند تمام مخازنی را که کاربر 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 basic در ابتدای کل سایت استفاده کنید. همچنین، CGI با کاربر وب‌سرور اجرا می‌شود، بنابراین آن کاربر باید اجازه دسترسی به /srv/git و خواندن هر مخزن را داشته باشد. دایرکتوری‌هایی که کاربر اجازه ورود به آن‌ها را ندارد، به‌جای نمایش خطا، به‌عنوان یک فهرست خالی نشان داده می‌شوند.

سطح 2: استفاده از Forgejo یا Gitea برای مدیریت Issues و Pull Requests

Forgejo و Gitea ایدهٔ یکسانی دارند: یک فایل باینری Go که یک پلتفرم توسعه وب شامل کاربران، سازمان‌ها، Issues، Pull Requests، Releases، یک مخزن پکیج و یک سیستم CI داخلی ارائه می‌دهد. کل نصب شامل فایل باینری و SQLite است؛ به همین دلیل روی سخت‌افزارهایی که GitLab توان اجرای آن را ندارد، به‌خوبی اجرا می‌شوند. فایل Compose زیر همان فایلی است که در مستندات Forgejo آمده و از تگ ایمیجی استفاده می‌کند که در تاریخ 24 اکتبر 2026 نام‌گذاری شده است.

networks:
  forgejo:
    external: false

services:
  server:
    image: codeberg.org/forgejo/forgejo:17
    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'

آن تگ 17 از سری v17 پیروی می‌کند. نسخه Forgejo v17.0.1 که در 26 اکتبر 2026 منتشر شد، نسخه پایدار فعلی است و Forgejo تا 28 ژانویه 2027 از v17 پشتیبانی می‌کند. پشتیبانی از سری قدیمی‌تر v16 در 29 اکتبر 2026 به پایان رسید، بنابراین نصب‌های موجود که هنوز روی تگ 16 هستند، اکنون باید ارتقا یابند. مهاجرت از یک نسخه اصلی به نسخه بعدی در آینده به‌صورت دستی انجام می‌شود، بنابراین شروع کار با نسخه فعلی به‌صرفه‌تر است.

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

خط curl باید یک خط وضعیت HTTP چاپ کند. پیش از آنکه تنظیمات اولیه (first-run setup) را تکمیل کنید، ممکن است با یک redirect به /install مواجه شوید که همچنان به معنای بالا بودن سرویس است. اگر کانتینر متوقف (exit) می‌شود، دلیل معمول آن مالکیت فایل‌هاست: دایرکتوری ./forgejo باید متعلق به UID (شناسه کاربری) موجود در USER_UID باشد، در غیر این صورت پردازش نمی‌تواند در دایرکتوری داده‌های خود بنویسد. Docker Compose روی یک VPS این ساختار فایل و قانون مالکیت volume را به‌طور کامل پوشش می‌دهد.

دو پاسخ در صفحه تنظیمات تعیین می‌کنند که آیا آدرس‌های clone کار می‌کنند یا خیر. پورت SSH باید سمت میزبان (host) نگاشت SSH باشد که در فایل Compose بالا 222 است، زیرا پورت 222 میزبان را به پورت 22 کانتینر نگاشت می‌کند. هیچ الزامی برای استفاده از خود 222 وجود ندارد: هر پورت آزاد میزبان کار می‌کند، به شرطی که نگاشت و این پاسخ با هم مطابقت داشته باشند. همچنین دامنه باید همان نامی باشد که کاربران واقعاً تایپ می‌کنند. اگر هر کدام از این‌ها اشتباه باشد، در صفحه هر مخزن، دستور cloneای نمایش داده می‌شود که برای هر کسی که آن را کپی کند، با خطا مواجه خواهد شد. هر دو مورد بعداً در بخش [server] از فایل app.ini، به عنوان SSH_PORT، SSH_DOMAIN و ROOT_URL قرار دارند.

برای یک نمونه عمومی (public instance)، پورت وب را فقط روی آدرس loopback ('127.0.0.1:3000:3000') منتشر کنید و برای TLS (امنیت لایه انتقال) از nginx در مقابل آن استفاده کنید. Gitea به همان روش از ایمیج docker.gitea.com/gitea که در مستنداتش آمده نصب می‌شود، یا به عنوان یک باینری واحد با یک واحد systemd و یک فایل app.ini. نسخه پایدار فعلی آن v28.4.0 است که در 15 نوامبر 2026 منتشر شد. با انتشار v28.0.0 در پایان سپتامبر، این پروژه پیشوند قدیمی 1. را حذف کرد، بنابراین نسخه بعد از 1.27، نسخه 28 است، نه 1.28.

تا زمانی که می‌توانید از SQLite استفاده کنید. این کار باعث می‌شود نمونه شما به یک پردازش و یک فایل محدود بماند و پس از reboot بدون نیاز به سرویس اضافی برای نظارت، به کار خود ادامه دهد. PostgreSQL زمانی ارزش هزینه کردن را دارد که چندین نفر همزمان در حال نوشتن باشند، زیرا SQLite عملیات نوشتن را سریال می‌کند و اجرای طولانی‌مدت CI به‌طور مداوم در حال نوشتن است. هر دو پروژه می‌توانند یک نمونه موجود را بعداً به PostgreSQL منتقل کنند، بنابراین این تصمیمی نیست که در آن گرفتار شوید.

Forgejo یا Gitea: تفاوت واقعی در چیست

تبار این دو مشترک است. Gitea در سال 2016 از Gogs منشعب شد. در اواخر سال 2022، کنترل دامنه و علامت تجاری Gitea به شرکتی به نام Gitea Ltd واگذار شد و چندین نگهدارنده (maintainer) به همراه Codeberg پروژه Forgejo را آغاز کردند. Forgejo توسط جامعه کاربری خود تحت حمایت Codeberg e.V. توسعه می‌یابد؛ یک انجمن غیرانتفاعی ثبت‌شده در آلمان که دامنه‌های پروژه را در اختیار دارد، در حالی که مدیریت پروژه همچنان با مشارکت‌کنندگان خود Forgejo است. این پروژه در سال 2024 از مجوز MIT به GPLv3 (مجوز عمومی همگانی گنو نسخه 3) تغییر وضعیت داد. Gitea با مجوز MIT باقی مانده و با حمایت تجاری توسعه می‌یابد.

در استفاده روزمره، مجموعه ویژگی‌ها به هم نزدیک است. اما مسیر مهاجرت بین آن‌ها این‌طور نیست. Forgejo v10.0، محصول ژانویه 2025، آخرین نسخه‌ای بود که می‌توانست دیتابیس Gitea را مستقیماً بپذیرد، آن هم فقط از Gitea v1.22 یا قدیمی‌تر. Gitea تا 16 نوامبر 2026 در نسخه v28.4.0 است، بنابراین یک نمونه فعلی Gitea هیچ مسیر پشتیبانی‌شده‌ای برای سوئیچ درجا به Forgejo ندارد. پیش از آنکه آن را با داده پر کنید، یکی را انتخاب کنید و هرگونه جابجایی بعدی را به عنوان یک عملیات export و re-import در نظر بگیرید.

یک قاعده کوتاه برای انتخاب: اگر حاکمیت (governance) برای شما مهم است، یا پروژه‌ای تحت حمایت یک نهاد غیرانتفاعی می‌خواهید، Forgejo را اجرا کنید. اگر پایگاه نصب بزرگ‌تر و گزینه پشتیبانی تجاری می‌خواهید، Gitea را اجرا کنید. هر دو به‌صورت متن‌باز نگهداری می‌شوند و به‌طور مرتب منتشر می‌شوند: Forgejo هر سه ماه یک نسخه پایدار و هر سال یک نسخه LTS (پشتیبانی بلندمدت) ارائه می‌دهد، که تا 29 اکتبر 2026 نسخه v17.0.1 نسخه فعلی و v15.0.11 نسخه LTS است. Forgejo از v17 تا 28 ژانویه 2027 و از v15 تا 15 ژوئیه 2027 پشتیبانی می‌کند، در حالی که پشتیبانی v16 در 29 اکتبر 2026 پایان یافت، بنابراین پیش از تعیین نسخه اصلی، صفحه Releases آن را بررسی کنید. اگر هیچ‌کدام از این قواعد مشکل را حل نکرد، مقایسه کامل Forgejo و Gitea توضیح می‌دهد که چگونه Actions و مخازن پکیج آن‌ها با هم تفاوت دارند، و این جزئیاتی است که باید پیش از آنکه داده‌هایتان مهاجرت را پرهزینه کند، در مورد آن تصمیم بگیرید.

سطح 3: هزینه‌های GitLab پیش از هرگونه استفاده

نرم‌افزار GitLab CE در ردهٔ متفاوتی قرار دارد. هر نمونه (instance) از این نرم‌افزار، مجموعه‌ای از سرویس‌های همکار است: Puma برای اپلیکیشن وب، Sidekiq برای پردازش‌های پس‌زمینه، PostgreSQL، Redis، Gitaly برای دسترسی به مخازن (repository) و nginx در لایهٔ جلویی. بستهٔ Omnibus تمامی این موارد را یکجا نصب می‌کند که باعث سادگی نصب، اما افزایش حداقل حافظهٔ مورد نیاز می‌شود.

صفحهٔ نیازمندی‌های GitLab، مقدار 16 GB رم و 8 vCPU را به عنوان حداقل استاندارد برای نصب روی یک گره (node) واحد تعیین کرده است و 8 GB را به عنوان پایین‌ترین حد برای محیط‌های با محدودیت حافظه ذکر می‌کند. همین صفحه توصیه می‌کند که swap را غیرفعال کنید، زیرا استفاده از swap تحت فشار کاری، عملکرد نمونه را به‌شدت کاهش می‌دهد. این ارقام تا اکتبر 2026 معتبر هستند و با گذشت سال‌ها افزایش یافته‌اند؛ بنابراین پیش از تعیین ابعاد سرور، حتماً دوباره آن صفحه را مطالعه کنید.

شما در ازای این بودجه، قابلیت‌های واقعی دریافت می‌کنید: container registry، package registry، سطوح دسترسی دقیق و CI که در مقیاس‌های بزرگ تست شده است؛ مرکز انطباق (compliance center) و مسیرهای حسابرسی (audit trails) پروژه یا گروه، نیازمند تهیهٔ اشتراک پولی GitLab هستند. اگر هیچ‌کس در تیم شما نمی‌تواند موردی از این لیست را نام ببرد که در این فصل به آن نیاز داشته باشد، شما صرفاً هزینهٔ یک VPS بزرگ‌تر را می‌پردازید بدون آنکه بهره‌ای از آن ببرید.

مدل دسترسی SSH: یک کاربر git و چندین کلید

در سیستم OpenSSH، تمام سطوح در اینجا به روش یکسانی احراز هویت می‌شوند. یک حساب کاربری یونیکس به نام git وجود دارد و تمام کلیدهای عمومی در فایل ~/.ssh/authorized_keys آن حساب قرار می‌گیرند. احراز هویت بر عهده کلید است. مجوزدهی نیز همان گزینه‌هایی است که در ابتدای همان خط، پیش از کلید می‌نویسید.

یک خط کلید ساده، تمام دسترسی‌های آن حساب کاربری را به دارنده کلید می‌دهد. برای حسابی که همچنان از /bin/bash به عنوان shell ورود استفاده می‌کند، یک دستور اجباری (forced command) دسترسی را به Git محدود می‌کند:

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

عبارت restrict که از نسخه 7.2 به بعد در OpenSSH در دسترس است، قابلیت‌های port forwarding، agent forwarding، X11 و تخصیص PTY (ترمینال مجازی) را در یک کلمه غیرفعال می‌کند. عبارت command= هر دستوری که کلاینت درخواست کرده باشد را با دستوری که شما تعیین می‌کنید جایگزین می‌کند و Git همچنان کار می‌کند، زیرا سرور SSH دستور اصلی کلاینت را در متغیر $SSH_ORIGINAL_COMMAND قرار می‌دهد.

یک پلتفرم مدیریت مخزن (forge) این فایل را برای شما می‌نویسد و این تفاوت اصلی بین سطح 0 و سطح 2 است. زمانی که Forgejo و Gitea پشت سر سرور OpenSSH سیستم قرار می‌گیرند (که حالت پیش‌فرض آن‌هاست)، فایل 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

آن دستور اجباری همان روشی است که یک حساب کاربری مشترک یونیکس را به مجوزهای اختصاصی هر کاربر تبدیل می‌کند: key-3 به پلتفرم می‌گوید کدام کاربر در حال اتصال است و پیش از جابه‌جایی هرگونه آبجکت، دسترسی آن کاربر به مخزن را بررسی می‌کند. این فایل را در سروری که توسط پلتفرم مدیریت می‌شود به‌صورت دستی ویرایش نکنید، زیرا فایل از روی پایگاه‌داده بازنویسی می‌شود و خط شما حذف خواهد شد. اگر سرور SSH داخلی پلتفرم را فعال کنید یا از OpenSSH بخواهید کلیدها را از طریق AuthorizedKeysCommand از پلتفرم دریافت کند، پلتفرم دیگر به آن فایل نیازی نخواهد داشت و هر دو پروژه در حالت دوم به شما توصیه می‌کنند ایجاد آن فایل را غیرفعال کنید. کلیدهای استقرار (deploy keys) نیز از همین مکانیزم استفاده می‌کنند: یک کلید استقرار، یک کلید SSH معمولی است که برای یک مخزن خاص ثبت شده و معمولاً فقط‌خواندنی است؛ در این حالت بررسی دسترسی به‌جای sshd، در خود پلتفرم انجام می‌شود.

دو عادت بیش از تمام پیکربندی‌های بالا اهمیت دارند. برای هر شخص یا هر ماشین یک کلید اختصاصی صادر کنید و هرگز از کلید مشترک استفاده نکنید، زیرا ابطال یک کلید مشترک به معنای تغییر آن برای همه افراد به‌طور همزمان است. همچنین کلیدها را در همان روزی که فردی سازمان را ترک می‌کند حذف کنید، زیرا یک کلید قدیمی در آن فایل، یک راه ورود دائمی است که هیچ‌کس آن را تحت نظارت ندارد. مدیریت صحیح کلیدهای SSH روی سرور انواع کلیدها و عبارات عبور (passphrase) را پوشش می‌دهد و تمام آن موارد در اینجا نیز بدون تغییر صدق می‌کنند. اگر سرور جدید است، ده دقیقه اول روی یک VPS جدید کاری است که باید پیش از قرار دادن مخازن روی آن انجام دهید.

آیا می‌توانم GitHub Actions را روی سرور Git شخصی خود اجرا کنم؟

شما می‌توانید workflowهایی را که با سینتکس GitHub Actions نوشته شده‌اند، اجرا کنید. شما نمی‌توانید GitHub را اجرا کنید. قابلیت Forgejo Actions از نسخه Forgejo v1.21 به‌صورت پیش‌فرض فعال شده است و فایل‌های workflow را از مسیر .forgejo/workflows در هر مخزن می‌خواند. Gitea Actions نیز به همین صورت عمل کرده و .gitea/workflows را می‌خواند. هر دو به برنامه دومی به نام runner نیاز دارند که باید نصب شده و با استفاده از توکنی که از تنظیمات مدیریت دریافت می‌شود، در instance شما ثبت گردد. بسیاری از actionهای منتشرشده بدون تغییر اجرا می‌شوند.

دو پیامد را در نظر بگیرید. با برچسب‌های (label) کانتینری معمول، runner برای هر job یک کانتینر راه‌اندازی می‌کند؛ بنابراین به یک موتور کانتینر و بودجه حافظه (RAM) اختصاصی نیاز دارد. به همین دلیل، نباید آن را روی همان سرور 1 GB که forge روی آن قرار دارد، میزبانی کرد. هر دو runner می‌توانند jobها را مستقیماً روی host نیز اجرا کنند (از طریق برچسبی که در Forgejo به :host ختم می‌شود)؛ این روش نیازی به موتور کانتینر ندارد، اما هیچ لایه محافظتی بین job و آن ماشین قرار نمی‌دهد. همچنین runner هر دستوری را که در فایل workflow نوشته شده باشد اجرا می‌کند؛ مستندات Forgejo این موضوع را به‌صراحت بیان کرده‌اند: runner عملیات اجرای کد از راه دور (remote code execution) را انجام می‌دهد. تا حد امکان آن را روی یک host مجزا قرار دهید، یا حداقل از یک کاربر بدون دسترسی‌های ویژه (unprivileged user) و یک توکن ثبت با محدودیت دسترسی به یک مخزن خاص استفاده کنید.

اگر مخازن شما در GitHub باقی می‌مانند و فقط می‌خواهید پردازش روی سخت‌افزاری باشد که کنترل آن را در دست دارید، این یک سناریوی متفاوت با مراحل جداگانه است: یک runner خودمیزبان GitHub Actions به یک مخزن GitHub متصل می‌شود و به هیچ‌کدام از این موارد نیاز ندارد. اگر هنوز در حال بررسی هزینه‌های خروج از GitHub هستید، آنچه GitHub واقعاً به شما ارائه می‌دهد، میزبانی Git را از شبکه پیرامون آن تفکیک می‌کند.

پشتیبان‌گیری: مخازن تنها نیمی از وضعیت هستند

یک مخزن bare در واقع یک دایرکتوری است، بنابراین کپی کردن آن، تمام محتویاتش را کپی می‌کند. یک mirror clone از دستگاهی دیگر، یک پشتیبان واقعی محسوب می‌شود و به‌صورت درجا به‌روزرسانی می‌گردد:

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

این دستور تمام refها و objectها را دریافت می‌کند. این کار شامل hookهای سمت سرور یا فایل description نمی‌شود، بنابراین اگر از hookها استفاده می‌کنید، یک کپی در سطح فایل از دایرکتوری نیز تهیه کنید.

یک پلتفرم مدیریت مخزن (Forge)، مواردی مانند issueها، pull requestها، کاربران، کلیدها و مجوزها را در دیتابیس خود نگه می‌دارد و کپی کردن صرفِ مخازن، تمام این اطلاعات را از دست می‌دهد. هر دو پروژه دستور dump را ارائه می‌دهند که دیتابیس، مخازن، پیکربندی و پیوست‌ها را در یک آرشیو می‌نویسد:

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

در محیط Docker، همین دستور در داخل container اجرا می‌شود و مسیر پیکربندی به image بستگی دارد، پس پیش از تایپ کردن بررسی کنید:

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

دستور را با کاربری که مالک داده‌هاست اجرا کنید و آرشیو را در دایرکتوری بنویسید که آن کاربر اجازه نوشتن در آن را دارد. سپس آرشیو را از سرور خارج کنید، زیرا پشتیبانی که فقط روی همان ماشینی که از آن نسخه تهیه شده وجود داشته باشد، پشتیبان محسوب نمی‌شود. بازیابی مرحله‌ای است که افراد از آن غافل می‌شوند: همین حالا یک dump را روی یک سیستم یدکی باز کنید تا این فرآیند را در شرایط آرام یاد بگیرید، نه در زمان بروز قطعی.

انتخاب بر اساس سناریو

یک نفر با یک لپ‌تاپ و یک VPS، بدون نیاز به مرورگر: استفاده از bare repositories روی SSH. هیچ سرویس اضافه‌ای در حال اجرا نیست و چیزی برای ارتقا وجود ندارد.

همان سناریو، به علاوه نیاز به خواندن کد در مرورگر و ارسال لینک به آن: افزودن cgit. همچنان بدون دیتابیس و بدون هیچ سرویس مقیمی.

یک تیم که کدهای یکدیگر را بازبینی کرده و issueها را پیگیری می‌کنند: استفاده از Forgejo یا Gitea، با حداقل 2 GB رم یا بیشتر. هنگامی که حجم کارها واقعی شد، CI runner را به یک سرور دوم منتقل کنید.

یک سازمان که به container registry و audit trails نیاز دارد، با 16 GB رم برای سرور: استفاده از GitLab. با بودجه‌ای کمتر از این مقدار، آن را راه‌اندازی نکنید.

ارتقا از سه سطح اول ارزان است، زیرا در همه آن‌ها مخازن، دایرکتوری‌های معمولی Git روی دیسک هستند. از پایین‌ترین سطحی که نیاز شما را برطرف می‌کند شروع کنید. اگر در حال بررسی این هستید که چه چیزهای دیگری ارزش فضای سرور شما را دارند، لیست کوتاه سرویس‌های ارزشمند برای self-hosting یک سرور Git را در کنار سایر سرویس‌هایی که برای آن مقدار رم رقابت می‌کنند، قرار می‌دهد.

FAQ

آیا یک VPS با 1 GB رم می‌تواند Forgejo یا Gitea را اجرا کند؟

بله، برای یک تیم کوچک، روی SQLite و به شرطی که هیچ چیز سنگین دیگری روی ماشین نباشد. مستندات Gitea مقدار 1 GB رم و 2 هسته CPU را برای تیم‌ها و پروژه‌های کوچک به‌طور معمول کافی می‌داند و Forgejo نیز انشعابی از Gitea با ساختاری مشابه است. PostgreSQL یا CI runner را به آن ماشین اضافه نکنید. اگر سرویس بدون هیچ خطایی در لاگ خود ناپدید شد، sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' را اجرا کنید: خطی که نام پردازش متوقف‌شده را نشان می‌دهد به این معنی است که kernel out of memory killer آن را متوقف کرده است و پاسخ این مشکل، ارتقا به پلن بالاتر است، نه تغییر در پرچم‌های تنظیمات.

تفاوت Forgejo و Gitea چیست؟

آن‌ها تاریخچه کد یکسانی دارند و اکثر ویژگی‌هایشان مشترک است. Gitea در سال 2016 از Gogs منشعب شد و Forgejo در اواخر سال 2022، پس از آنکه کنترل علامت تجاری Gitea به یک شرکت واگذار شد، از Gitea منشعب گردید. Forgejo توسط جامعهٔ کاربری خود تحت نظارت Codeberg e.V. (یک سازمان غیرانتفاعی در آلمان) توسعه می‌یابد و تحت مجوز GPLv3 منتشر می‌شود؛ Gitea با پشتیبانی تجاری، مجوز MIT را حفظ کرده است. تفاوت عملی در مسیر مهاجرت است. نسخه Forgejo v10.0 که در ژانویه 2025 منتشر شد، آخرین نسخه‌ای بود که می‌توانست دیتابیس Gitea را مستقیماً بپذیرد و آن هم فقط از Gitea v1.22 یا قدیمی‌تر؛ بنابراین یک نمونه فعلی Gitea مسیر پشتیبانی‌شده‌ای برای سوئیچ درجا ندارد.

آیا می‌توانم ورک‌فلوهای GitHub Actions را روی یک سرور Git شخصی اجرا کنم؟

هم Forgejo Actions و هم Gitea Actions ورک‌فلوهایی را که با سینتکس YAML در GitHub Actions نوشته شده‌اند، از .forgejo/workflows و .gitea/workflows می‌خوانند. شما یک برنامه runner جداگانه نصب می‌کنید و آن را روی نمونه خود ثبت می‌کنید. بسیاری از اکشن‌های منتشرشده بدون تغییر کار می‌کنند. این runner کدهای دلخواه را از مخازن شما اجرا می‌کند و با استفاده از برچسب‌های کانتینری معمول، به ازای هر job یک کانتینر را شروع می‌کند؛ بنابراین آن را روی میزبان اختصاصی خود یا حداقل با یک کاربر بدون دسترسی ریشه (unprivileged) اجرا کنید و آن را روی سرور 1 GB که در حال اجرای خودِ forge است، قرار ندهید.

چگونه از یک سرور Git شخصی نسخه پشتیبان تهیه کنم؟

برای مخازن bare، دستور git clone --mirror از یک ماشین دیگر تمام refها و objectها را کپی می‌کند و git remote update در داخل آن mirror، آن را به‌روزرسانی می‌کند. برای Forgejo یا Gitea، مخازن تنها بخشی از وضعیت سیستم هستند، زیرا issueها، pull requestها، کاربران و کلیدها در دیتابیس قرار دارند. از قابلیت dump داخلی یعنی sudo -u git forgejo dump -c /etc/forgejo/app.ini یا همان دستور در داخل کانتینر برای نصب‌های Docker استفاده کنید. آرشیو را از سرور خارج کنید و یک بار آن را روی یک ماشین یدکی بازیابی کنید تا مطمئن شوید که این روش کار می‌کند.

آیا این مقاله مفید بود؟

#git#self-hosting#forgejo#gitea#ssh