Gogs

Hozzáférés

• Nyisd meg a böngészőt, és lépj a következő címre: https://<SERVER_IP>
• Böngészős SSL figyelmeztetés várható (önaláírt tanúsítvány)
• Új fiók regisztrálása
• Az első regisztrált fiók rendszergazda lesz

Önregisztráció letiltása (opcionális)

Alapértelmezés szerint a felhasználói önregisztráció engedélyezve van.

1. Szerkeszd a konfigurációs fájlt: /etc/gogs/conf/app.ini

2. Alatt a [auth] szekció, módosítás DISABLE_REGISTRATION = false to DISABLE_REGISTRATION = true

3. Indítsa újra a Gogs-t:

systemctl restart gogs

Fontos fájlok és könyvtárak

• Telepítési könyvtár: /opt/gogs
• Konfigurációs fájl: /etc/gogs/conf/app.ini
• Alkalmazás adatai: /var/lib/gogs
• Tárolóhelyek: /var/lib/gogs/repositories
• Naplók: /var/log/gogs
• Systemd szolgáltatás: /etc/systemd/system/gogs.service
• Nginx konfiguráció: /etc/nginx/sites-available/gogs.conf
• TLS tanúsítványok: /etc/nginx/ssl/

Git használata

HTTPS (önaláírt tanúsítvány):

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

SSH (beépített szerver):

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

Szolgáltatás kezelése

Gogs:

systemctl status gogs
systemctl restart gogs

Nginx:

systemctl status nginx
systemctl restart nginx

PostgreSQL:

systemctl status postgresql
systemctl restart postgresql

Megjegyzések

• A fő konfigurációs fájl helye: /etc/gogs/conf/app.ini. A konfigurációs fájl módosítása után indítsd újra a szolgáltatást ezzel: systemctl restart gogs.
• Az Nginx feltöltési korlátja itt van megadva: /etc/nginx/sites-available/gogs.conf használatával client_max_body_size`. Növelje meg ezt nagy repositoryk esetén, majd indítsa újra az Nginx-et.
• Nagy telepítések esetén az alábbi sort vegye ki a megjegyzés alól: LimitMEMLOCK=infinity és LimitNOFILE=65535 in /etc/systemd/system/gogs.service, majd futtasd systemctl daemon-reload majd indítsa újra a(z) Gogs szolgáltatást.
• Az adatbázis hitelesítő adatai itt vannak meghatározva: /etc/gogs/conf/app.ini.
• Éles környezetben ajánlott az önaláírt tanúsítványt érvényes Let's Encrypt tanúsítványra cserélni.
• Önaláírt tanúsítvány esetén a(z) HTTPS klónozáshoz szükséges: GIT_SSL_NO_VERIFY=true.

SSL engedélyezése domainnel

1. Irányítsd a domainedet a szerver IP-címére.

2. Frissítse a(z) Gogs konfigurációját (/etc/gogs/conf/app.ini):

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

3. Indítsa újra a(z) Gogs szolgáltatást a módosítások alkalmazásához:

systemctl restart gogs

3. Szerkessze az Nginx konfigurációját, és cserélje le mindkét server_name <IP>; a saját domainjével (<your-domain>) a HTTP (80-as port) és az HTTPS (443-as port) blokkokhoz:

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

4. Telepítse a Certbot:

apt install -y certbot python3-certbot-nginx

5. Futtassa az alábbi parancsot az érvényes Let's Encrypt tanúsítvány generálásához:

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

6. Cserélje le a(z) SSL elérési útjait az Nginx konfigurációjában:

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. Indítsa újra az Nginx-et a módosítások alkalmazásához:

systemctl restart nginx

8. Nyissa meg a böngészőjét, és látogasson el ide: https://yourdomain.com