Hoe installeer je Gitea om een ​​lokale Git-server te hebben?

Digitale informatie » Bronnen » Hoe installeer ik Gitea om een ​​lokale Git-server te hebben?

Ben je het zat om afhankelijk te zijn van de regels, kosten of beschikbaarheid van giganten zoals GitHub of GitLab? Dan is het bouwen van je eigen infrastructuur de oplossing. Met een Git-server thuis of op kantoor heb je de volledige controle: absolute controle over de code , volledig toegangsbeheer en de zekerheid dat je privérepositories niet worden beperkt door derden.

Van alle beschikbare opties springt Gitea eruit als een pareltje. Het is een tool geschreven in Go, waardoor het ongelooflijk lichtgewicht en snel is , ideaal voor wie geen 16 GB RAM wil toewijzen aan een Git-server. In tegenstelling tot GitLab, dat weliswaar boordevol functies zit maar veel resources verbruikt, is Gitea als een speedboot: het komt direct ter zake, verbruikt zeer weinig resources en biedt een zeer vertrouwde interface voor iedereen die GitHub al eens gebruikt heeft.

Snelle vergelijking: Gitea, GitLab en Forgejo

Voordat je begint met de installatie, is het handig om te weten waar je aan begint. GitLab is de ultieme bedrijfsoplossing, ideaal voor grote teams die geïntegreerde CI/CD nodig hebben, maar vereist krachtige hardware. Gitea daarentegen is de beste keuze voor bescheiden servers of persoonlijke projecten vanwege het zeer lage geheugenverbruik. Tot slot is er Forgejo, een community-fork van Gitea; als je een purist bent op het gebied van vrije software en de voorkeur geeft aan open governance zonder bedrijfsmatige bijklanken, dan is dit het alternatief voor jou.

Wat u nodig hebt voordat u begint

Om ervoor te zorgen dat alles soepel verloopt, moet u beschikken over een Linux-server (Ubuntu, Debian of Rocky Linux) met root-toegang. Het is ook essentieel om Git op de machine te hebben geïnstalleerd. Hoewel Gitea het gebruik van SQLite toestaat, worden voor productieomgevingen PostgreSQL of MariaDB sterk aanbevolen om de stabiliteit van de gegevens te garanderen.

De basis leggen in het systeem

Het is om veiligheidsredenen geen goed idee om Gitea als root te gebruiken. Het is beter om een ​​aparte gebruiker aan te maken. Dit kun je doen met het volgende commando: adduser --system --shell /bin/bash --group --home /home/gitea giteaHet is essentieel om te gebruiken /bin/bash als shell omdat Gitea via SSH met git-shell moet communiceren. Als je Git nog niet hebt geïnstalleerd, is een eenvoudige apt install git Het probleem zal snel opgelost zijn.

Binaire installatie en mapstructuur

Gitea kan op verschillende manieren worden geïnstalleerd, maar de binaire versie is het eenvoudigst. Je kunt de nieuwste stabiele versie vinden op de officiële website en deze downloaden met behulp van [methode/methode]. wget en /usr/local/bin/gitealater geven Voer de rechten uit met chmod +xOm het programma correct te laten functioneren, moeten een aantal specifieke mappen worden aangemaakt: /etc/gitea voor configuratie en /var/lib/gitea voor aangepaste gegevens, logboeken en bestanden. Vergeet niet de instellingen aan te passen. eigendomsrechten (chown) zodat de gebruiker gitea ze kan schrijven.

Databaseconfiguratie

Als je voor PostgreSQL kiest, moet je naast de database ook het pakket installeren en een specifieke rol met een sterk wachtwoord aanmaken. giteadb met UTF8-codering. Als je MariaDB verkiest, is het proces vergelijkbaar: je maakt de database en de gebruiker aan en zorgt ervoor dat de De opslagengine is InnoDB. en dat de server luistert op poort 3306.

Automatisering met SystemD

Om te voorkomen dat je Gitea elke keer handmatig moet starten wanneer je de server herstart, kun je het beste een schijfbestand aanmaken in /etc/systemd/system/gitea.serviceDit bestand vertelt het systeem dat Gitea moet als een service worden uitgevoerd.Definieer de gebruiker, groep en het binaire pad. Zodra deze zijn aangemaakt, hoeft u alleen nog maar het volgende commando uit te voeren: systemctl enable --now gitea De server zal standaard luisteren op poort 3000.

Het eerste contact met de webinterface

Bij binnenkomst http://tu-ip:3000Vervolgens kom je in de installatiewizard terecht. Hier verbind je de database (door de host, gebruikersnaam en wachtwoord op te geven) en definieer je de instellingen. algemene site-instellingenDenk bijvoorbeeld aan de instantienaam en de basis-URL. Het is ook tijd om de SSH-server te configureren en te beslissen of iedereen zich mag registreren of dat je liever... Openbare logboekregistratie uitschakelen om de server privé te houden.

Beveiliging en professionele toegang met Nginx

Toegang tot Gitea via poort 3000 is inefficiënt en onveilig. De ideale oplossing is het opzetten van een reverse proxy met Nginx . Dit stelt gebruikers in staat de site te benaderen via een domein (bijvoorbeeld git.jouwdomein.com) en zorgt ervoor dat al het verkeer versleuteld is met Let's Encrypt SSL-certificaten . In de Nginx-configuratie hoeft u alleen het verkeer van poort 443 om te leiden naar poort 3000 van Gitea en de X-Forwarded-For-headers toe te voegen om te voorkomen dat het echte IP-adres van de client verloren gaat.

Gebruikersbeheer en codemigratie

Als u open logging hebt uitgeschakeld, kunt u de eerste beheerder aanmaken via de opdrachtregel met het volgende commando: gitea admin user createEenmaal binnen kunt u uw openbare SSH-sleutels In het gebruikersprofiel kun je repositories klonen zonder telkens je wachtwoord in te voeren. Als je al code op GitHub hebt staan, biedt Gitea een geïntegreerde migratietool Het importeert automatisch niet alleen de code, maar ook de issues en tags.

Onderhoud en afstelling

Het onderhouden van Gitea is ongelooflijk eenvoudig. Om te updaten, downloadt u simpelweg het nieuwe binaire bestand, vervangt u het oude en start u de service opnieuw. Voor back-ups gebruikt u het commando. gitea dump is je beste vriend, omdat het een gecomprimeerd bestand met allesDatabase, configuratie en repositories. Voor e-mail kunt u een externe SMTP-server configureren (zoals Gmail) of Postfix op de server installeren om meldingen te ontvangen over pull-requests en waarschuwingen.

Met Gitea beschikt u over een robuust, lichtgewicht en volledig privé versiebeheerplatform, waardoor u niet langer afhankelijk bent van externe services dankzij een binaire installatie, een geoptimaliseerde database en een reverse proxy die de verkeersbeveiliging via HTTPS garandeert.