GitHub Pages에 내 도메인을 연결하는 방법
짧은 답
GitHub Pages에 내 도메인을 연결하려면 저장소의 Settings > Pages에서 Custom domain에 도메인을 입력하고 Save를 눌러요. 그다음 DNS에 www를 <user>.github.io로 보내는 CNAME 레코드를 추가하거나, 루트 도메인이면 A 레코드 4개를 추가해요. Convika 무료 요금제도 내 도메인을 연결해 주고, 폼과 90일 치 방문자 통계가 함께 있어요.
무료 요금제: 카드 필요 없음, 내 도메인 1개, 게시 중인 페이지 1개, 한 달에 폼 응답 50건 표시.
이 페이지의 내용
GitHub Pages 사이트에 내 도메인을 연결하려면 저장소의 ‘Settings > Pages’를 열고, ‘Custom domain’에 도메인을 입력한 뒤 ‘Save’를 눌러요. 그다음 DNS 업체에서 DNS 레코드를 추가해요. www를 <user>.github.io로 보내는 CNAME 레코드 하나, 또는 루트 도메인 example.com이면 A 레코드 4개예요. DNS 변경이 퍼지는 데는 최대 24시간이 걸리고, 그 뒤에 ‘Enforce HTTPS’를 선택해요.
아래 단계와 DNS 값은 모두 GitHub 문서에서 가져왔고, 2026년 11월 17일에 읽었어요. GitHub 화면은 영어로만 나와서 버튼 이름은 영어 그대로 적었어요.
GitHub Pages에 필요한 DNS 레코드
| 내 도메인 | 레코드 종류 | 이름 | 값 |
|---|---|---|---|
www.example.com | CNAME | www | <user>.github.io 또는 <organization>.github.io |
blog.example.com 같은 다른 서브도메인 | CNAME | blog | <user>.github.io 또는 <organization>.github.io |
루트 도메인 example.com | A (4개 모두 추가) | @ | 185.199.108.153, 185.199.109.153, 185.199.110.153, 185.199.111.153 |
| 루트 도메인, IPv6 포함 | AAAA (A 레코드와 함께 4개 모두 추가) | @ | 2606:50c0:8000::153, 2606:50c0:8001::153, 2606:50c0:8002::153, 2606:50c0:8003::153 |
| 루트 도메인, DNS 업체가 ALIAS나 ANAME을 지원할 때 | A 레코드 대신 ALIAS 또는 ANAME | @ | <user>.github.io 또는 <organization>.github.io |
GitHub 문서의 규칙 가운데 다음 세 가지를 알면 시간을 가장 많이 아껴요.
- CNAME 값에는 저장소 이름이 들어가지 않아요. GitHub는 프로젝트 사이트라도 레코드가 항상 저장소 이름 없이
<user>.github.io나<organization>.github.io를 가리켜야 한다고 해요. - DNS를 건드리기 전에 GitHub에 도메인을 먼저 추가해요. GitHub는 DNS를 먼저 설정하면 다른 사람이 내 서브도메인에 사이트를 올릴 수 있다고 경고해요.
- 와일드카드 레코드는 쓰지 않아요. GitHub는
*.example.com을 쓰지 말라고 강하게 권해요. 도메인을 빼앗길 위험이 바로 생기기 때문이에요.
5단계로 내 도메인 연결하기
계정에서 도메인 확인하기
GitHub는 저장소에 추가하기 전에 도메인을 먼저 확인하라고 권해요. 프로필 사진을 누르고 ‘Settings’, 사이드바의 ‘Pages’, ‘Add a domain’을 차례로 눌러요. 도메인을 입력하고 ‘Add domain’을 선택한 뒤, GitHub가 보여 주는 TXT 레코드를 만들어요. 이름은 _github-pages-challenge-USERNAME.example.com 형태예요. 레코드가 반영되면 ‘Verify’를 눌러요. TXT 레코드는 지우지 마세요. 그래야 도메인이 확인된 상태로 남고, 다른 GitHub 계정이 그 도메인이나 바로 아래 서브도메인에 사이트를 게시할 수 없어요.
저장소에 도메인 추가하기
사이트의 저장소에서 ‘Settings’를 누르고, “Code, planning, and automation” 아래의 ‘Pages’를 눌러요. ‘Custom domain’에 www.example.com이나 example.com을 입력하고 ‘Save’를 눌러요. 브랜치에서 게시하는 사이트라면 소스 브랜치의 맨 위에 CNAME 파일을 추가하는 커밋이 만들어져요. GitHub Actions 워크플로로 게시하는 사이트라면 CNAME 파일이 만들어지지 않고, 필요하지도 않아요.
DNS 레코드 추가하기
DNS 업체에서 위 표의 레코드를 추가해요. 서브도메인이면 CNAME 하나, 루트 도메인이면 A 레코드 4개예요. 업체가 같은 이름에 기본 레코드를 넣어 두었다면 먼저 지워요. GitHub는 루트 도메인과 함께 www도 설정하라고 권해요. 둘 다 설정하면 GitHub Pages가 한쪽에서 다른 쪽으로 리디렉션해요.
레코드 확인하기
DNS 변경에는 최대 24시간이 걸려요. 터미널에서는 이렇게 확인해요.
dig www.example.com +nostats +nocomments +nocmd
dig example.com +noall +answer -t A
첫 번째는 <user>.github.io로 가는 CNAME을, 두 번째는 A 레코드 4개를 보여 줘요. Windows에는 dig가 없으니 PowerShell의 Resolve-DnsName을 쓰세요.
Enforce HTTPS 켜기
‘Settings > Pages’로 돌아가 ‘Enforce HTTPS’를 선택해요. DNS 확인이 통과되면 GitHub가 알아서 Let's Encrypt에 인증서를 요청하고, 끝나면 도메인 옆에 체크 표시가 나와요. 이 옵션을 선택할 수 있게 되기까지 최대 24시간이 걸릴 수 있어요.
www, 루트 도메인, 아니면 둘 다
GitHub는 루트 도메인을 쓰더라도 항상 www 서브도메인을 쓰라고 권해요. www 서브도메인은 GitHub 서버의 IP 주소가 바뀌어도 영향을 받지 않기 때문이에요. 방문자에게 보여 줄 쪽을 내 도메인으로 정하고, DNS 레코드는 양쪽 모두 추가해요.
- 내 도메인을
www.example.com으로 하고 루트 도메인의 A 레코드도 추가하면,example.com이www.example.com으로 리디렉션돼요. - 내 도메인을
example.com으로 하고www의 CNAME도 추가하면,www.example.com이example.com으로 리디렉션돼요.
사용자 사이트나 조직 사이트에 연결한 도메인은 그 계정의 프로젝트 사이트에도 적용돼요. 사용자 사이트가 www.octocat.com이면 저장소 octo-project는 www.octocat.com/octo-project에서 열려요.
GitHub Pages에 연결한 도메인이 안 될 때 고치는 방법
- 배포하고 나면 도메인 설정이 사라져요. 게시 브랜치에 force push하는 빌드가
CNAME파일을 덮어써요. 파일을 소스에 넣어 두어 빌드마다 포함되게 하세요. 파일 이름은 모두 대문자이고, 안에는 도메인 하나만 들어가요. - “Domain is already taken”이 나와요. 다른 저장소가 그 도메인을 쓰고 있어요. 내 계정에서 도메인을 확인하면 다른 사용자의 사이트에서 도메인이 풀려요. 또는 다른 저장소의 ‘Custom domain’에서 ‘Remove’를 눌러요.
- Enforce HTTPS가 비활성 상태이거나 “Certificate not yet created”가 나와요. HTTPS는 도메인을 설정한 뒤 최대 한 시간이 걸릴 수 있어요. 멈춰 있으면 도메인 옆의 ‘Remove’를 누르고, 도메인을 다시 입력한 뒤 ‘Save’를 눌러요. 그러면 인증서 요청이 다시 시작돼요.
@에 남은 A, AAAA, ALIAS, ANAME 레코드나 서브도메인의 두 번째 CNAME이 인증서 발급을 막을 수 있어요. 도메인에 CAA 레코드가 있다면 그중 하나가letsencrypt.org를 허용해야 해요. www에서는 열리는데 루트 도메인에서는 안 열려요. 또는 그 반대예요. 안 열리는 쪽에 레코드가 없어요. 루트 도메인에는 A 레코드 4개를,www에는 CNAME을 추가하세요. 서브도메인의 CNAME을 내 루트 도메인으로 향하게 하지 마세요. GitHub는 그러면 HTTPS가 깨진다고 해요.- HTTPS를 켠 뒤 이미지나 스타일이 사라졌어요. 페이지가 그것들을
http://로 불러오고 있어요. 해당 URL을https://로 바꾸세요. - 예전 주소가 아직 열려요. 브라우저 캐시를 지우세요.
사이트 하나에는 루트 도메인 하나와 www 서브도메인 하나를 연결할 수 있어요. GitHub 문서는 루트 도메인을 둘 이상, www 서브도메인을 둘 이상, 또는 루트 도메인과 다른 서브도메인을 같은 사이트에 쓰는 구성을 지원하지 않는다고 적고 있어요.
도메인 뒤의 사이트에 GitHub Pages가 요구하는 것
- GitHub Free에서는 공개 저장소. Pages는 GitHub Free에서는 공개 저장소에서, 비공개 저장소에서는 GitHub Pro부터 쓸 수 있어요. 어느 쪽이든 게시된 사이트는 누구나 볼 수 있어요.
- 온라인 비즈니스는 안 돼요. GitHub의 제한 페이지는 Pages가 온라인 비즈니스, 전자상거래 사이트, 또는 주로 상거래를 돕거나 상업용 소프트웨어를 서비스(SaaS)로 제공하는 웹사이트를 운영하기 위한 무료 웹 호스팅으로 쓰도록 만들어지지 않았고 허용되지도 않는다고 해요. 어디까지 되는지는 GitHub Pages 상업적 이용 (영어)에서 다뤄요.
- 파일만 올라가요. Pages는 정적 사이트 호스팅 서비스라서, 문의 폼이나 가입 폼에는 별도의 서비스가 필요해요.
- 크기와 트래픽. 사이트는 최대 1 GB이고, 대역폭에는 한 달 100 GB의 유연한 한도가 있어요. 나머지는 GitHub Pages 한도 (영어)에 있어요.
폼과 방문자 통계가 있는 내 도메인: Convika
가입, 예약, 주문을 받는 페이지는 파일을 올려 두는 것만으로는 부족해요. Convika에서는 무료 요금제로도 업로드한 페이지에 내 도메인을 연결할 수 있어요. 저장소도 빌드도 필요 없고, 모든 요금제에서 상업적으로 쓸 수 있어요.
| Convika 무료 요금제 | GitHub Pages | |
|---|---|---|
| 게시하는 것 | 브라우저에서 업로드한 HTML 파일, 폴더, ZIP, 또는 AI 채팅에서 붙여 넣은 코드 | GitHub 저장소의 파일. GitHub Free에서는 공개 저장소 |
| 내 도메인 | www.yourbrand.com 같은 도메인 1개 | 서브도메인 또는 루트 도메인 |
| DNS 레코드 | www에 CNAME과 TXT. A 레코드 하나가 yourbrand.com을 그쪽으로 보내요 | www에 CNAME. 루트 도메인에 A 레코드 4개. 확인용 TXT |
| HTTPS | 레코드가 확인되면 자동으로 발급 | 자동으로 발급. ‘Enforce HTTPS’를 선택 |
| 판매하는 사이트 | 모든 요금제에서 허용 | 온라인 비즈니스나 전자상거래 사이트에는 허용되지 않음 |
| 응답을 저장하는 폼 | 있어요. 응답이 저장되고, 이메일로 오고, CSV나 JSON으로 내보낼 수 있어요. 한 달에 50건 표시 | 파일만 |
| 방문자 통계 | 방문 수, 유입 경로, UTM 캠페인, 기기, 국가, 버튼 클릭을 90일 동안 | 문서에 없음 |
| 가격 | $0, Convika 배너 포함. Pro는 한 달에 $12 | 무료 |
페이지를 옮기려면 저장소에서 index.html을, 또는 CSS와 이미지가 든 폴더를 내려받아 Convika 업로드 상자에 놓으세요. ‘이 페이지 보관하기 (무료, 카드 필요 없음)’를 누르고, 이어서 ‘페이지 게시하기’, ‘전체 공개’, ‘다음’, ‘무료로 게시하기’를 눌러요. 페이지 화면에서 ‘Connect my domain’(내 도메인 연결, 대시보드에 영어로 나와요)을 누르고 www.yourbrand.com을 추가한 뒤, <user>.github.io를 가리키는 CNAME을 Convika가 보여 주는 값으로 바꿔요. 화면별 설명은 내 도메인으로 페이지 열기 (영어)에, 복사해서 쓸 폼은 HTML 문의 폼 코드 (영어)에 있어요.
다른 서비스는 GitHub Pages 대안 (영어)에서 비교해요.
Skipbox
Cheap & fast GitHub Actions runners, unlimited for $39 a month
Your own machine keeps Docker layers and package caches between jobs. Switch by changing one runs-on line.
Start a free Skipbox trial자주 묻는 질문
GitHub Pages에서 내 도메인을 무료로 쓸 수 있나요?
네. GitHub Pages는 GitHub Free의 공개 저장소에서 내 도메인을 무료로 연결해 줘요. 도메인 자체의 비용만 등록 업체에 내면 돼요. Convika 무료 요금제도 내 도메인 1개를 연결해 주고, 업로드한 HTML 파일에 폼과 방문자 통계가 함께 있어요.
GitHub Pages에는 어떤 DNS 레코드가 필요한가요?
www나 다른 서브도메인에는 <user>.github.io를 가리키는 CNAME 레코드가 필요해요. 루트 도메인에는 A 레코드 4개, 185.199.108.153, 185.199.109.153, 185.199.110.153, 185.199.111.153을 추가하거나, <user>.github.io를 가리키는 ALIAS 또는 ANAME 레코드를 추가해요. IPv6도 쓰려면 A 레코드와 함께 AAAA 레코드 4개를 추가해요.
GitHub Pages에 연결한 도메인은 얼마나 지나야 작동하나요?
최대 24시간이에요. GitHub 문서에 따르면 DNS 변경이 퍼지는 데 최대 24시간이 걸릴 수 있고, HTTPS는 도메인을 설정한 뒤 최대 한 시간이 걸릴 수 있으며, ‘Enforce HTTPS’ 옵션을 쓸 수 있게 되기까지 최대 24시간이 걸릴 수 있어요.
GitHub Pages에서 Enforce HTTPS를 켤 수 없는 이유는 뭔가요?
인증서가 아직 발급되지 않았기 때문이에요. 도메인을 설정한 뒤 한 시간까지 기다려 보세요. 그래도 안 되면 도메인을 지웠다가 다시 추가해 요청을 다시 시작하고, 같은 이름에 남은 A, AAAA, CNAME 레코드를 지우고, CAA 레코드가 letsencrypt.org를 허용하는지 확인하세요. 전체 도메인 이름은 64자보다 짧아야 해요.
CNAME 레코드는 저장소 URL을 가리켜야 하나요?
아니요. 프로젝트 사이트라도 저장소 이름 없이 <user>.github.io나 <organization>.github.io를 가리키게 하세요. GitHub는 저장소의 Pages 설정에 나오는 *.pages.github.io 주소를 가리키게 하지도 말라고 해요.
비공개 저장소에서도 GitHub Pages에 내 도메인을 쓸 수 있나요?
GitHub Pro부터 쓸 수 있어요. GitHub Free에서는 Pages가 공개 저장소에서만 작동해요. 어느 경우든 사이트 자체는 인터넷에 공개돼요. 자세한 내용은 GitHub Pages와 비공개 저장소 (영어)에 있어요.
사업용 사이트에 GitHub Pages 도메인 연결을 써도 되나요?
GitHub는 Pages를 온라인 비즈니스, 전자상거래 사이트, SaaS 운영에 쓰는 것을 허용하지 않는다고 해요. Convika 무료 요금제는 상업적 이용을 허용하고, 같은 HTML 파일에 내 도메인을 연결해 주며, 문의를 하나하나 저장하는 폼이 있어요.
GitHub Pages 사이트 하나에 도메인을 여러 개 연결할 수 있나요?
루트 도메인 하나와 그 www 서브도메인을 연결할 수 있고, 둘은 서로 리디렉션돼요. GitHub 문서는 루트 도메인을 둘 이상 쓰거나 루트 도메인과 다른 서브도메인을 함께 쓰는 구성을 지원하지 않는다고 적고 있고, CNAME 파일에는 도메인이 하나만 들어가요.
출처
모두 GitHub Docs이고, 2026년 11월 17일에 영어로 읽었어요. 페이지에 날짜는 나와 있지 않아요.
관련 글
- 2026년 Netlify 대안: 무료 범위로 비교한 호스팅 5가지Convika, Cloudflare Pages, Vercel, GitHub Pages, Render를 Netlify와 비교했어요. 무료 한도, 내 도메인, 폼, 방문자 통계, 가격을 2026년 11월 17일에 확인했어요.
- HTML 파일을 파일 대신 링크로 공유하는 방법: Google 드라이브, GitHub Pages, Convika 비교HTML 파일을 카카오톡이나 메일로 보내면 받은 사람에게는 페이지가 아니라 파일이 가요. 파일을 올려서 링크로 보내는 방법을 Google 드라이브, GitHub Pages와 비교하고, Convika로 링크를 만드는 4단계를 정리했어요.
- ChatGPT(챗GPT)가 만든 HTML 페이지를 내 웹사이트 링크로 올리는 방법: Convika·GitHub Pages·Netlify 비교ChatGPT로 만든 HTML은 Convika에 파일을 끌어다 놓으면 누구나 여는 링크로 게시할 수 있어요. Convika를 연결한 ChatGPT에서 바로 게시할 수도 있어요. GitHub Pages, Netlify Drop, Cloudflare Pages에 올리는 단계도 공식 문서 링크와 함께 정리했어요.
- 클로드(Claude) 아티팩트 공유 링크를 열면 로그인하라고 나올 때: 누구나 여는 링크 만드는 방법‘링크가 있는 누구나’로 공유한 Claude 아티팩트는 대부분 로그인 없이 열려요. 그래도 로그인 화면이 나오는 이유와, Claude Free에서 코드를 누구나 여는 페이지로 게시하는 5단계를 설명해요.