마인드팡GitHub에 코드를 올리다 막히는 곳은 대부분 세 군데입니다. 100MiB가 넘는 파일은 푸시가 거부되고, Git 명령에서는 계정 암호 대신 토큰을 넣어야 하며, 코드를 기여하는 계정은 2단계 인증을 켜지 않으면 접속이 막힙니다.
GitHub 파일 크기 제한
GitHub는 파일 하나의 크기를 단계별로 제한합니다.
| 구분 | 내용 |
|---|---|
| 50MiB 초과 | 푸시는 되지만 경고 표시 |
| 100MiB 초과 | 푸시 차단 |
| 브라우저 업로드 | 파일당 25MiB까지 |
| Git LFS(무료) | 파일당 2GB까지 |
| 릴리스 첨부 파일 | 파일당 2GiB 미만, 최대 1000개 |
| 저장소 전체 | 1GB 미만 이상적, 5GB 미만 권장 |
큰 설치 파일을 나눠 줘야 한다면 저장소에 커밋하지 말고 릴리스에 첨부합니다. 릴리스는 전체 용량과 대역폭에 제한이 없습니다.
GitHub 무료 플랜 한도
공개 저장소는 Actions 표준 러너가 무료이고, 비공개 저장소에는 월 할당량이 있습니다.
| 구분 | 내용 |
|---|---|
| Actions(비공개, Free) | 월 2,000분 |
| Actions(비공개, Pro) | 월 3,000분 |
| 아티팩트·Packages | Free 500MB(함께 씀) |
| Actions 캐시 | 저장소당 10GB |
| Git LFS(Free) | 저장공간 10GiB · 대역폭 10GiB |
| Pages | Free는 공개 저장소만 |
GitHub 2단계 인증과 토큰
Git 명령으로 푸시할 때 계정 암호는 더 이상 받지 않습니다. 암호를 묻는 칸에 개인용 액세스 토큰을 넣거나 SSH 키를 씁니다.
- 릴리스를 만들거나 패키지를 게시하는 등 기여 활동이 있는 계정은 2단계 인증이 의무입니다.
- 45일 등록 기간과 7일 유예가 지나면 켤 때까지 접속이 막힙니다.
- 1년 동안 쓰지 않은 토큰은 자동으로 지워집니다.
GitHub 계정 복구
2단계 인증 기기를 잃었다면 복구 코드가 가장 빠릅니다. 기본 파일 이름은 github-recovery-codes.txt 입니다.
- 로그인 화면의 ‘추가 옵션’에서 2FA 복구 코드를 입력합니다.
- 코드가 없으면 확인된 기기, SSH 키, 토큰으로 복구 요청을 냅니다.
- 모든 복구 수단을 잃으면 계정을 영영 못 찾을 수 있습니다.
GitHub를 쓰다 막히면 먼저 파일 크기를 보세요. 50MiB가 넘으면 경고, 100MiB가 넘으면 푸시가 거부되고 웹 업로드는 25MiB까지입니다. 큰 파일은 지워도 이전 커밋에 남아 있으면 계속 막히므로 기록에서 제거해야 하고, 배포용 파일은 커밋 대신 릴리스에 첨부하는 것이 공식 방법입니다. 무료 계정은 비공개 저장소에서 Actions 월 2,000분, 아티팩트와 Packages 합쳐 500MB, Git LFS 저장공간과 대역폭 각 10GiB를 쓰고, 결제 수단이 없으면 다 쓴 순간 사용이 막힙니다. Pages는 무료 플랜에서 공개 저장소에서만 켜집니다. Git 명령에는 계정 암호 대신 개인용 액세스 토큰을 넣고, 기여 계정은 2단계 인증을 켜야 하며, 복구 코드 파일은 기기와 다른 곳에 보관해 두세요.
