DEV WIKI
인프라 · 오류·증상

CNAME 레코드가 같은 이름의 기존 레코드와 충돌함

DNS 이름에 CNAME과 A, AAAA, 다른 CNAME 또는 위임 NS 레코드를 함께 추가하려 할 때 기존 레코드 충돌을 확인하는 문서입니다.

빠른 답변

우선 확인할 원인
CNAME 레코드를 추가할 수 없으면 같은 DNS 이름에 기존 A, AAAA, CNAME 또는 위임 NS 레코드가 있는지 확인해야 합니다. CNAME과 같은 이름의 다른 DNS 데이터는 함께 둘 수 없습니다.
먼저 확인할 항목
CNAME을 추가하거나 변경하려는 DNS 이름과 대상 이름을 기록합니다.
적용 범위
현재 증상과 본문에 적은 관찰 조건이 함께 확인된 경우
출처 확인일
2026-07-29
최종 검토
2026-07-29
수정일
2026-07-30
오류·수정 제보 (새 창에서 열림)

현재 증상

  • CNAME 레코드 충돌

먼저 확인할 항목

CNAME을 추가하거나 변경하려는 DNS 이름과 대상 이름을 기록합니다.

같은 이름에 있는 A, AAAA, CNAME, NS 레코드 유형을 기록합니다.

관리 화면의 충돌 오류 문구와 확인 시각을 기록합니다.

피해야 할 조치

주의

  • 기존 레코드나 NS 위임을 삭제하면 연결된 웹·메일·하위 영역에 영향을 줄 수 있습니다.
  • 어떤 레코드를 유지할지 정하기 전에는 현재 영역 데이터를 보관합니다.
  • DNS 공급자 계정·API 토큰·도메인 이전 인증 코드는 전달하지 않습니다.

환경별 원인과 조치

적용 범위

이 문서는 한 DNS 이름에 CNAME과 다른 레코드를 함께 두려 할 때의 충돌만 다룹니다. CNAME이 등록됐지만 대상 이름이 해석되지 않는 경우는 CNAME 대상 도메인 이름이 해석되지 않음을 확인합니다.

변경 없이 확인할 항목

  1. CNAME을 추가하려는 이름과 대상 이름을 기록합니다.
  2. 같은 이름에 이미 있는 A, AAAA, CNAME, NS 레코드를 기록합니다.
  3. 관리 화면의 오류 문구와 확인 시각을 기록합니다.

RFC 2181은 한 DNS 이름에 CNAME 하나만 있거나 CNAME이 아닌 하나 이상의 레코드만 있어야 한다고 설명합니다. 기존 레코드를 삭제하거나 위임을 해제하는 작업은 이 문서의 기본 조치가 아닙니다.

다음 문서

하위 도메인에서 충돌이 보이면 하위 도메인이 CNAME 충돌로 열리지 않아요를 확인합니다. DNS 기본 개념은 DNS에서 확인합니다.

관찰값 기록

문제가 발생한 URL 또는 화면, 표시 시각, 운영 환경과 최근 변경 사항을 먼저 기록합니다. 화면이나 로그에 오류 문구가 일부만 보이면 앞뒤 문장을 보존하고 비밀번호·토큰·쿠키·개인정보는 가립니다.

다음 항목을 실제 값과 함께 확인합니다.

  1. CNAME을 추가하거나 변경하려는 DNS 이름과 대상 이름을 기록합니다.
  2. 같은 이름에 있는 A, AAAA, CNAME, NS 레코드 유형을 기록합니다.
  3. 관리 화면의 충돌 오류 문구와 확인 시각을 기록합니다.

판정 기준

오류 문구가 일치해도 같은 원인이 확정되는 것은 아닙니다. 웹서버·런타임·운영체제·플랫폼과 최근 변경 사항을 비교하고, 기대한 관찰값이 나오지 않으면 다음 단계로 넘어가지 않습니다. 이 문서는 출처가 확인한 범위만 설명하며, 범위를 벗어난 원인과 조치는 단정하지 않습니다.

안전한 다음 확인

설정·권한·데이터를 변경하기 전에 백업과 되돌리기 방법을 기록합니다. 운영 환경의 방화벽 전체 해제, 인증서 검증 우회, 데이터 삭제, 비밀값 공개를 기본 조치로 사용하지 않습니다. 확인 결과가 문서의 조건과 다르면 관련 Platform·Component 문서와 공식 출처를 먼저 확인합니다.

참고 자료

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