DEV WIKI
인프라 · 문제 해결 가이드

루트 도메인에 CNAME을 설정할 수 없어요

루트 도메인에 CNAME을 추가할 수 없을 때 기존 레코드 충돌과 CNAME 대상 이름의 해석 여부를 구분하는 가이드입니다.

빠른 답변

루트 도메인에 CNAME을 설정할 수 없으면 같은 이름에 이미 있는 레코드와 CNAME이 함께 존재하는지 먼저 확인하고, CNAME을 사용한다면 대상 이름이 실제로 해석되는지 별도로 확인해야 합니다.

적용 범위
이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
출처 확인일
2026-07-29
최종 검토
2026-07-29
수정일
2026-07-29
대상
사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
오류·수정 제보 (새 창에서 열림)

이 가이드가 맞는 경우

  • CNAME 레코드 충돌
  • CNAME 대상 이름 해석 실패

상황별 다음 단계

호스팅사·개발자에게 전달할 내용

변경 전 기록

  • CNAME을 추가하려는 이름, 기존 레코드 유형, 관리 화면의 오류 문구를 전달합니다.
  • CNAME 대상 이름의 DNS 응답과 확인 시각을 함께 전달합니다.
  • DNS 공급자 계정·API 토큰·도메인 이전 인증 코드는 전달하지 않습니다.

알아둘 점

루트 도메인에 CNAME을 추가할 수 없는 상황은 웹 서버 접속 오류와 다릅니다. 먼저 같은 이름에 어떤 DNS 레코드가 있는지, CNAME 대상 이름이 해석되는지를 구분하세요.

먼저 기록할 것

  1. CNAME을 추가하려는 이름과 대상 이름을 기록합니다.
  2. 같은 이름에 이미 있는 레코드 유형을 기록합니다.
  3. DNS 관리 화면에 표시된 오류 문구와 시각을 기록합니다.

상황별 다음 단계

  1. 같은 이름의 기존 레코드와 CNAME을 함께 둘 수 없다는 오류가 보이면 CNAME 레코드가 같은 이름의 기존 레코드와 충돌함을 확인합니다.
  2. CNAME 등록 뒤 대상 이름이 해석되지 않으면 CNAME 대상 도메인 이름이 해석되지 않음을 확인합니다.

DNS 영역의 기존 레코드를 삭제하거나 위임을 해제하는 작업은 다른 서비스에 영향을 줄 수 있습니다. 변경 전 현재 레코드를 보관하고 영향 범위를 확인하세요.

참고 자료

RFC 2181 - Clarifications to the DNS Specification (새 창에서 열림)

IETF · 공식 자료 · 확인 범위: 한 DNS 이름에는 CNAME 레코드 하나만 있거나 CNAME이 아닌 하나 이상의 레코드만 있어야 합니다. · 확인일: 2026-07-29

Cannot add DNS records with the same name (새 창에서 열림)

Cloudflare · 공식 자료 · 확인 범위: 같은 이름의 CNAME과 A·AAAA·CNAME을 함께 만들 수 없다고 안내합니다. · 확인일: 2026-07-29