Ako nainštalovať Gitea pre lokálny Git server

Posledná aktualizácia: 3 septembra 2026
  • Gitea je ľahká alternatíva ku GitLabu a GitHubu, ktorá spotrebúva veľmi málo systémových prostriedkov.
  • Inštalácia je založená na spustiteľnom binárnom súbore spravovanom ako služba prostredníctvom SystemD.
  • Používanie reverznej proxy s Nginx je nevyhnutné pre zabezpečenie zabezpečeného prístupu cez HTTPS.
  • Umožňuje migráciu existujúcich repozitárov z iných platforiem pri zachovaní úloh a značiek.

Serverové racky v dátovom centre, predstavujúce infraštruktúru lokálneho Git servera.

Ak vás už nebaví spoliehať sa na pravidlá, náklady alebo dostupnosť gigantov ako GitHub alebo GitLab, budovanie vlastnej infraštruktúry je tou správnou cestou. Mať Git server doma alebo vo vlastnej kancelárii vám dáva kľúče od kráľovstva: absolútnu kontrolu nad kódom , úplnú správu prístupov a pokoj v duši, že nemáte žiadne obmedzenia tretích strán týkajúce sa vašich súkromných repozitárov.

Spomedzi všetkých dostupných možností vyniká Gitea ako klenot. Je to nástroj napísaný v jazyku Go, vďaka čomu je neuveriteľne ľahký a rýchly , ideálny pre tých, ktorí nechcú venovať 16 GB RAM serveru Git. Na rozdiel od GitLabu, čo je funkčne bohatá, ale na zdroje náročná zaoceánska loď, Gitea je ako motorový čln: ide rovno k veci, spotrebúva veľmi málo zdrojov a ponúka veľmi známe rozhranie pre každého, kto používal GitHub.

Rýchle porovnanie: Gitea, GitLab a Forgejo

Softvérový inžinier konfigurujúci server pomocou notebooku v serverovni.

Predtým, ako sa pustíte do inštalácie, je dobré vedieť, do čoho idete. GitLab je typickou podnikovou voľbou, ideálnou pre veľké tímy, ktoré potrebujú integrovanú CI/CD, ale vyžaduje si výkonný hardvér. Gitea je na druhej strane najlepšou voľbou pre skromné ​​servery alebo osobné projekty vďaka svojej veľmi malej pamäťovej náročnosti. Nakoniec je tu Forgejo, komunitný fork Gitea; ak ste purista slobodného softvéru a uprednostňujete otvorenú správu bez korporátnych podtónov, toto je pre vás alternatíva.

  Čo je to server a ako funguje: Typy a vlastnosti

Čo potrebujete, než začnete

Prenosný počítač zobrazujúci riadky kódu v modernom pracovnom priestore, ideálny na ilustráciu správy repozitára Git.

Aby všetko bežalo hladko, uistite sa, že máte Linuxový server (buď Ubuntu, Debian alebo Rocky Linux) s root prístupom. Je tiež nevyhnutné mať na počítači nainštalovaný Git a hoci Gitea umožňuje používanie SQLite, pre produkčné prostredia sa dôrazne odporúča PostgreSQL alebo MariaDB , aby sa zaručila stabilita údajov.

Príprava pôdy v systéme

Detailný záber rúk programujúcich na klávesnici, ktorý predstavuje vývoj softvéru a používanie Gitea.

Spúšťanie Gitey ako root nie je z bezpečnostných dôvodov dobrý nápad. Najlepšie je vytvoriť vyhradeného používateľa. Môžete to urobiť spustením príkazu adduser --system --shell /bin/bash --group --home /home/gitea giteaJe nevyhnutné používať /bin/bash ako shell pretože Gitea potrebuje interagovať s git-shell cez SSH. Ak ešte nemáte nainštalovaný Git, jednoduchý apt install git problém rýchlo vyrieši.

Inštalácia binárnych súborov a štruktúra priečinkov

Detail ethernetových káblov pripojených k sieťovému prepínaču, znázorňujúci konfiguráciu siete a reverznú proxy.

