목표#
my-app.vercel.app대신 직접 구입한 도메인(예:example.com)으로 서비스를 연결합니다.- DNS 레코드(A, CNAME) 또는 네임서버 방식으로 도메인을 연결하는 차이를 이해합니다.
- HTTPS 인증서가 자동으로 발급되는 것을 확인합니다.
사전 조건#
- 3장에서 Production 배포가 완료되어 있습니다.
도메인을 구입했고, 도메인 구입처(가비아, 카페24, Cloudflare, GoDaddy, Namecheap 등)의 DNS 관리 화면에 접속할 수 있습니다.
- 도메인이 없다면 Vercel Domains 메뉴에서 직접 구입할 수도 있습니다.
이 장의 예시는 example.com을 사용합니다. 실제 진행 시 본인 도메인으로 바꿔 입력하세요.
1. 용어 정리#
| 용어 | 뜻 | 예시 |
|---|---|---|
| 루트 도메인 (Apex) | 앞에 아무것도 붙지 않은 도메인 | example.com |
| 서브도메인 | 앞에 이름이 붙은 도메인 | www.example.com, app.example.com |
| DNS | 도메인 이름을 서버 주소로 바꿔 주는 전화번호부 | |
| A 레코드 | 도메인을 IP 주소로 연결 | example.com → 76.76.21.21 |
| CNAME 레코드 | 도메인을 다른 도메인 이름으로 연결 | www → cname.vercel-dns.com |
| 네임서버 (NS) | 도메인의 DNS를 어느 회사가 관리할지 지정 | ns1.vercel-dns.com |
2. Vercel에 도메인 추가하기#
- Vercel 프로젝트에서 Settings → Domains로 이동합니다.
- Add Domain을 누르고
example.com을 입력합니다. - 루트 도메인을 추가하면
www.example.com도 함께 추가하고 한쪽을 다른 쪽으로 리디렉션할지 묻습니다. 권장 설정(예:example.com→www.example.com)을 선택하고 Add(또는 Save)를 누릅니다. - 도메인 목록에 Invalid Configuration 같은 경고와 함께 설정해야 할 DNS 레코드 값이 표시됩니다. 이 값을 복사해 둡니다.
DNS 레코드 값은 반드시 Vercel 화면에 표시된 값을 사용하세요. 아래 표의 값은 널리 알려진 예시이며, Vercel은 프로젝트마다 다른 전용 값을 안내할 수 있습니다.
3. DNS 연결 방법 선택#
| 방법 | 하는 일 | 장점 | 단점 |
|---|---|---|---|
| A / CNAME 레코드 (권장) | 구입처 DNS 화면에 레코드 몇 개 추가 | 기존 메일(MX) 등 다른 설정 유지 | 레코드를 직접 입력해야 함 |
| 네임서버 변경 | DNS 관리 전체를 Vercel로 옮김 | Vercel이 레코드를 자동 관리 | 기존 DNS 설정(메일 등)을 Vercel로 다시 옮겨야 함 |
처음이라면 A / CNAME 레코드 방식을 권장합니다.
4. 방법 A: A / CNAME 레코드 추가하기#
도메인 구입처의 DNS 관리 화면(“DNS 설정”, “DNS 레코드 관리”, “네임서버/DNS” 등)으로 이동해 아래 레코드를 추가합니다.
| 연결할 주소 | 레코드 타입 | 호스트(이름) | 값 (예시) |
|---|---|---|---|
example.com | A | @ (또는 빈칸) | 76.76.21.21 |
www.example.com | CNAME | www | cname.vercel-dns.com |
- 구입처 DNS 관리 화면에서 레코드 추가를 누릅니다.
- 위 표대로 타입, 호스트, 값을 입력합니다. (값은 Vercel 화면에 표시된 것 사용)
- TTL은 기본값 그대로 두거나 짧게(예: 300~3600초) 설정합니다.
- 저장합니다.
- 같은 호스트(
@,www)에 기존 A 레코드나 CNAME 레코드가 있다면 삭제합니다. (주차 페이지용 레코드 등)
같은 호스트에 A 레코드가 여러 개 있으면 일부 방문자가 엉뚱한 서버(도메인 구입처의 기본 페이지 등)로 접속합니다. Vercel용 레코드 외의 A/CNAME 레코드는 정리하세요. 단, MX(메일), TXT 레코드는 지우지 마세요.
구입처에 따라 호스트 칸에 @ 대신 빈칸을 쓰거나, www.example.com 전체를 입력해야 하는 경우가 있습니다. 구입처 도움말의 “A 레코드 설정” 항목을 참고하세요.
5. 방법 B: 네임서버 변경하기#
- Vercel 도메인 화면에서 Nameservers 방식 안내를 엽니다.
도메인 구입처의 네임서버 변경 화면에서 기존 값을 지우고 Vercel 네임서버를 입력합니다.
ns1.vercel-dns.com ns2.vercel-dns.com- 저장합니다.
네임서버를 바꾸면 구입처에 있던 모든 DNS 레코드가 더 이상 사용되지 않습니다. 회사 메일(MX 레코드) 등을 쓰고 있다면 미리 Vercel Domains 화면에 같은 레코드를 옮겨 두세요.
6. 연결 확인과 HTTPS#
- Vercel Settings → Domains 화면으로 돌아갑니다.
도메인 상태가 Valid Configuration(초록 체크)으로 바뀌면 연결이 완료된 것입니다.
- DNS 변경이 전 세계에 퍼지는 데 보통 몇 분, 길게는 최대 48시간까지 걸릴 수 있습니다.
- 연결이 확인되면 Vercel이 HTTPS 인증서를 자동으로 발급합니다. 따로 할 일은 없습니다.
- 브라우저에서
https://example.com과https://www.example.com에 접속해 봅니다.
터미널에서 DNS가 제대로 바뀌었는지 직접 확인할 수도 있습니다.
nslookup example.com
nslookup www.example.com도메인을 연결해도 my-app.vercel.app 주소는 계속 사용할 수 있습니다.
확인 방법#
문제 해결#
| 증상 | 원인과 해결 |
|---|---|
| 계속 Invalid Configuration | DNS 전파 대기 중일 수 있음 → 시간을 두고 확인. 레코드 값·호스트 오타 확인 |
| 가끔 구입처 기본 페이지가 보임 | 같은 호스트에 기존 A/CNAME 레코드가 남아 있음 → 삭제 |
| HTTPS 인증서 발급 실패 | DNS에 CAA 레코드가 있다면 letsencrypt.org 허용 여부 확인 |
| “도메인이 다른 계정/프로젝트에서 사용 중” | 다른 Vercel 프로젝트에서 도메인 제거, 또는 Vercel이 안내하는 TXT 레코드로 소유권 확인 |
| 루트 도메인에 CNAME을 넣을 수 없음 | 대부분의 DNS는 루트(@)에 CNAME을 허용하지 않음 → 루트는 A 레코드 사용 |
다음 단계#
➡️ 8장. Vercel CLI (선택): 브라우저 대신 터미널에서 배포하고 환경 변수를 관리합니다.