Hogyan telepítsük a Giteát, hogy helyi Git szerverünk legyen?

Utolsó frissítés: 3 szeptember 2026
  • A Gitea egy könnyű alternatívája a GitLabnak és a GitHubnak, amely nagyon kevés rendszererőforrást fogyaszt.
  • A telepítés egy futtatható bináris fájlon alapul, amelyet a SystemD szolgáltatásként kezel.
  • A fordított proxy használata Nginx-szel elengedhetetlen a HTTPS-en keresztüli biztonságos hozzáféréshez.
  • Lehetővé teszi a meglévő adattárak migrálását más platformokról, miközben megőrzi a problémákat és a címkéket.

Adatközpontban található szerverállványok, amelyek egy helyi Git-kiszolgáló infrastruktúráját képviselik.

Ha eleged van abból, hogy olyan óriások szabályaira, költségeire vagy elérhetőségére hagyatkozol, mint a GitHub vagy a GitLab, akkor a saját infrastruktúra kiépítése a helyes út. Egy otthoni vagy irodai Git-kiszolgáló megadja a kulcsot a királysághoz: abszolút kontrollt a kód felett , teljes hozzáférés-kezelést, és azt a nyugalmat, hogy nincsenek harmadik féltől származó korlátozások a privát adattáraiddal kapcsolatban.

Az összes elérhető opció közül a Gitea igazi gyöngyszemként emelkedik ki. Go nyelven írt eszköz, ami hihetetlenül könnyűvé és gyorssá teszi , ideális azok számára, akik nem akarnak 16 GB RAM-ot egy Git-kiszolgálóra szánni. A GitLabbal ellentétben, ami egy funkciókban gazdag, de erőforrás-igényes óceánjáró, a Gitea olyan, mint egy motorcsónak: egyenesen a lényegre tér, nagyon kevés erőforrást fogyaszt, és nagyon ismerős felületet kínál mindazok számára, akik használták a GitHubot.

Gyors összehasonlítás: Gitea, GitLab és Forgejo

Szoftvermérnök szerver konfigurálása laptop segítségével egy szerverszobában.

Mielőtt belevágnánk a telepítésbe, érdemes tudni, hogy mire is fogunk kilyukadni. A GitLab a lényegi vállalati megoldás, ideális nagy csapatok számára, amelyeknek integrált CI/CD-re van szükségük, de erős hardvert igényel. A Gitea ezzel szemben a legjobb választás szerényebb szerverekhez vagy személyes projektekhez, nagyon kis memóriaigénye miatt. Végül ott van a Forgejo, a Gitea közösségi elágazása; ha a szabad szoftverek puristája vagy, és a nyílt irányítást részesíted előnyben vállalati felhangok nélkül, akkor ez a megfelelő alternatíva számodra.

  Mi a szerver és hogyan működik: típusai és jellemzői

Amire szüksége van, mielőtt elkezdi

Kódsorokat megjelenítő laptop egy modern munkaterületen, ideális a Git-tárház kezelésének szemléltetésére.

A zökkenőmentes működés érdekében győződj meg róla, hogy rendelkezel egy Linux szerverrel (Ubuntu, Debian vagy Rocky Linux) root hozzáféréssel. Az is elengedhetetlen, hogy a Git telepítve legyen a gépen, és bár a Gitea lehetővé teszi az SQLite használatát, éles környezetekben a PostgreSQL vagy a MariaDB használata erősen ajánlott az adatstabilitás garantálása érdekében.

A talaj előkészítése a rendszerben

Közeli kép billentyűzeten programozó kezekről, amelyek a szoftverfejlesztést és a Gitea használatát jelképezik.

Biztonsági okokból nem jó ötlet a Gitea root felhasználóként való futtatása. A legjobb, ha egy dedikált felhasználót hozol létre. Ezt a következő parancs futtatásával teheted meg: adduser --system --shell /bin/bash --group --home /home/gitea gitea. Alapvető fontosságú a használata /bin/bash parancsértelmezőként mert a Giteának SSH-n keresztül kell kommunikálnia a git-shell-lel. Ha még nincs telepítve a Git, egy egyszerű apt install git gyorsan megoldja a problémát.

Bináris telepítés és mappaszerkezet

Hálózati kapcsolóhoz csatlakoztatott Ethernet-kábelek részlete, amely a hálózati konfigurációt és a fordított proxyt szemlélteti.

