fix: Gitea HTTPS 클론 트러블슈팅 문서 정확도 개선

- Gitea 1.24.x HTTP/2 버그 수정 관련 잘못된 정보 제거
- 실제 원인인 nginx/Git 버퍼 크기 문제로 수정
- Gitea Issue #10838 참조 추가

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 버전 업그레이드
+1. nginx 설정 최적화
-2. Git을 OpenSSL 버전으로 재컴파일
+   - client_max_body_size 512M 이상 설정
-3. Gitea 설정에서 버퍼 크기 증가
+   - 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 업그레이드 후 재검토 필요
+SSH 프로토콜 사용이 가장 안정적이며, HTTPS 클론은 nginx/Git 버퍼 설정 조정으로 해결 가능