곡스

입장

• 브라우저를 열고 방문하세요: https://<SERVER_IP>
• 브라우저 SSL 경고가 예상됩니다 (자체 서명 인증서)
• 새 계정 등록
• 처음 등록된 계정이 관리자가 됩니다.

자가 등록 비활성화(선택 사항)

기본적으로 사용자 자가 등록은 활성화되어 있습니다.

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 설정: /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

포스트그레SQL:

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로 지정하세요.

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. Nginx 구성에서 SSL 경로를 교체합니다.

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