← 가이드 목록

내보낸 포트폴리오를 GitHub Pages에 무료로 배포하기

Portfolio Maker에서 폴더 ZIP으로 내보냈다면, GitHub Pages로 5분 안에 공개 주소를 만들 수 있습니다. 비용은 0원이고, 별도 서버 지식도 필요 없습니다.

1. GitHub 저장소 만들기

  1. github.com에 로그인 → 우측 상단 + → New repository
  2. 이름은 자유롭게 (예: my-portfolio) → Public 선택 → Create

2. ZIP 내용물 업로드

  1. 받은 ZIP의 압축을 풉니다
  2. 저장소 화면에서 uploading an existing file 클릭
  3. 압축 푼 폴더 안의 내용물 전체(index.html, assets, effects…)를 끌어다 놓기 → Commit
⚠️ 흔한 실수: 폴더째 올리면 주소 뒤에 폴더명이 하나 더 붙습니다. index.html이 저장소 최상위에 오도록 내용물만 올리세요.

3. Pages 켜기

  1. 저장소 Settings → Pages
  2. Source를 Deploy from a branch, 브랜치 main + / (root) 선택 → Save
  3. 1~2분 뒤 https://아이디.github.io/저장소명/ 주소가 생깁니다

3D 효과가 안 보인다면

내려받은 ZIP을 더블클릭(file://)으로 열면 3D가 차단됩니다 — 브라우저가 ES 모듈을 로컬 파일에서 막기 때문입니다. GitHub Pages처럼 서버로 열면 정상 동작합니다. 로컬에서 미리 보고 싶다면 폴더에서 python -m http.server를 실행하세요.

다음 단계

github.io 주소 대신 나만의 주소를 쓰고 싶다면 → 내 도메인 연결하기