Gitea sa dá nainštalovať niekoľkými spôsobmi, ale binárny súbor je najjednoduchší. Najnovšiu stabilnú verziu by ste mali nájsť na jej oficiálnej webovej stránke a stiahnuť si ju pomocou [metóda/metóda]. wget en /usr/local/bin/giteadám to neskôr spustiť oprávnenia pomocou chmod +xPre správne fungovanie programu je potrebné vytvoriť niekoľko špecifických adresárov: /etc/gitea pre konfiguráciu a /var/lib/gitea pre vlastné údaje, protokoly a súbory. Nezabudnite upraviť povolenia k majetku (chown) aby im používateľ gitea mohol písať.

Konfigurácia databázy

Ak si vyberiete PostgreSQL, budete musieť okrem databázy nainštalovať balík a vytvoriť špecifickú rolu so silným heslom. giteadb s kódovaním UTF8. Ak uprednostňujete MariaDB, postup je podobný: vytvoríte databázu a používateľa a uistíte sa, že úložný mechanizmus je InnoDB a že server počúva na porte 3306.

  Podpora MCP servera v prostredí GNOME: kompletný sprievodca

Automatizácia so SystemD

Aby ste sa vyhli nutnosti manuálneho spúšťania Gitey pri každom reštartovaní servera, je najlepšie vytvoriť súbor na disku v /etc/systemd/system/gitea.serviceTento súbor informuje systém o tom, že Gitea musí byť prevádzkovaná ako službadefinovanie používateľa, skupiny a binárnej cesty. Po vytvorení jednoducho spustite systemctl enable --now gitea a server začne štandardne počúvať na porte 3000.

Prvý kontakt s webovým rozhraním

Pri vstupe http://tu-ip:3000Potom sa zobrazí sprievodca nastavením. Tu pripojíte databázu (zadaním hostiteľa, používateľského mena a hesla) a definujete všeobecné nastavenia stránky, ako napríklad názov inštancie a základná URL adresa. Je tiež čas nakonfigurovať SSH server a rozhodnúť sa, či chcete, aby sa mohol zaregistrovať ktokoľvek, alebo či uprednostňujete... zakázať verejné logovanie aby server zostal súkromný.

Bezpečnosť a profesionálny prístup s Nginx

Prístup k Gitea cez port 3000 je neefektívny a nezabezpečený. Ideálnym riešením je nastaviť reverznú proxy s Nginx . To umožňuje používateľom prístup k stránke cez doménu (napr. git.vasadomena.com) a zabezpečuje, že všetka prevádzka je šifrovaná pomocou SSL certifikátov Let's Encrypt . V konfigurácii Nginx jednoducho presmerujte prevádzku z portu 443 na port 3000 Gitea a pridajte hlavičky X-Forwarded-For, aby ste predišli strate skutočnej IP adresy klienta.

Správa používateľov a migrácia kódu

Ak ste zakázali otvorené protokolovanie, prvého správcu môžete vytvoriť pomocou príkazu príkazu gitea admin user createKeď ste vo vnútri, môžete pridať svoje verejné SSH kľúče v používateľskom profile na klonovanie repozitárov bez nutnosti zadávania hesla zakaždým. Ak už máte kód na GitHub, Gitea má integrovaný migračný nástroj Automaticky importuje nielen kód, ale aj problémy a značky.

  Ako automatizovať pracovné postupy pomocou n8n a Dockeru

Údržba a ladenie

Údržba Gitea je neuveriteľne jednoduchá. Pre aktualizáciu si jednoducho stiahnite nový binárny súbor, nahraďte starý a reštartujte službu. Pre zálohy použite príkaz gitea dump je váš najlepší priateľ, pretože generuje komprimovaný súbor so všetkýmDatabáza, konfigurácia a repozitáre. Pre e-mail môžete nakonfigurovať externý SMTP server (napríklad Gmail) alebo nainštalovať Postfix na server, aby ste dostávali upozornenia na žiadosti o zmeny a upozornenia.

Implementácia Gitea vám umožňuje mať robustnú, ľahkú a plne súkromnú platformu na správu verzií, ktorá eliminuje závislosť od externých služieb prostredníctvom inštalácie založenej na binárnych súboroch, optimalizovanej databázy a reverzného proxy servera, ktorý zaručuje bezpečnosť prevádzky cez HTTPS.