본문 바로가기

이 기기의 Yave 통합 계정 로그인이 끝나서, 이 기기에서 쓰던 다른 Yave 서비스도 함께 로그아웃돼요.

GitHub 저장소를 가져와 정적 사이트로 배포하는 법

마지막 업데이트: 2026-11-11

목차 · 6
  1. 1. 저장소가 조건에 맞는지 확인하세요
  2. 2. 첫 화면의 ‘GitHub에서 가져오기’를 누르세요
  3. 3. 주소를 정하고 ‘발행하기’를 누르세요
  4. 4. 저장소를 고친 뒤에는 새로 반영하세요
  5. 자주 묻는 질문
  6. 이어서 읽어 보세요

결론부터 — 첫 화면의 ‘GitHub에서 가져오기’ 카드에서 공개 저장소 주소(owner/repo)를 넣고 주소를 정해 ‘발행하기’를 누르세요. 저장소의 파일을 그대로 올려 발행하며, 빌드는 하지 않으니 저장소 맨 위에 index.html이 있어야 해요.

한눈에 보기

걸리는 시간
약 2분
필요한 요금제
무료로 가능
코드 지식
없어도 돼요
하는 곳
첫 화면의 올리기 카드

따라 하기

  1. 1

    저장소가 조건에 맞는지 확인하세요

    공개(public) 저장소여야 하고, 저장소 맨 위에 index.html이 있어야 해요. HTMLtoSITE는 빌드를 하지 않고 저장소의 파일을 그대로 올려요. React·Vite처럼 빌드가 필요한 프로젝트는 빌드 결과가 맨 위에 담긴 브랜치(예: gh-pages)를 쓰거나, 빌드 결과 폴더를 ZIP으로 올리세요. 비공개 저장소는 가져올 수 없어요.

    owner/repo
    index.htmlabout.htmlstyle.cssimages/logo.png
  2. 2

    첫 화면의 ‘GitHub에서 가져오기’를 누르세요

    htmltosite.com 첫 화면의 세 카드 중 ‘GitHub에서 가져오기’(‘저장 공간 주소만 넣으면 돼요’)를 누르면 같은 이름의 화면이 열려요. ‘저장소’ 칸에 owner/repo 또는 https://github.com/owner/repo 주소를 넣으세요. 브랜치나 태그를 쓰고 싶으면 ‘브랜치·태그 (선택)’ 칸에 적고, 비워 두면 기본 브랜치를 가져와요.

    HTMLtoSITE ‘GitHub에서 가져오기’ 화면 — 저장소 칸, 브랜치·태그(선택) 칸, 주소 칸, 발행하기 버튼
    ‘저장소’ 칸에 주소를 넣고, 필요하면 브랜치·태그를 적어요.
  3. 3

    주소를 정하고 ‘발행하기’를 누르세요

    주소 칸에 이름을 적고 ‘발행하기’를 누르면 가져오기부터 발행까지 한 번에 끝나요. 처음이라면 이메일 하나로 가입하는 화면이 나오고, 돌아오면 적어 둔 주소와 저장소는 그대로 남아 있어요. 끝나면 ‘발행했어요’ 화면에 주소가 떠요. 가져오지 못한 파일이 있으면 ‘N개 파일은 올리지 못했어요’ 안내가 함께 보여요.

    myname.html2site.com 발행됨

    저장소의 파일이 이 주소로 열려요.

  4. 4

    저장소를 고친 뒤에는 새로 반영하세요

    가져오기는 그 순간의 파일을 복사해 오는 일이라, 가져온 뒤에는 저장소와 이어지지 않아요. 바뀐 내용은 편집기에서 직접 고치거나, 바뀐 폴더를 ZIP으로 올려 반영한 다음 ‘발행하기’를 누르세요. 발행할 때마다 버전이 남아서 ‘버전’ 탭에서 이전 모습으로 되돌릴 수 있어요.

    HTMLtoSITE 편집기의 버전 탭 — 발행한 버전 목록
    버전 탭에서 이전에 발행한 모습으로 되돌릴 수 있어요.

자주 묻는 질문

GitHub 계정을 연결하거나 서버·호스팅 계정이 필요한가요?

필요 없어요. 공개 저장소 주소만 넣으면 돼요. GitHub 로그인도, 서버도, 호스팅 계정도 없이 이메일 하나로 가입해(비밀번호·카드 없이) 무료로 시작해요.

비공개(private) 저장소도 가져올 수 있나요?

아니요, 공개 저장소만 가져와요. GitHub 계정 연결 없이 주소만으로 받아 오기 때문이에요. 비공개 저장소는 내 컴퓨터에 내려받아 ZIP으로 만든 뒤 ‘ZIP으로 올리기’로 올리세요.

React나 Vue처럼 빌드가 필요한 저장소도 되나요?

빌드는 하지 않아요. 저장소 맨 위에 index.html이 있는, 즉 빌드 결과가 올라가 있는 저장소나 브랜치만 돼요. 아니라면 내 컴퓨터에서 빌드한 결과 폴더를 ZIP으로 올리세요.

어느 브랜치를 가져오나요? 특정 브랜치나 태그는요?

‘브랜치·태그 (선택)’ 칸을 비워 두면 저장소의 기본 브랜치를 가져와요. 다른 브랜치나 태그 이름을 적으면 그 시점의 파일을 가져와요. github.com/owner/repo/tree/브랜치 주소를 그대로 붙여 넣어도 돼요.

저장소를 고치면 사이트도 자동으로 바뀌나요?

아니요, 가져온 뒤에는 저장소와 이어지지 않아요(자동 배포가 아니에요). 바뀐 내용은 편집기에서 고치거나 ZIP으로 다시 올린 뒤 발행하세요.

저장소가 크거나 가져오기에 실패하면 어떻게 하나요?

무료는 사이트 5개, 저장 공간 100MB까지이고, 저장소는 요금제의 남은 저장 용량 안에서 파일 2,000개까지 가져와요. .git 같은 숨김 파일과 서버 코드·실행 파일은 빠지고, README.md 같은 문서도 ‘올리기 보호’로 빠져 안내에 떠요. 사이트에는 영향이 없어요. GitHub가 요청을 제한하면 잠시 뒤 다시 시도하거나 ZIP으로 올리세요.

읽는 것보다 해 보는 게 빨라요 — 가진 HTML을 붙여 넣고 바로 발행해 보세요.

지금 워크스페이스의 사이트를 찾아요. 다른 워크스페이스는 사이드바 맨 위에서 바꿔 주세요.