A Gitea többféleképpen telepíthető, de a bináris fájl a legegyszerűbb. Keresd meg a legújabb stabil verziót a hivatalos weboldalán, és töltsd le a [method/method] paranccsal. wget en /usr/local/bin/giteakésőbb adom oda jogosultságok végrehajtása a chmod +x paranccsalAhhoz, hogy a program megfelelően működjön, létre kell hozni egy sor speciális könyvtárat: /etc/gitea konfigurációhoz és /var/lib/gitea egyéni adatokhoz, naplókhoz és fájlokhoz. Ne felejtse el módosítani a tulajdonjogok (chown) hogy a gitea felhasználó írhasson nekik.

Adatbázis konfiguráció

Ha a PostgreSQL-t választod, akkor telepítened kell a csomagot, és létre kell hoznod egy speciális szerepkört egy erős jelszóval, az adatbázis mellett. giteadb UTF8 kódolással. Ha a MariaDB-t részesíted előnyben, a folyamat hasonló: létrehozod az adatbázist és a felhasználót, ügyelve arra, hogy a a tárolómotor az InnoDB és hogy a szerver a 3306-os porton figyel.

  MCP szerver támogatás GNOME környezetben: teljes útmutató

Automatizálás a SystemD-vel

Annak elkerülése érdekében, hogy a szerver minden újraindításakor manuálisan kelljen elindítani a Giteát, a legjobb, ha létrehoz egy meghajtófájlt a következő helyen: /etc/systemd/system/gitea.serviceEz a fájl azt mondja a rendszernek, hogy A Giteát szolgáltatásként kell futtatnia felhasználó, a csoport és a bináris elérési út meghatározásával. Létrehozás után egyszerűen futtassa systemctl enable --now gitea és a szerver alapértelmezés szerint a 3000-es porton kezd el figyelni.

Az első kapcsolatfelvétel a webes felülettel

Belépéskor http://tu-ip:3000Ezután a beállítóvarázslóval találkozik. Itt csatlakoztathatja az adatbázist (megadva a gazdagépet, a felhasználónevet és a jelszót), és meghatározhatja a általános webhelybeállítások, például a példány nevét és az alap URL-t. Itt az ideje az SSH-kiszolgáló konfigurálásának is, és annak eldöntésének, hogy bárki regisztrálhasson-e, vagy inkább... nyilvános naplózás letiltása hogy a szerver privát maradjon.

Biztonság és professzionális hozzáférés az Nginx segítségével

A Gitea elérése a 3000-es porton keresztül nem hatékony és nem biztonságos. Az ideális megoldás egy fordított proxy beállítása az Nginx segítségével . Ez lehetővé teszi a felhasználók számára, hogy egy domainen (pl. git.yourdomain.com) keresztül érjék el az oldalt, és biztosítja, hogy az összes forgalom titkosítva legyen a Let's Encrypt SSL tanúsítványokkal . Az Nginx konfigurációjában egyszerűen irányítsa át a forgalmat a 443-as portról a Gitea 3000-es portjára, hozzáadva az X-Forwarded-For fejléceket, hogy elkerülje a kliens valódi IP-címének elvesztését.

Felhasználókezelés és kódmigráció

Ha letiltotta a nyílt naplózást, akkor az első rendszergazdát a parancssorból hozhatja létre a következő paranccsal: gitea admin user createMiután belépett, hozzáadhatja a nyilvános SSH-kulcsok a felhasználói profilban a tárolók klónozásához anélkül, hogy minden alkalommal meg kellene adni a jelszót. Ha már van kódod a GitHubon, a Gitea rendelkezik egy integrált migrációs eszköz Nemcsak a kódot, hanem a problémákat és a címkéket is automatikusan importálja.

  Hogyan automatizálhatók a munkafolyamatok az n8n és a Docker segítségével?

Karbantartás és hangolás

A Gitea karbantartása hihetetlenül egyszerű. A frissítéshez egyszerűen töltse le az új bináris fájlt, cserélje ki a régit, és indítsa újra a szolgáltatást. Biztonsági mentésekhez használja a következő parancsot: gitea dump a legjobb barátod, mivel generál egy tömörített fájl mindennel együttAdatbázis, konfiguráció és adattárak. E-mail esetén konfigurálhat egy külső SMTP-kiszolgálót (például a Gmailt), vagy telepítheti a Postfixet a kiszolgálóra, hogy értesítéseket kapjon a pull requestekről és riasztásokról.

A Gitea bevezetése egy robusztus, könnyűsúlyú és teljesen privát verziókövető platformot tesz lehetővé, amely kiküszöböli a külső szolgáltatásoktól való függőséget a bináris alapú telepítés, az optimalizált adatbázis és a HTTPS-en keresztüli forgalombiztonságot garantáló fordított proxy révén.