# 내 도메인을 GitHub Pages에 어떻게 연결하나요?

> 도메인을 GitHub Pages에 연결하세요: DotAlmanac 템플릿 하나로 A 레코드 4개(185.199.108.153–111.153), AAAA 레코드 4개, www CNAME을 설정합니다. KYC 없이 암호화폐로 결제하세요.

- URL: https://dotalmanac.com/ko/how-to-connect-a-domain-to-github-pages/
- 최종 업데이트: 2026-10-29
- 발행자: DotAlmanac (https://dotalmanac.com)

GitHub가 공개하는 정확한 DNS 레코드, 도메인 탈취를 막는 단계 순서, 그리고 GitHub에서 도메인이 설정되지 않았다고 할 때 확인할 사항.

**빠른 답변 — GitHub Pages에 도메인을 연결하려면 어떻게 하나요?**

GitHub Pages에 도메인을 연결하려면 베어 도메인을 GitHub의 4개 A 레코드(185.199.108.153 ~ 185.199.111.153)에, www를 사용자명.github.io 이름에 지정한 다음, 리포지토리의 Pages 설정에 도메인을 입력하세요. **DotAlmanac**의 GitHub Pages 템플릿은 2026년 10월 29일 기준으로 9개 레코드를 한 번에 준비합니다.

## 한눈에 보는 GitHub Pages DNS

| 항목 | 값 |
| --- | --- |
| A 레코드 (@) | 185.199.108.153 · 185.199.109.153 · 185.199.110.153 · 185.199.111.153 |
| AAAA 레코드 (@) | 2606:50c0:8000::153 · 2606:50c0:8001::153 · 2606:50c0:8002::153 · 2606:50c0:8003::153 |
| www | 리포지토리 이름 없이 `USERNAME.github.io`로 향하는 CNAME |
| 도메인을 입력하는 곳 | Repository › Settings › Pages › Custom domain |
| 도메인 인증 | 프로필 Settings › Pages에서 확인할 수 있는 `_github-pages-challenge-USERNAME` TXT 레코드 |
| HTTPS | GitHub가 인증서를 발급한 후 Pages 설정에서 \"Enforce HTTPS\" 활성화 |
| 템플릿 레코드의 TTL | 3600초 (1시간) |
| DNS 호스팅 | 모든 DotAlmanac 도메인에 무료 포함 |

## GitHub Pages에 도메인을 연결하려면 무엇이 필요한가요?

DotAlmanac은 도메인 확장자 가이드이자 등록 대행자입니다. 모든 확장자를 비교한 뒤 KYC 없이 등록하고 암호화폐로 결제하세요. 이 가이드를 따라 하려면 세 가지가 필요합니다.

- **DotAlmanac 네임서버에 있는 도메인.** 도메인의 Nameservers 탭이 \"Our nameservers\"로 표시되어야 합니다. 다른 네임서버를 쓰는 도메인이라면 해당 DNS 제공업체에서 같은 레코드를 추가하세요.
- **GitHub Pages를 켠 리포지토리.** 브랜치 또는 GitHub Actions 워크플로에서 게시할 수 있습니다.
- **GitHub 사용자 또는 조직 이름.** 이것은 www 레코드에 들어갑니다. 리포지토리 이름은 절대 들어가지 않습니다.

많은 개발자가 프로젝트 사이트용으로 .dev 또는 .app을 선택합니다. 갱신 가격을 먼저 확인하세요. DotAlmanac의 가격표에 따르면 2026년 10월 29일 기준 .dev는 첫해 가격보다 44% 높게, .app은 67% 높게 갱신됩니다. .dev는 US$8.99/년이고 이후 US$12.99/년입니다. 두 확장자 모두 HTTPS가 필요하며, GitHub Pages가 이를 제공합니다. [.app vs .dev](https://dotalmanac.com/ko/app-vs-dev/ "내 프로젝트에 .app과 .dev 중 어느 것을 사용해야 하나요?")에서 비교해 보세요.

## 6단계로 도메인을 GitHub Pages에 연결하는 방법

1. **먼저 GitHub에서 도메인 인증** — GitHub 프로필에서 Settings › Pages › Add a domain을 엽니다. GitHub가 _github-pages-challenge-USERNAME라는 이름의 TXT 레코드와 값을 보여 줍니다. 도메인의 DNS 탭에 추가한 뒤 Verify를 누르세요.
2. **GitHub Pages 템플릿 열기** — 클라이언트 영역에서 도메인을 열고 DNS › Templates › GitHub Pages로 이동합니다. GitHub 사용자 또는 조직 이름을 입력하세요. 예: octocat.
3. **미리보기를 확인한 뒤 저장** — 미리보기에는 A 레코드 4개, AAAA 레코드 4개, CNAME 레코드 1개가 표시됩니다. @와 www의 A, AAAA, CNAME, ALIAS 레코드를 교체하며 MX와 TXT 레코드는 그대로 둡니다. 저장하기 전에는 아무것도 전송되지 않습니다.
4. **리포지토리에 사용자 정의 도메인 입력** — 리포지토리에서 Settings › Pages › Custom domain을 열고 도메인을 입력한 뒤 Save를 누릅니다. 브랜치에서 게시하면 CNAME 파일이 추가되며, GitHub Actions 워크플로에는 그런 파일이 필요 없습니다.
5. **GitHub의 DNS 확인 기다리기** — GitHub가 레코드를 확인하고 Custom domain 아래에 결과를 표시합니다. 대기 시간은 변경 전에 리졸버가 캐시한 레코드의 TTL에 따라 달라집니다.
6. **Enforce HTTPS 켜기** — GitHub가 인증서를 발급하면 같은 Pages 설정에서 Enforce HTTPS를 선택하세요. .dev와 .app의 경우 HTTPS가 작동하기 전까지 사이트가 로드되지 않습니다.

## GitHub Pages의 정확한 DNS 레코드는 무엇인가요?

다음은 GitHub가 루트 도메인(apex)과 www용으로 공개하는 값입니다. DotAlmanac 템플릿은 정확히 이 9개 레코드를 추가합니다.

*GitHub Docs에 게시된 GitHub Pages 레코드 (2026년 10월 29일 확인)*

| 유형 | 이름 | 값 | TTL |
| --- | --- | --- | --- |
| A | @ | 185.199.108.153 | 3600 |
| A | @ | 185.199.109.153 | 3600 |
| A | @ | 185.199.110.153 | 3600 |
| A | @ | 185.199.111.153 | 3600 |
| AAAA | @ | 2606:50c0:8000::153 | 3600 |
| AAAA | @ | 2606:50c0:8001::153 | 3600 |
| AAAA | @ | 2606:50c0:8002::153 | 3600 |
| AAAA | @ | 2606:50c0:8003::153 | 3600 |
| CNAME | www | USERNAME.github.io | 3600 |

USERNAME을 GitHub 사용자 이름 또는 조직 이름으로 바꾸세요. GitHub 문서와 저장소의 Pages 설정이 기준입니다. GitHub가 사이트에 대해 다른 값을 표시하면 그 값을 사용하세요.

## 레코드를 영역 파일로 붙여넣을 수 있나요?

네. DNS › 가져오기 / 내보내기 › 영역 파일 가져오기를 열고 "기존 레코드에 추가"를 선택한 뒤 아래 줄을 붙여넣으세요. `octocat`을 본인의 사용자 이름으로 바꾸세요. 가져오기는 표준 BIND 구문을 읽고, 미리보기를 표시하며, 저장하기 전에는 아무것도 전송하지 않습니다.

*example.com용 GitHub Pages 레코드 (사용자: octocat)*

```text
@    3600  IN  A      185.199.108.153
@    3600  IN  A      185.199.109.153
@    3600  IN  A      185.199.110.153
@    3600  IN  A      185.199.111.153
@    3600  IN  AAAA   2606:50c0:8000::153
@    3600  IN  AAAA   2606:50c0:8001::153
@    3600  IN  AAAA   2606:50c0:8002::153
@    3600  IN  AAAA   2606:50c0:8003::153
www  3600  IN  CNAME  octocat.github.io.
```

## GitHub Pages에는 루트 도메인과 www 중 무엇을 사용해야 하나요?

둘 다 설정하고, 저장소에는 선호하는 쪽을 입력하세요. 루트와 www의 레코드가 올바르면 GitHub Pages가 나머지 하나를 해당 주소로 리디렉션합니다.

GitHub는 사이트당 루트 도메인 하나 또는 www 이름 하나를 지원합니다. 루트 도메인 두 개, www 이름 두 개, 또는 루트 도메인과 다른 사용자 지정 하위 도메인의 조합은 지원하지 않습니다. `docs.example.com` 같은 하위 도메인에 프로젝트를 두려면 `docs`에서 `USERNAME.github.io`로 가는 CNAME을 하나 추가하고 A 레코드는 건너뛰세요.

## 내 도메인이 GitHub Pages에서 작동하기까지 얼마나 걸리나요?

변경 전에 리졸버가 본 레코드의 TTL에 따라 다릅니다. TTL은 리졸버가 응답을 캐시에 보관하는 시간(초)입니다.

- 이전 레코드가 없는 이름은 저장하는 즉시 확인됩니다.
- 교체된 레코드는 이전 TTL이 만료될 때까지 일부 캐시에 이전 값을 유지합니다. 템플릿 레코드는 3600초, 즉 1시간을 사용합니다.
- 이전은 미리 계획하세요: 변경 하루 전에 이전 레코드의 TTL을 300초로 낮추세요.

GitHub 자체 문서에 따르면 DNS 변경이 전파되기까지 최대 24시간이 걸릴 수 있습니다. HTTPS 인증서는 DNS 확인이 성공한 후에 발급됩니다.

## GitHub가 내 도메인이 제대로 구성되지 않았다고 하는 이유는 무엇인가요?

대부분의 경우 같은 이름에 이전 레코드가 여전히 응답합니다. 다음 사항을 순서대로 확인하세요:

- **남은 레코드.** @의 이전 A, AAAA 또는 ALIAS 레코드나 파킹 레코드가 GitHub의 레코드와 충돌합니다. 템플릿은 이를 제거하지만, 수동 편집에서는 흔히 하나를 놓칩니다.
- **CNAME의 저장소 이름.** www 대상은 `USERNAME.github.io`뿐입니다.
- **와일드카드 레코드.** GitHub는 `*.example.com` 같은 레코드가 도메인 탈취 위험을 만든다고 경고합니다. 삭제하세요.
- **다른 네임서버.** 도메인이 다른 DNS 제공자를 사용하면 DotAlmanac의 DNS 탭에 있는 레코드는 제공되지 않습니다.
- **CAA 레코드.** CAA 레코드를 게시하는 경우, GitHub는 HTTPS를 위해 값이 `letsencrypt.org`인 레코드를 최소 하나 요구합니다.

결과는 `dig example.com +short` 또는 온라인 DNS 조회로 테스트하세요.

## GitHub Pages와 사용자 지정 도메인: FAQ

### GitHub Pages에 A 레코드 4개가 모두 필요한가요?

네. GitHub는 이중화를 위해 4개의 주소를 게시하며, 템플릿은 모두 추가합니다. GitHub는 또한 IPv6 방문자를 위해 A 레코드와 함께 AAAA 레코드 4개를 권장합니다.

### 저장소에 도메인을 추가하기 전에 왜 인증해야 하나요?

인증은 다른 GitHub 사용자가 내 도메인을 자신의 Pages 사이트로 점유하는 것을 막아줍니다. 인증이 없으면 저장소 삭제나 Pages 사이트 비활성화 시 도메인이 탈취에 노출될 수 있습니다. 먼저 인증한 다음 저장소에 도메인을 추가하세요.

### 도메인을 GitHub Pages로 연결할 때 이메일을 유지할 수 있나요?

네. GitHub Pages 템플릿은 @와 www의 A, AAAA, CNAME, ALIAS 레코드만 변경합니다. MX, SPF 및 기타 TXT 레코드는 그대로 유지됩니다.

### DotAlmanac에서 GitHub Pages용 DNS 호스팅에 추가 비용이 있나요?

아니요. DNS 호스팅, 템플릿, 영역 파일 가져오기는 모든 도메인에 무료로 포함됩니다. [가격 페이지](https://dotalmanac.com/ko/pricing/ "도메인 이름은 연간 얼마인가요?")에 나온 대로 .com의 US$11.99/년처럼 도메인 비용만 지불하면 됩니다.

### GitHub Pages 프로젝트 사이트에는 어떤 확장자가 적합한가요?

GitHub Pages에는 어떤 확장자든 사용할 수 있습니다. 개발자들은 흔히 .dev, .io 또는 .com을 선택합니다. [개발자를 위한 최고의 도메인 확장자](https://dotalmanac.com/ko/best-domain-extension-for-developers/ "개발자에게 가장 좋은 도메인 확장자는 무엇인가요?")에서 비교해 보세요. 첫해 가격뿐 아니라 갱신 가격도 확인하세요.

## 출처

1. [GitHub Pages 사이트의 사용자 지정 도메인 관리하기](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/managing-a-custom-domain-for-your-github-pages-site) — GitHub Docs (확인일 2026-10-29)
2. [GitHub Pages용 사용자 지정 도메인 인증](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/verifying-your-custom-domain-for-github-pages) — GitHub Docs (확인일 2026-10-29)
3. [사용자 지정 도메인과 GitHub Pages 문제 해결](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site/troubleshooting-custom-domains-and-github-pages) — GitHub Docs (확인일 2026-10-29)

**GitHub Pages 사이트에 도메인이 필요하신가요?** KYC 없이 등록하고 암호화폐로 결제한 뒤 DNS 탭에서 GitHub Pages 템플릿을 적용하세요. [도메인 검색](https://dotalmanac.com/app/domains/?lang=ko) · [모든 가격 보기](https://dotalmanac.com/ko/pricing/ "도메인 이름은 연간 얼마인가요?")

---

DotAlmanac: DotAlmanac는 도메인 확장자 가이드이자 등록 대행자입니다: 모든 확장자를 비교한 후 KYC 없이 등록하고 암호화폐로 결제하세요. .com은 US$11.99/년입니다.