โกกส์

เข้าถึง

• เปิด browser และไปที่: https://<SERVER_IP>
• คาดว่าจะมีคำเตือน SSL ของ browser (self-signed certificate)
• ลงทะเบียนบัญชีใหม่
• บัญชีแรกที่ลงทะเบียนจะกลายเป็นผู้ดูแลระบบ

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

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

1. แก้ไขไฟล์การกำหนดค่า: /etc/gogs/conf/app.ini

2. ภายใต้ [auth] ส่วนการเปลี่ยนแปลง: DISABLE_REGISTRATION = false to 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
• บริการระบบ: /etc/systemd/system/gogs.service
• Nginx config: /etc/nginx/sites-available/gogs.conf
• ใบรับรอง TLS: /etc/nginx/ssl/

การใช้งานคอมไพล์

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

งิงซ์:

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 in /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 ของ server

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 (port 80) และ HTTPS (port 443) blocks:

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