배포 매뉴얼
전체 목차07 · 커스텀 도메인
Chapter 07

커스텀 도메인

최종 확인일 2026-11-04 읽는 시간 약 7분 운영 · 협업과 도메인

목표#

  • 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에 도메인 추가하기#

  1. Vercel 프로젝트에서 Settings → Domains로 이동합니다.
  2. Add Domain을 누르고 example.com을 입력합니다.
  3. 루트 도메인을 추가하면 www.example.com도 함께 추가하고 한쪽을 다른 쪽으로 리디렉션할지 묻습니다. 권장 설정(예: example.com → www.example.com)을 선택하고 Add(또는 Save)를 누릅니다.
  4. 도메인 목록에 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.comA@ (또는 빈칸)76.76.21.21
www.example.comCNAMEwwwcname.vercel-dns.com
  1. 구입처 DNS 관리 화면에서 레코드 추가를 누릅니다.
  2. 위 표대로 타입, 호스트, 값을 입력합니다. (값은 Vercel 화면에 표시된 것 사용)
  3. TTL은 기본값 그대로 두거나 짧게(예: 300~3600초) 설정합니다.
  4. 저장합니다.
  5. 같은 호스트(@, www)에 기존 A 레코드나 CNAME 레코드가 있다면 삭제합니다. (주차 페이지용 레코드 등)
주의

같은 호스트에 A 레코드가 여러 개 있으면 일부 방문자가 엉뚱한 서버(도메인 구입처의 기본 페이지 등)로 접속합니다. Vercel용 레코드 외의 A/CNAME 레코드는 정리하세요. 단, MX(메일), TXT 레코드는 지우지 마세요.

팁

구입처에 따라 호스트 칸에 @ 대신 빈칸을 쓰거나, www.example.com 전체를 입력해야 하는 경우가 있습니다. 구입처 도움말의 “A 레코드 설정” 항목을 참고하세요.

5. 방법 B: 네임서버 변경하기#

  1. Vercel 도메인 화면에서 Nameservers 방식 안내를 엽니다.
  2. 도메인 구입처의 네임서버 변경 화면에서 기존 값을 지우고 Vercel 네임서버를 입력합니다.

    output
    ns1.vercel-dns.com
    ns2.vercel-dns.com
  3. 저장합니다.
주의

네임서버를 바꾸면 구입처에 있던 모든 DNS 레코드가 더 이상 사용되지 않습니다. 회사 메일(MX 레코드) 등을 쓰고 있다면 미리 Vercel Domains 화면에 같은 레코드를 옮겨 두세요.


6. 연결 확인과 HTTPS#

  1. Vercel Settings → Domains 화면으로 돌아갑니다.
  2. 도메인 상태가 Valid Configuration(초록 체크)으로 바뀌면 연결이 완료된 것입니다.

    • DNS 변경이 전 세계에 퍼지는 데 보통 몇 분, 길게는 최대 48시간까지 걸릴 수 있습니다.
  3. 연결이 확인되면 Vercel이 HTTPS 인증서를 자동으로 발급합니다. 따로 할 일은 없습니다.
  4. 브라우저에서 https://example.com 과 https://www.example.com 에 접속해 봅니다.

터미널에서 DNS가 제대로 바뀌었는지 직접 확인할 수도 있습니다.

bash
nslookup example.com
nslookup www.example.com
참고

도메인을 연결해도 my-app.vercel.app 주소는 계속 사용할 수 있습니다.


확인 방법#

문제 해결#

증상원인과 해결
계속 Invalid ConfigurationDNS 전파 대기 중일 수 있음 → 시간을 두고 확인. 레코드 값·호스트 오타 확인
가끔 구입처 기본 페이지가 보임같은 호스트에 기존 A/CNAME 레코드가 남아 있음 → 삭제
HTTPS 인증서 발급 실패DNS에 CAA 레코드가 있다면 letsencrypt.org 허용 여부 확인
“도메인이 다른 계정/프로젝트에서 사용 중”다른 Vercel 프로젝트에서 도메인 제거, 또는 Vercel이 안내하는 TXT 레코드로 소유권 확인
루트 도메인에 CNAME을 넣을 수 없음대부분의 DNS는 루트(@)에 CNAME을 허용하지 않음 → 루트는 A 레코드 사용

다음 단계#

➡️ 8장. Vercel CLI (선택): 브라우저 대신 터미널에서 배포하고 환경 변수를 관리합니다.

참고 자료#