USB 파일을 GitHub에 업로드하는 완벽 가이드

📦 USB 파일을 GitHub에 업로드하는 완벽 가이드

🎯 이런 분들을 위한 가이드입니다

• USB나 로컬 폴더에 있는 많은 파일을 GitHub에 올리고 싶은 분
• Git을 처음 사용하거나 명령어가 익숙하지 않은 분
• 실제 사례를 통해 단계별로 배우고 싶은 분

실전 사례: 3,327개의 HTML 파일(약 99MB)을 GitHub에 성공적으로 업로드한 실제 과정을 공유합니다.

📋 1단계: 사전 준비

1 Git 설치 확인

명령 프롬프트(CMD) 또는 터미널을 열고 다음 명령어를 입력합니다:

git --version

✅ 정상 출력 예시:
git version 2.43.0.windows.1

⚠️ Git이 설치되어 있지 않다면?
https://git-scm.com에서 다운로드하여 설치하세요.

2 GitHub 계정 및 저장소 생성

1. GitHub.com에 접속하여 회원가입 (무료)
2. 우측 상단 + 버튼 → New repository 클릭
3. 저장소 이름 입력 (예: my-project)
4. Create repository 클릭
5. 생성된 저장소의 URL 복사 (예: https://github.com/사용자명/저장소명.git)

🚀 2단계: 파일 업로드 실행

1 작업 폴더로 이동

업로드할 파일이 있는 폴더로 이동합니다:

cd C:\Users\사용자명\내폴더\업로드할폴더

💡 팁: 폴더 경로를 모른다면?

• Windows: 탐색기에서 폴더를 연 후 주소창의 경로를 복사
• 또는 폴더에서 마우스 우클릭 → "터미널에서 열기" (Windows 11)

2 Git 저장소 초기화

git init

✅ 성공 메시지:
Initialized empty Git repository in C:/Users/사용자명/내폴더/.git/

이 명령어는 현재 폴더를 Git이 관리하는 저장소로 만듭니다. 숨김 폴더 .git이 생성됩니다.

3 GitHub 원격 저장소 연결

git remote add origin https://github.com/사용자명/저장소명.git

origin은 원격 저장소의 별칭입니다. GitHub 저장소와 로컬 폴더를 연결하는 단계입니다.

4 파일 스테이징 (추가)

git add .

.은 "현재 폴더의 모든 파일"을 의미합니다. 이 명령어로 업로드할 파일을 준비합니다.

⚠️ 주의: 파일이 많으면 시간이 걸릴 수 있습니다. 3,000개 이상의 파일은 1~2분 소요될 수 있습니다.

5 커밋 (변경사항 저장)

git commit -m "Add initial files from USB"

✅ 성공 메시지 예시:
3327 files changed, 50000 insertions(+)
create mode 100644 파일명1.html
create mode 100644 파일명2.html
...

-m 뒤의 메시지는 변경 내용 설명입니다. 나중에 어떤 작업을 했는지 알 수 있습니다.

6 브랜치 이름 설정

git branch -M main

기본 브랜치 이름을 main으로 설정합니다. (GitHub의 표준)

7 GitHub에 업로드 (Push)

git push -u origin main

드디어 파일을 GitHub로 업로드합니다!

⚠️ 인증 필요: 처음 push할 때는 GitHub 로그인이 필요합니다.

• 브라우저 창이 자동으로 열리면 GitHub에 로그인
• 또는 Personal Access Token을 생성하여 비밀번호 대신 입력

✅ 업로드 성공 메시지:
Enumerating objects: 3500, done.
Counting objects: 100% (3500/3500), done.
Compressing objects: 100% (3400/3400), done.
Writing objects: 100% (3500/3500), 99.12 MiB | 5.00 MiB/s, done.
Total 3500 (delta 100), reused 0 (delta 0)

⚠️ 3단계: 문제 해결 (트러블슈팅)

문제 1: "fatal: remote origin already exists"

에러 메시지:
fatal: remote origin already exists.

해결 방법: 기존 연결을 제거하고 다시 추가

git remote remove origin git remote add origin https://github.com/사용자명/저장소명.git

문제 2: "Updates were rejected"

에러 메시지:
! [rejected] main -> main (non-fast-forward)

원인: GitHub 저장소에 이미 파일이 있을 때 (README.md 등)

해결 방법 1: 병합(Merge)하기

git pull origin main --allow-unrelated-histories

⚠️ Vim 에디터가 나타날 수 있습니다

1. ESC 키를 누릅니다
2. :wq를 입력합니다
3. Enter를 누릅니다

이렇게 하면 병합 메시지를 저장하고 나갑니다.

그 다음 다시 push:

git push -u origin main

해결 방법 2: 강제 푸시 (주의: 기존 GitHub 내용 삭제됨)

git push -u origin main --force

문제 3: 파일이 너무 커서 업로드 실패

에러 메시지:
remote: error: File 큰파일.zip is 150.00 MB; this exceeds GitHub's file size limit of 100.00 MB

해결 방법:

1. 100MB 이상 파일은 GitHub에 업로드할 수 없습니다
2. Git LFS(Large File Storage) 사용
3. 또는 파일을 나누거나 압축

✅ 4단계: 업로드 확인

1. GitHub 저장소 페이지로 이동: https://github.com/사용자명/저장소명
2. 파일 목록이 보이는지 확인
3. 커밋 메시지와 날짜 확인

✅ 성공! 모든 파일이 GitHub에 안전하게 저장되었습니다.

📊 실전 통계: 3,327개 파일 업로드 사례

항목	내용
파일 개수	3,327개
총 용량	99,127,739 bytes (약 94.5MB)
파일 형식	HTML
소요 시간	약 5~10분 (네트워크 속도에 따라 다름)
업로드 속도	평균 5~10 MB/s

💡 추가 팁

1. .gitignore 파일 활용

업로드하고 싶지 않은 파일이 있다면 .gitignore 파일을 생성하세요:

# .gitignore 파일 내용 *.log *.tmp node_modules/ .env 비밀번호.txt

2. 대용량 파일이 많다면?

• Git LFS 사용 권장
• 또는 여러 저장소로 나누기
• 클라우드 스토리지(Google Drive, Dropbox) 병행 사용

3. 정기적인 백업

주기적으로 변경사항을 커밋하고 push하면 자동 백업이 됩니다:

git add . git commit -m "Update files - 2024-12-24" git push

🎓 주요 명령어 정리

명령어	설명
git init	Git 저장소 초기화
git add .	모든 파일 스테이징
git commit -m "메시지"	변경사항 커밋
git remote add origin URL	원격 저장소 연결
git push -u origin main	GitHub에 업로드
git pull origin main	GitHub에서 다운로드
git status	현재 상태 확인
git log	커밋 기록 확인

🔗 다음 단계: GitHub Pages로 웹사이트 만들기

HTML 파일을 업로드했다면 GitHub Pages를 활용해 무료 웹사이트로 만들 수 있습니다:

1. 저장소 설정 페이지로 이동
2. 좌측 메뉴에서 Pages 선택
3. Source를 main 브랜치로 설정
4. Save 클릭
5. 몇 분 후 https://사용자명.github.io/저장소명에서 확인

🎉 축하합니다!
USB의 파일을 성공적으로 GitHub에 업로드했고, 이제 어디서든 접근할 수 있습니다. 버전 관리도 가능하고, 협업도 가능하며, 웹사이트로도 만들 수 있습니다!

📚 참고 자료

• Git 공식 문서
• GitHub 공식 문서
• GitHub Pages 가이드

---

이 가이드가 도움이 되셨다면 댓글로 알려주세요! 😊
궁금한 점이 있으시면 언제든 질문해주세요.