GitHub Pages 사이트가 Google에 나오지 않는 이유와 해결 방법

확인할 순서

1. 새 사이트인가요? 새 github.io 사이트는 다른 사이트의 링크가 거의 없어서 Google이 아직 모를 수 있습니다. Google에서 site: 뒤에 도메인을 붙여 검색하세요. 예: site:example.com. 아무것도 나오지 않으면 Google에 아직 페이지가 없을 가능성이 큽니다. 페이지별 정확한 답은 Search Console의 URL 검사가 줍니다.
2. 사이트가 빌드되지 않거나 주소가 바뀌었나요? Pages는 게시 소스 최상위에 소문자 index.html이 필요합니다. 저장소를 공개와 비공개 사이에서 바꾸면 사이트 주소가 바뀝니다. 홈페이지가 404면 Google은 아무것도 보지 못합니다.
3. 레이아웃에 noindex 태그가 있나요? 레이아웃의 <head>에서 <meta name="robots" content="noindex">를 찾아 찾게 할 페이지에서 지우세요.
4. robots.txt가 잘못된 곳에 있나요? Google은 호스트 최상위의 robots.txt만 읽습니다. username.github.io/repo 프로젝트 사이트라면 Google은 저장소의 파일이 아니라 username.github.io/robots.txt를 읽습니다.
5. 사이트맵이나 Search Console 속성이 없나요? _config.yml의 plugins 목록에 jekyll-sitemap을 넣으세요. GitHub Pages가 지원하며 /sitemap.xml을 만듭니다. Search Console에 사이트 주소의 URL 접두어 속성을 추가하고 HTML 태그나 파일로 확인한 뒤 사이트맵을 제출하세요.
6. 페이지 내용이 적나요? README를 한 페이지 사이트로 바꾼 것은 Google이 보여 줄 것이 적습니다. 질문 하나에 끝까지 답하는 페이지를 더하세요.
7. 사이트로 가는 링크가 적나요? 저장소의 About 항목과 README에 사이트 주소를 넣고, 프로필과 다른 프로젝트에서도 링크하세요.

일부 페이지만 빠질 때: GitHub Pages에서 가장 흔한 이유 세 가지

발견됨 - 현재 색인이 생성되지 않음

새 github.io 사이트는 외부 링크가 적어서 Google이 방문을 미룹니다. Search Console에 사이트맵을 제출하고 저장소 README와 About에서 사이트로 링크하세요. 자세한 가이드

크롤링됨 - 현재 색인이 생성되지 않음

README나 몇 줄의 Markdown으로 만든 짧은 페이지는 Google이 보여 줄 것이 적습니다. 페이지마다 질문 하나에 끝까지 답하고 홈페이지에서 링크하세요. 자세한 가이드

찾을 수 없음(404)

대문자가 들어간 Index.html, 옮긴 저장소, 새 빌드 없이 바꾼 맞춤 도메인이 주소를 깨뜨립니다. 시작 파일 이름을 index.html로 하고, 도메인을 바꾼 뒤 커밋을 푸시해 다시 빌드하고, 정말 없어진 주소용 404.html 페이지를 더하세요. 자세한 가이드

사이트맵 위치

GitHub Pages는 기본으로 사이트맵을 만들지 않습니다. Jekyll이라면 _config.yml의 plugins 목록에 jekyll-sitemap을 넣으면 /sitemap.xml이 만들어집니다. 다른 생성기라면 워크플로에서 사이트맵을 만드세요.

# _config.yml
plugins:
  - jekyll-sitemap

CrawlCoach로 확인하기

GitHub Pages 문서 사이트의 어느 페이지가 Google에 들어갔는지 보려면 Google 계정으로 로그인하세요. CrawlCoach가 최대 500개 페이지를 무료로 확인하고 빠진 페이지마다 해결 방법을 알려 드립니다.

자주 묻는 질문

출처

2026년 10월 8일에 확인했습니다. Google은 Search Console과 도움말을 가끔 바꿉니다. 화면이 다르게 보이면 출처를 확인하세요.

• GitHub 문서: GitHub Pages란?
• GitHub Docs: About GitHub Pages and Jekyll(영어)
• GitHub Pages: Dependency versions(영어)
• GitHub Docs: Troubleshooting 404 errors for GitHub Pages sites(영어)
• GitHub Docs: About custom domains and GitHub Pages(영어)
• Google: Google에서 robots.txt 사양을 해석하는 방법
• Search Console 도움말: Search Console에 웹사이트 또는 플랫폼 속성 추가하기