# 커스텀 도메인 연결 가이드

GitHub Pages에 내 도메인을 연결하는 방법입니다.
`username.github.io` 대신 `내이름.kr` 같은 주소를 쓸 수 있습니다.

---

## 왜 커스텀 도메인?

```
기본 주소: jimin-design.github.io     → 길고 기억하기 어려움
커스텀:    jimin.kr                    → 짧고 전문적
```

**필수는 아닙니다.** github.io로도 충분합니다.
나중에 여유 있을 때 연결하면 됩니다.

---

## 1단계: 도메인 구매

### 어디서 사나요?

| 서비스 | 주소 | .kr 도메인 | 특징 |
|--------|------|-----------|------|
| **가비아** | gabia.com | 연 11,000원~ | 한국 서비스, 한글 지원 |
| **호스팅케이알** | hosting.kr | 연 9,900원~ | 가장 저렴한 .kr |
| **Namecheap** | namecheap.com | .com 연 $9~ | 해외 서비스, .com 추천 |
| **Cloudflare** | cloudflare.com | .com 연 $10~ | 원가에 판매, 무료 SSL |

### 도메인 선택 팁

```
✅ 짧은 이름 — sabum.kr, jimin.dev
✅ 기억하기 쉬운 — 본명, 닉네임, 브랜드명
✅ 확장자 선택 — .kr(한국), .com(범용), .dev(개발자), .design(디자이너)

❌ 너무 긴 이름
❌ 특수문자, 하이픈 남발
```

---

## 2단계: DNS 설정

도메인을 구매한 곳에서 DNS 레코드를 설정합니다.

### A 레코드 추가 (4개)

```
타입: A
이름: @ (또는 빈칸)
값:
  185.199.108.153
  185.199.109.153
  185.199.110.153
  185.199.111.153
```

### CNAME 레코드 추가 (1개)

```
타입: CNAME
이름: www
값: username.github.io
```

### 가비아 기준 설정 방법

```
1. 가비아 로그인 → My가비아 → 도메인 관리
2. 해당 도메인 클릭 → DNS 관리
3. DNS 설정 → 레코드 추가
4. 위 A 레코드 4개 + CNAME 1개 입력
5. 저장
```

---

## 3단계: GitHub 설정

### 방법 1: Antigravity에서 요청

```
내 도메인을 GitHub Pages에 연결해줘.
도메인: 내도메인.kr
```

### 방법 2: GitHub 웹에서 직접

```
1. GitHub 저장소 → Settings
2. 왼쪽 메뉴에서 "Pages" 클릭
3. "Custom domain" 칸에 내 도메인 입력 (예: sabum.kr)
4. Save 클릭
5. "Enforce HTTPS" 체크 (자동 SSL)
```

### 방법 3: CNAME 파일 추가

프로젝트 루트에 `CNAME` 파일을 만듭니다.

```
Antigravity에서:
"프로젝트 루트에 CNAME 파일을 만들어줘. 내용은 내도메인.kr"
```

---

## 4단계: 확인

설정 후 **10분~1시간** 정도 기다려야 합니다.

```
1. 브라우저에서 내도메인.kr 접속
2. 사이트가 보이면 성공
3. https:// 가 자동으로 붙으면 SSL도 성공
```

### 안 되면?

| 상황 | 확인할 것 |
|------|----------|
| 접속 안 됨 | DNS 전파 대기 (최대 24시간) |
| 404 에러 | GitHub Pages 설정에서 도메인이 맞는지 확인 |
| HTTPS 안 됨 | "Enforce HTTPS" 체크 후 10분 대기 |
| www가 안 됨 | CNAME 레코드(www → username.github.io) 확인 |

---

## 비용 정리

| 항목 | 비용 |
|------|------|
| 도메인 (.kr) | 연 약 11,000원 |
| 도메인 (.com) | 연 약 12,000원 |
| GitHub Pages 호스팅 | 무료 |
| SSL 인증서 (HTTPS) | 무료 (GitHub 자동 제공) |
| **합계** | **연 11,000원~12,000원** |

---

## 요약

```
1. 도메인 구매 (가비아, Namecheap 등)
2. DNS에 A 레코드 4개 + CNAME 1개 추가
3. GitHub Pages에서 Custom domain 입력
4. 10분~1시간 대기
5. 내도메인.kr로 접속 확인
```

**지금 당장 안 해도 됩니다.**
먼저 `username.github.io`로 배포하고, 나중에 도메인을 연결해도 기존 사이트가 그대로 유지됩니다.