กอกส์

บริการ Git แบบติดตั้งบนเครื่องเองที่ใช้งานง่าย เสถียร และตั้งค่าได้สะดวกบนหลายแพลตฟอร์ม

เข้าถึง

  • เปิดเบราว์เซอร์ของคุณและเข้าไปที่: https://<SERVER_IP>
  • คาดว่าจะมีการแจ้งเตือน SSL จากเบราว์เซอร์ (ใบรับรองที่ลงนามด้วยตนเอง)
  • ลงทะเบียนบัญชีใหม่
  • บัญชีผู้ใช้แรกที่ลงทะเบียนจะได้รับสิทธิ์เป็นผู้ดูแลระบบ

ปิดใช้งานการลงทะเบียนด้วยตนเอง (ไม่บังคับ)

โดยค่าเริ่มต้น ระบบจะเปิดใช้งานการลงทะเบียนด้วยตนเองของผู้ใช้

1. แก้ไขไฟล์การตั้งค่า: /etc/gogs/conf/app.ini

2. ภายใต้ [auth] ส่วน, การเปลี่ยนแปลง: DISABLE_REGISTRATION = false ถึง DISABLE_REGISTRATION = true

3. รีสตาร์ท Gogs:

systemctl restart gogs

ไฟล์และไดเร็กทอรีที่สำคัญ

  • ไดเร็กทอรีการติดตั้ง: /opt/gogs
  • ไฟล์การกำหนดค่า: /etc/gogs/conf/app.ini
  • ข้อมูลการสมัคร: /var/lib/gogs
  • ที่เก็บข้อมูล: /var/lib/gogs/repositories
  • บันทึก: /var/log/gogs
  • บริการ Systemd: /etc/systemd/system/gogs.service
  • การตั้งค่า Nginx: /etc/nginx/sites-available/gogs.conf
  • ใบรับรอง TLS: /etc/nginx/ssl/

การใช้งาน Git

HTTPS (ใบรับรองที่ลงนามด้วยตนเอง):

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

SSH (เซิร์ฟเวอร์ในตัว):

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

การจัดการบริการ

กอกส์:

systemctl status gogs
systemctl restart gogs

Nginx:

systemctl status nginx
systemctl restart nginx

PostgreSQL:

systemctl status postgresql
systemctl restart postgresql

หมายเหตุ

  • ไฟล์การกำหนดค่าหลักอยู่ที่ /etc/gogs/conf/app.iniหลังจากแก้ไขไฟล์การกำหนดค่าแล้ว ให้รีสตาร์ทบริการโดยใช้คำสั่ง systemctl restart gogs.
  • ขีดจำกัดการอัปโหลดของ Nginx ถูกกำหนดไว้ใน /etc/nginx/sites-available/gogs.conf โดยใช้ client_max_body_sizeเพิ่มค่านี้สำหรับที่เก็บข้อมูลขนาดใหญ่ และรีสตาร์ท Nginx
  • สำหรับการใช้งานขนาดใหญ่ คุณสามารถยกเลิกการใส่เครื่องหมายคอมเมนต์ได้ LimitMEMLOCK=infinity และ LimitNOFILE=65535 ใน /etc/systemd/system/gogs.serviceจากนั้นจึงดำเนินการ systemctl daemon-reload แล้วรีสตาร์ท Gogs
  • ข้อมูลประจำตัวฐานข้อมูลถูกกำหนดไว้ใน /etc/gogs/conf/app.ini.
  • สำหรับการใช้งานจริง แนะนำให้เปลี่ยนใบรับรองที่ลงนามด้วยตนเองเป็นใบรับรอง Let's Encrypt ที่ถูกต้อง
  • หากใช้ใบรับรองที่ลงนามด้วยตนเอง การโคลนนิ่ง HTTPS จำเป็นต้องใช้ GIT_SSL_NO_VERIFY=true.

การเปิดใช้งาน SSL กับโดเมน

1. ชี้โดเมนของคุณไปยังที่อยู่ IP ของเซิร์ฟเวอร์

2. อัปเดตการตั้งค่า Gogs (/etc/gogs/conf/app.ini-

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

3. รีสตาร์ทบริการ Gogs เพื่อให้การเปลี่ยนแปลงมีผล:

systemctl restart gogs

3. แก้ไขไฟล์การตั้งค่า Nginx และแทนที่ทั้งสองส่วน server_name <IP>; ด้วยโดเมนของคุณ (<your-domain>สำหรับทั้งบล็อก HTTP (พอร์ต 80) และ HTTPS (พอร์ต 443):

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

4. ติดตั้ง Certbot:

apt install -y certbot python3-certbot-nginx

5. รันคำสั่งต่อไปนี้เพื่อสร้างใบรับรอง Let's Encrypt ที่ถูกต้อง:

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

6. แทนที่เส้นทาง SSL ในไฟล์การตั้งค่า Nginx:

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. รีสตาร์ท Nginx เพื่อให้การเปลี่ยนแปลงมีผล:

systemctl restart nginx

8. เปิดเบราว์เซอร์ของคุณและไปที่: https://yourdomain.com

รายละเอียดการสมัคร