From 7abdd474acc264b4f224d27c512cd6cac31f3c02 Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@naver.com>
Date: Sun, 7 Sep 2025 21:49:51 +0900
Subject: [PATCH] =?UTF-8?q?fix:=20Gitea=20HTTPS=20=ED=81=B4=EB=A1=A0=20?=
 =?UTF-8?q?=ED=8A=B8=EB=9F=AC=EB=B8=94=EC=8A=88=ED=8C=85=20=EB=AC=B8?=
 =?UTF-8?q?=EC=84=9C=20=EC=A0=95=ED=99=95=EB=8F=84=20=EA=B0=9C=EC=84=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Gitea 1.24.x HTTP/2 버그 수정 관련 잘못된 정보 제거
- 실제 원인인 nginx/Git 버퍼 크기 문제로 수정
- Gitea Issue #10838 참조 추가
---
 .../250907_gitea_https_clone_failure.md        | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

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