diff --git a/troubleshooting/250907_gitea_https_clone_failure.md b/troubleshooting/250907_gitea_https_clone_failure.md index 2ec5ae9..da010cb 100644 --- a/troubleshooting/250907_gitea_https_clone_failure.md +++ b/troubleshooting/250907_gitea_https_clone_failure.md @@ -2,7 +2,7 @@ ## 작성일: 2025-09-07 ## 작성자: 51123 서버 관리자 -## 환경: Ubuntu 22.04, Gitea 1.x, nginx HTTP/2 +## 환경: Ubuntu 22.04, Gitea 1.23.8 (최신: 1.24.5), nginx HTTP/2 ## 문제 증상 HTTPS를 통한 Git 클론 시 TLS 패킷 디코딩 오류로 실패 @@ -65,9 +65,14 @@ listen 443 ssl; # http2 제거 ``` ### 근본 해결 -1. Gitea 버전 업그레이드 -2. Git을 OpenSSL 버전으로 재컴파일 -3. Gitea 설정에서 버퍼 크기 증가 +1. nginx 설정 최적화 + - client_max_body_size 512M 이상 설정 + - proxy 버퍼 크기 증가 +2. Git 버퍼 크기 증가 + ```bash + git config http.postBuffer 524288000 # 500MB + ``` +3. Gitea 설정에서 LFS 크기 증가 ```ini # /etc/gitea/app.ini [server] @@ -75,8 +80,9 @@ LFS_MAX_FILE_SIZE = 10485760 ``` ## 관련 이슈 -- Gitea GitHub Issue #xxxxx (TLS handshake 관련) +- Gitea Issue #10838: HTTP/2 PROTOCOL_ERROR (파일 크기 문제로 확인) +- nginx client_max_body_size 제한이 주요 원인 - Git GnuTLS vs OpenSSL 호환성 문제 ## 결론 -SSH 프로토콜 사용이 가장 안정적이며, HTTPS 클론은 Gitea 업그레이드 후 재검토 필요 \ No newline at end of file +SSH 프로토콜 사용이 가장 안정적이며, HTTPS 클론은 nginx/Git 버퍼 설정 조정으로 해결 가능 \ No newline at end of file