Gogs

Adgang

• Åbn din browser og gå til: https://<SERVER_IP>
• En SSL-advarsel i browseren er forventet (selvsigneret certifikat)
• Registrer en ny konto
• Den første registrerede konto bliver administrator

Deaktiver selvregistrering (valgfrit)

Som standard er brugerselvregistrering aktiveret.

1. Rediger konfigurationsfilen: /etc/gogs/conf/app.ini

2. Under [auth] afsnit, ændre: DISABLE_REGISTRATION = false to DISABLE_REGISTRATION = true

3. Genstart Gogs:

systemctl restart gogs

Vigtige filer og mapper

• Installationsmappe: /opt/gogs
• Konfigurationsfil: /etc/gogs/conf/app.ini
• Ansøgningsdata: /var/lib/gogs
• Opbevaringssteder: /var/lib/gogs/repositories
• Logfiler: /var/log/gogs
• Systemd service: /etc/systemd/system/gogs.service
• Nginx-config: /etc/nginx/sites-available/gogs.conf
• TLS-certifikater: /etc/nginx/ssl/

Git-brug

HTTPS (selvsigneret certifikat):

GIT_SSL_NO_VERIFY=true git clone https://<SERVER_IP>/<USERNAME>/<REPOSITORY>.git

SSH (indbygget server):

git clone ssh://git@<SERVER_IP>:2222/<USERNAME>/<REPOSITORY>.git

Service-håndtering

Gogs:

systemctl status gogs
systemctl restart gogs

Nginx:

systemctl status nginx
systemctl restart nginx

PostgreSQL:

systemctl status postgresql
systemctl restart postgresql

Noter

• Hovedkonfigurationsfilen er placeret på /etc/gogs/conf/app.ini. Efter at have ændret konfigurationsfilen, genstart tjenesten vha systemctl restart gogs.
• Nginx-uploadgrænsen er defineret i /etc/nginx/sites-available/gogs.conf bruger client_max_body_size. Forøg det for store lagre og genstart Nginx.
• Ved store implementeringer kan du fjerne kommentarer LimitMEMLOCK=infinity og LimitNOFILE=65535 in /etc/systemd/system/gogs.service, så løb systemctl daemon-reload og genstart Gogs.
• Database legitimationsoplysninger er defineret i /etc/gogs/conf/app.ini.
• Til produktionsbrug anbefales det at erstatte det selvsignerede certifikat med et gyldigt Let's Encrypt-certifikat.
• Hvis du bruger et selvsigneret certifikat, kræver HTTPS-kloning GIT_SSL_NO_VERIFY=true.

Aktivering af SSL med et domæne

1. Peg dit domæne mod serverens IP.

2. Opdater Gogs-konfiguration (/etc/gogs/conf/app.ini):

EXTERNAL_URL = https://yourdomain.com/
DOMAIN = yourdomain.com
SSH_DOMAIN = yourdomain.com

3. Genstart Gogs-tjenesten for at anvende ændringer:

systemctl restart gogs

3. Rediger Nginx-konfigurationen og erstat begge server_name <IP>; med dit domæne (<your-domain>) for både HTTP (port 80) og HTTPS (port 443) blokke:

vim /etc/nginx/sites-available/gogs.conf

4. Installer Certbot:

apt install -y certbot python3-certbot-nginx

5. Kør følgende kommando for at generere et gyldigt Let's Encrypt-certifikat:

certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com

6. Erstat SSL-stier i Nginx-konfiguration:

vim /etc/nginx/sites-available/gogs.conf
# Before:
    # ssl_certificate /etc/nginx/ssl/gogs.crt;
    # ssl_certificate_key /etc/nginx/ssl/gogs.key;
# After:
    # ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    # ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

7. Genstart Nginx for at anvende ændringerne:

systemctl restart nginx

8. Åbn din browser og besøg: https://yourdomain.com