UtilityNest
GitHub logo

깃허브 파일 용량 제한

깃허브 웹사이트에서 올리는 파일은 25MiB 미만이어야 해요. Git 푸시는 50MiB에서 경고, 100MiB가 넘으면 막혀요. 더 큰 파일은 Git LFS를 쓰세요.

25MB 2026-11-08 확인
예시로 보기:

한도 정리

항목한도
브라우저 업로드파일당 25MiB
Git 푸시파일 하나 기준.50MiB 경고, 100MiB 차단
릴리스파일당 2GiB
저장소한 번에 푸시할 수 있는 크기는 2GB예요.1GB 이하가 이상적, 5GB 미만 강력 권장

파일이 들어오는 길마다 한도가 달라요

깃허브에는 업로드 한도가 하나만 있는 게 아니에요. 파일을 어떤 경로로 넣느냐에 따라 걸리는 숫자가 완전히 달라요.

  • 브라우저에서 Add file, Upload files: 파일당 25MiB, 한 번에 100개까지.
  • 명령줄 git push: 50MiB부터 경고, 100MiB가 넘는 파일은 차단. 푸시 한 번의 크기도 2GB에서 막혀요.
  • Git LFS: 요금제별 파일당 최대값이 달라요. Free와 Pro 2GB, Team 4GB, Enterprise Cloud 5GB.
  • 릴리스 첨부: 릴리스 하나에 파일 1000개까지, 파일마다 2GiB 미만. 전체 크기와 다운로드 트래픽 제한은 없어요.
  • 이슈, PR, 토론 댓글: 이미지와 GIF 10MB, 동영상은 무료 요금제 10MB·유료 요금제 100MB, 그 밖의 파일 25MB.

저장소 크기는 벽이 아니라 권장선이에요

깃허브는 저장소를 1GB 아래로, 적어도 5GB 아래로 유지하라고 강하게 권해요. 저장소 한도 문서에는 디스크 크기(압축된 .git 폴더) 10GB가 권장 최대치로 나와 있어요. 넘는다고 바로 막히는 건 아니고, 시스템에 부담을 주는 저장소는 깃허브 지원팀에서 조치를 요청하는 메일을 받을 수 있어요. 실제로 강제되는 숫자는 객체 하나 100MB와 푸시 한 번 2GB예요.

Git은 모든 파일의 모든 버전을 영원히 기억해요. 40MB 동영상을 커밋했다가 지워도 히스토리에는 남아 있어서, 누가 클론할 때마다 다시 내려받아요.

README 이미지가 조용히 무거워지는 곳

README 스크린샷은 25MiB에 걸릴 일은 없지만, 방문자 모두가 내려받고 클론에도 전부 들어가요. 깃허브는 마크다운 같은 파일의 서식 미리 보기를 보통 2MB 미만일 때 시도한다고 안내해요. 프로젝트 페이지를 가볍게 두는 습관이에요.

  • 큰 PNG 스크린샷은 /convert-to-webp 로 바꾸세요. 요즘 브라우저는 모두 WebP를 보여 줘요.
  • 꼭 PNG로 둬야 하면 /compress-image 로 줄이세요.
  • 4K 바탕화면 전체 대신 /crop-image 로 필요한 부분만 잘라 쓰세요.
  • 움직이는 데모는 GIF가 금방 커져요. 이슈나 README 댓글에 올린 짧은 MP4가 같은 GIF보다 훨씬 작은 경우가 많아요.
  • 디자인 원본, 동영상, 설치 파일은 일반 커밋 대신 릴리스나 Git LFS에 두세요.

이미 푸시가 거부됐다면

큰 파일이 아직 푸시하지 않은 마지막 커밋에 있다면, 깃허브 안내대로 git rm --cached 로 빼고 git commit --amend -CHEAD 로 커밋을 고친 뒤 다시 푸시하세요. 파일을 지우는 새 커밋만으로는 안 돼요. 이전 커밋에 여전히 남아 있으니까요. 더 예전에 들어간 파일이라면 git filter-repo 로 히스토리를 다시 쓰라고 권해요. 이 작업은 파일을 영구히 지우니 저장소 밖에 백업부터 해 두세요.

직접 해 봤어요: README용 전체 화면 PNG 스크린샷 변환

사이드바, 코드 글자, 색 패널이 있는 2560 x 1600 PNG(이미 PNG 최적화 저장)를 만들어, 헤드리스 크롬에서 /convert-to-webp 기본 화질 80, 크기 줄이기 없이 변환했어요.

파일 용량434.3KB (444,755바이트)291.6KB (298,572바이트)
픽셀2560 x 16002560 x 1600
줄어든 비율33%
걸린 시간변환 버튼 누르고 1초 미만

한 장에 3분의 1이면 작아 보여도, 이런 스크린샷이 여덟 장인 README라면 방문자마다 1MB 넘게 아껴요. '큰 이미지 줄이기'를 1920픽셀로 켜면 더 줄고, README 칸은 어차피 2560픽셀을 다 보여 주지 않아요.

자주 보는 오류와 해결법

브라우저 업로드가 파일을 거부해요

웹에서 추가하는 파일은 파일당 25MiB까지예요.

명령줄 Git으로 푸시하거나(100MiB까지) 릴리스에 첨부하세요.

푸시가 거부되고 100MiB 넘는 파일 이름이 나와요

일반 Git에서는 100MiB가 넘는 파일을 막아요.

커밋 히스토리에서 파일을 빼고 Git LFS로 관리하거나 릴리스 첨부로 배포하세요.

큰 파일 경고가 뜨지만 푸시는 성공해요

50MiB가 넘는 파일이라 경고만 한 거예요.

저장소가 더 커지기 전에 Git LFS로 옮기는 걸 고려하세요.

이슈에 동영상이 안 붙어요

동영상은 무료 요금제 10MB, 유료 요금제 100MB까지예요.

/compress-video 로 줄이거나 /trim-video 로 잘라 내세요.

자주 묻는 질문

MiB와 MB는 같은 건가요?

조금 달라요. 깃허브는 브라우저와 푸시 한도를 MiB로 적는데, 1MiB는 1,048,576바이트예요. 그래서 25MiB는 약 2,620만 바이트예요.

릴리스 파일도 저장소 크기에 들어가나요?

깃허브는 큰 바이너리를 저장소에 커밋하지 말고 릴리스로 배포하라고 권하고, 릴리스 전체 크기는 제한하지 않아요.

이미지 300장 폴더를 브라우저로 한 번에 올릴 수 있나요?

브라우저로는 한 번에 100개까지라서 나눠 올리거나 Git으로 푸시하세요.

무료 계정의 Git LFS 파일 최대 크기는요?

GitHub Free는 파일당 2GB예요.

이 글에서 확인한 자료

한도에 맞추기

버튼을 누르면 이 한도가 미리 입력된 도구가 열려요. 파일은 브라우저 안에서만 처리돼요.

알아 두면 좋아요

  • README 스크린샷은 500KB 이하 PNG나 WebP로 줄여야 페이지가 빨라요.
  • 디자인 파일과 동영상은 커밋 대신 릴리스나 Git LFS에 두세요.

출처

  • GitHub Docs: About large files on GitHub 공식 페이지
  • 2026-11-08에 확인했어요. 한도는 바뀔 수 있으니, 수치가 달라 보이면 도구 페이지의 문제 신고 버튼으로 알려 주세요.

다른 클라우드·업무 도구 한도