GitHub Pages 블로그를 구글 검색에 노출시키기

Wed, 01 Jul 2026 00:00:00 +0900

블로그를 만들어 배포하는 것으로 끝이 아니다. 사이트가 존재해도 구글이 그 존재를 모르면 검색으로는 아무도 찾아올 수 없다. GitHub Pages에 Hugo 사이트를 올린 상태에서 실제로 검색 노출까지 진행하며 한 일과, 그 과정에서 만난 함정을 정리한다.

검색에 뜨려면 무엇이 필요한가

블로그가 구글 검색 결과에 나타나려면 네 가지가 모두 갖춰져야 한다.

구글이 사이트의 존재를 알아야 한다 → Google Search Console에 등록
구글이 사이트를 크롤링할 수 있어야 한다 → robots.txt에 sitemap 링크
구글이 안에 무엇이 있는지 알아야 한다 → sitemap.xml 제출
구글이 페이지를 색인에 넣어야 한다 → 크롤링 대기 (3일~2주)

다행히 Hugo는 sitemap.xml을 기본으로 자동 생성하고, enableRobotsTXT = true만 켜 두면 robots.txt도 만들어 준다. 결국 실제로 손봐야 할 것은 몇 가지 SEO 보완과 Search Console 등록 정도다.

현재 상태 진단과 SEO 보완

먼저 배포된 사이트에서 세 가지가 정상인지 curl로 확인한다.

1
2
3
4
5
6
7
8


curl -sI "https://<도메인>/sitemap.xml"
# → HTTP 200, content-type: application/xml 이면 정상

curl -s "https://<도메인>/robots.txt"
# → User-agent: * 는 기본. Sitemap: 링크가 있는지 확인

curl -s "https://<도메인>/" | grep -oE '<meta [^>]*(description|og:|canonical)[^>]*>'
# → og:title, og:description, canonical 있는지 확인

Hugo + Stack 기본 구성이면 sitemap과 meta 태그는 이미 있지만, 두 가지가 빠져 있었다. robots.txt에 sitemap 링크가 없어서 구글이 사이트맵을 자동으로 발견하지 못하고, og:image가 없어서 검색 결과나 메신저 공유에서 썸네일이 뜨지 않는 문제다.

첫 번째는 layouts/robots.txt 파일을 만들어 해결한다. Hugo는 이 파일이 있으면 우선 사용한다.

1
2
3
4


User-agent: *
Allow: /

Sitemap: {{ "sitemap.xml" | absURL }}

absURL이 baseURL을 붙여 절대 경로로 렌더하므로 다중 도메인이나 리버스 프록시 환경에서도 안전하다.

두 번째는 hugo.toml의 defaultImage 블록을 활성화한다.

1
2
3
4
5


[params.defaultImage]
 [params.defaultImage.opengraph]
 enabled = true
 local = true
 src = "img/avatar.png"

local = true면 static/ 아래 경로를 그대로 쓴다. 개별 글에 cover 이미지가 있으면 그쪽이 우선하고, 없으면 이 기본값이 쓰인다.

Search Console 등록과 Sitemap 제출

Google Search Console에 로그인한 뒤 진행한다.

속성 추가 → URL 접두어를 선택하고 사이트 URL(예: https://<user>.github.io/)을 입력한다.
소유권 확인에서 HTML 파일 방식을 고르면 구글이 googleXXXX...html 파일을 준다.
이 파일을 블로그 프로젝트의 static/ 폴더에 그대로 두고 commit + push 한다.
GitHub Pages 배포가 끝나면 https://<도메인>/googleXXXX...html로 접근되는지 curl로 확인한다.
Search Console로 돌아와 확인 버튼을 누르면 “소유권이 확인됨"이 뜬다.

파일 내용은 google-site-verification: ... 한 줄뿐이다. 이 토큰 자체가 인증 역할을 하지만 저장소에 push해도 위험하지 않다. 다만 구글이 준 파일명과 내용은 이 사이트·이 계정 조합에서만 유효하다는 점만 기억하면 된다.

인증이 끝나면 왼쪽 메뉴 Sitemaps에서 입력란에 sitemap.xml만 넣고 제출한다. 처음에는 “가져올 수 없음"이 자주 뜨는데, 대부분 구글이 방금 등록된 속성을 캐시하는 중이거나 첫 fetch가 일시적으로 실패한 것이다. 12~48시간 기다리면 자동으로 재시도되어 “성공"으로 바뀐다. 급하면 사이트맵을 삭제 후 재제출해 강제로 다시 트리거할 수 있다.

우선 노출을 원하는 페이지가 있다면 상단 URL 검사 도구로 특정 URL을 넣고 색인 생성 요청을 할 수 있다. 홈(/), 대표·최신 글 몇 개, 핵심 카테고리 페이지 순으로 요청하면 몇 시간~~하루 안에 처리된다. 하루 요청 수 제한(10~~15개)이 있으니 중요한 URL부터, 한 URL당 한 번만 누른다.

노출까지의 시간차, 그리고 함정

세팅은 하루면 끝나지만, 실제 노출까지는 시간이 걸린다.

시점	상태
지금	`site:<도메인>` 검색 결과 0 (정상)
3~7일	홈과 대표 글 색인 시작 → 결과 1~5개
1~2주	대부분 페이지 색인 완료
이후	고유 이름(블로그 제목 등)부터 상위 노출 시작

진행 상황은 두 곳에서 볼 수 있다. 구글에서 site:<도메인>을 검색하면 색인된 페이지 수를 대략 파악할 수 있고, Search Console의 색인생성 → 페이지에서 “색인 생성됨/미생성” 개수를 정확히 확인할 수 있다.

겪은 함정은 모두 시간차에서 비롯된 것이었다.

인증 직후 URL 검사 색인 요청 실패: 시스템 반영에 시간이 필요하다. 30분~1시간 뒤 재시도하면 대부분 성공한다.
Sitemap 제출 직후 “가져올 수 없음”: 흔한 초기 현상. 기다리면 자동 재시도되어 “성공"으로 바뀐다.
site:<도메인> 결과 0: 세팅 문제가 아니라 아직 색인되지 않은 것뿐이다.

이 시간차를 미리 알고 있으면 조급해할 일이 없다. 파일 배치와 제출은 하루 안에 끝나고, 나머지는 구글의 스케줄대로 진행된다. 한 번 해 두면 이후로는 계속 자동으로 크롤링·색인되므로, 여유가 될 때 각 글에 개별 cover 이미지를 붙여 썸네일을 다양화하거나 Article 구조화 데이터(Structured Data)를 추가해 검색 스니펫을 더 다듬을 수 있다.

한 줄 정리

검색 노출 세팅 자체는 robots.txt·og:image 보완과 Search Console 등록·sitemap 제출로 하루면 끝나고, 나머지는 구글이 3일~2주에 걸쳐 크롤링·색인하기를 기다리는 시간차의 문제다.

코드 한 줄 없이, 0원으로 내 블로그 만들기 (GitHub Pages + Hugo)

Fri, 26 Jun 2026 00:00:00 +0900

“블로그 하나 갖고 싶은데, 서버비도 부담되고 코드는 무섭고…”

저도 그랬어요. 그런데 오늘 직접 해보니, 코드를 거의 짜지 않고도 단돈 0원으로 인터넷에 내 블로그를 띄울 수 있더라고요. 신기했던 마음 그대로, 누구나 따라 할 수 있게 차근차근 정리해 봤습니다. 천천히 같이 가봐요. 🙂

1. GitHub에 가입하고 ‘내 땅’ 만들기

먼저 GitHub에 가입했어요. 그리고 블로그 파일이 들어갈 저장소(폴더 같은 것)를 하나 만들었습니다.

여기서 딱 하나만 틀리지 않으면 돼요. 저장소 이름을 반드시 이렇게 지어야 합니다.

내사용자이름.github.io

이 형식을 지켜야만 무료 주소가 자동으로 켜지거든요. 점 하나, 철자 하나라도 다르면 안 돼요. 이게 가장 중요한 약속입니다.

2. 무료 발행 스위치 켜기 (GitHub Pages)

GitHub에는 Pages라는 고마운 기능이 있어요. 내 저장소에 올린 파일을 무료 웹사이트로 띄워 주는 서비스죠. 서버를 따로 빌릴 필요가 없으니, 그 유명한 “서버비 0원"이 여기서 나옵니다.

켜는 법도 간단했어요.

저장소 상단의 Settings(설정) 로 들어가서
왼쪽 메뉴에서 Pages 를 누르고
Source 를 GitHub Actions 로 바꿔 주기

마지막의 ‘GitHub Actions’가 핵심이에요. 이걸로 바꿔야 다음 단계의 Hugo가 자동으로 블로그를 지어 줍니다.

3. 진짜 블로그 엔진 얹기 (Hugo + 테마)

이제 글을 쓰면 예쁜 페이지로 만들어 줄 엔진을 올릴 차례예요. 저는 Hugo를 골랐습니다.

Hugo는 쉽게 말해, 글만 쓰면 블로그 페이지를 알아서 만들어 주는 도구예요. 저는 그냥 글을 적기만 하고, 보기 좋은 HTML 페이지로 바꾸는 건 Hugo가 다 해줍니다.

디자인은 직접 만들 필요도 없었어요. 이미 잘 만들어진 PaperMod라는 테마를 가져다 붙이니, 단숨에 깔끔한 블로그 모양이 갖춰지더라고요.

4. 깃허브에 올리기 — 그리고 만난 작은 함정

작업한 내용을 깃허브에 올리는 흐름은 두 단어로 정리돼요.

commit(커밋) — 변경한 내용을 저장하기
push(푸시) — 그 내용을 깃허브로 올려보내기

다만 여기서 한 번 막혔어요. 올리려는데 403 에러가 뜨더라고요. 알고 보니 컴퓨터에 다른 계정 정보가 저장돼 있어서 생긴 일이었어요. 저장된 정보를 제 계정으로 정리해 주니 깔끔하게 해결됐습니다. 혹시 같은 에러를 만나도 당황하지 마세요. 실력 문제가 아니라 그냥 계정 설정이 엇갈린 것뿐이에요.

5. 한 줄 정리

코드를 거의 짜지 않고도, GitHub Pages + Hugo + PaperMod 조합이면 0원으로 진짜 내 블로그를 띄울 수 있어요. 막히는 순간이 와도 그건 끝이 아니라 그냥 “다음에 물어볼 차례"일 뿐이고요. 오늘 첫 발을 뗀 당신, 이미 절반은 온 거예요. 👏

GitHub Pages on Physical AI 드림팀