White Label DNS 문제 해결

대부분의 White Label Lite DNS 문제는 네 가지 중 하나입니다. 레코드가 없거나, 레코드 값이 브랜딩 표와 다르거나, 프록시가 활성화되어 있거나, 인증서 단계에 조치가 필요합니다.

도메인의 브랜딩 탭에 있는 브랜드용 DNS 표부터 확인하세요. 이 표가 호스트 이름과 대상 값의 정확한 기준입니다. 오래된 문서, 다른 계정 또는 DNS 확인 도구에서 CNAME 대상을 복사하지 마세요.

빠른 해결 방법

1. 브랜딩을 열고 문제가 있는 주소의 호스트, 유형 및 값을 복사합니다.
2. 실제 DNS 영역을 호스팅하는 DNS 제공업체에서 해당 레코드를 만들거나 수정합니다.
3. 제공업체에 프록시 스위치가 있으면 레코드를 DNS 전용으로 유지합니다.
4. 브랜딩으로 돌아가 DNS 확인을 선택합니다. 상태가 활성일 때만 주소를 공유하세요.

터미널 없이 DNS 확인하기

다른 문제를 조사하기 전에 DNS 제공업체의 레코드와 브랜딩의 행을 비교하세요.

• 호스트 또는 이름
• 유형. 브랜드 대시보드 또는 웹메일 호스트는 CNAME입니다.
• 값 또는 대상
• 프록시 설정. Cloudflare의 브랜드 호스트는 반드시 꺼야 합니다.

레코드를 저장한 뒤 브랜딩에서 DNS 확인을 사용하세요. 새 확인 작업이 대기열에 추가되고 페이지에 결과 상태가 표시됩니다.

독립적으로 확인하려면 공개 DNS 조회 서비스를 사용하거나 DNS 제공업체에 전체 호스트 이름을 CNAME으로 조회해 달라고 요청하세요. 응답은 브랜딩의 현재 값 필드와 정확히 일치해야 합니다. 공개 확인 도구는 자체 관측 결과를 확인할 수 있지만 플랫폼의 활성 상태를 대신할 수 없습니다.

설정을 완료하는 데 터미널은 필요하지 않습니다. 터미널을 사용한다면 전체 호스트 이름을 조회하고 반환된 CNAME을 브랜딩에 표시된 값과 비교하세요.

상태가 "DNS 대기"인 경우

DNS 대기는 플랫폼이 해당 호스트에 필요한 레코드를 아직 찾지 못했다는 뜻입니다. 레코드를 수정한 뒤 DNS 확인을 선택하고, 상태가 갱신되면 브랜딩 탭으로 돌아오세요. 다음을 순서대로 확인합니다.

잘못된 DNS 제공업체를 수정했습니다. 어떤 제공업체가 도메인 DNS의 권한을 갖는지 확인하세요. 등록기관의 패널을 수정하고 있지만 실제 DNS 영역은 다른 곳에 호스팅되어 있을 수 있습니다.

CNAME 대상이 현재 값이 아닙니다. 브랜딩 표에서 값 또는 대상을 복사하세요. 같은 호스트 이름의 이전 충돌 레코드는 다른 서비스에서 사용하지 않는다고 확인한 뒤에만 삭제합니다.

레코드 유형이 잘못되었습니다. 대시보드 또는 웹메일 호스트에는 브랜딩에 표시된 CNAME 레코드가 필요합니다. 같은 호스트 이름의 A 또는 AAAA 레코드가 예상 결과를 방해할 수 있습니다.

호스트 이름 형식이 잘못되었습니다. 일부 제공업체는 dashboard 같은 접두사만 요구하고 다른 곳은 전체 호스트 이름을 요구합니다. 제공업체의 필드 안내를 따르고 생성된 레코드를 브랜딩의 호스트와 비교하세요.

레코드가 일치한다면 그대로 두고 DNS 확인을 다시 사용하세요. 올바른 레코드를 반복해서 변경하면 모든 DNS 확인자가 같은 응답을 확인할 때까지 걸리는 시간이 늘어날 수 있습니다.

Cloudflare 주황색 구름이 SSL 프로비저닝을 방해하는 경우

Cloudflare를 DNS 제공업체로 사용하면 각 레코드 옆에 구름 아이콘이 표시됩니다. 주황색 구름은 Cloudflare가 요청을 프록시한다는 뜻입니다. 플랫폼에서 확인하고 인증서를 발급할 수 있도록 브랜드 대시보드 또는 웹메일 CNAME은 DNS 전용이어야 합니다.

해결 방법: 문제가 있는 브랜드 호스트의 CNAME 옆 구름이 회색이 될 때까지 선택한 뒤 레코드를 저장하세요. 브랜딩으로 돌아가 DNS 확인을 선택합니다.

이는 브랜드 호스트 레코드에 적용되며 도메인의 다른 모든 레코드에 자동으로 적용되는 것은 아닙니다. 다른 제공업체에 프록시 또는 CDN 스위치가 있다면 브랜딩 표에 다른 지시가 없는 한 해당 CNAME에서 끄세요.

상태가 "SSL을 발급할 수 없음"이고 CAA를 언급하는 경우

CAA 레코드는 도메인의 인증서를 발급할 수 있는 조직을 인증서 제공업체에 알려 줍니다. 브랜딩 상태나 지원팀이 CAA를 방해 요인으로 명확히 지정한 경우에만 변경하세요.

CNAME은 그대로 두고 도메인에 CAA 레코드가 이미 있는지 확인하세요. DNS 제공업체에서 확인하거나 독립 DNS 조회를 통해 루트 도메인을 조회할 수 있습니다.

플랫폼의 인증서 발급자를 허용해야 한다면 지원팀이 제공하거나 현재 제품 안내에 표시된 정확한 CAA 값을 추가하세요. 이 단계를 통과하려고 관련 없는 CAA 항목을 삭제하지 마세요. 여러 CAA 레코드가 함께 존재할 수 있습니다.

현재 인증서 과정에서는 일반적으로 다음 값이 필요합니다.

Type: CAA
Host: @
Value: 0 issue "letsencrypt.org"

CAA 레코드가 없다면 예방 목적으로 추가하지 마세요. CAA를 변경한 뒤 브랜딩으로 돌아가 DNS 확인을 선택합니다.

상태가 "SSL을 발급할 수 없음"이고 이유가 없는 경우

CNAME이 이미 올바를 수 있습니다. 반복해서 삭제하고 다시 만들지 마세요. 대신 다음을 수행합니다.

1. 레코드가 브랜딩의 호스트 및 대상과 계속 일치하고 프록시되지 않는지 확인합니다.
2. DNS 확인을 한 번 선택합니다.
3. 상태가 그대로라면 호스트 이름, 표시된 상태 및 DNS 레코드 스크린샷과 함께 지원팀에 문의하세요.

이미 올바른 CNAME을 수정해서 인증서 문제를 해결할 수는 없습니다. DNS 제공업체 자격 증명을 공개하지 않아도 지원팀에서 플랫폼 측 결과를 검토할 수 있습니다.

활성 상태였던 도메인의 상태가 바뀐 경우

호스트가 활성이면 서비스를 제공할 준비가 된 것입니다. 나중에 상태가 바뀐다면 다음을 확인하세요.

• 다시 "DNS 대기": 현재 CNAME을 브랜딩 표와 비교합니다. 레코드가 변경 또는 삭제되었거나 프록시를 사용하기 시작했을 수 있습니다.
• "SSL을 발급할 수 없음": 일치하는 CNAME을 유지하고 DNS 확인을 선택한 뒤 상태가 계속되면 지원팀에 문의합니다.
• 끄기: 해당 도메인의 브랜딩이 꺼졌거나 White Label 구독이 비활성 상태인지 확인합니다. 둘 다 아니라면 지원팀에 문의하세요.

일반적인 상황

"CNAME을 변경했지만 상태가 계속 대기 중입니다." 권한 있는 DNS 제공업체를 수정했는지, 새 CNAME이 브랜딩과 정확히 일치하는지 확인하세요. 그런 다음 DNS 확인을 사용합니다. 확인이 진행 중일 때 값을 계속 바꾸지 마세요.

"이전 제공업체에서 기존 CNAME을 삭제했지만 새 레코드를 찾지 못합니다." DNS 제공업체를 변경했다면 등록기관에서 도메인을 새 제공업체의 네임 서버로 위임했는지 확인하세요. 그렇지 않다면 권한 있는 DNS 영역을 호스팅하는 제공업체에 레코드 확인을 요청하세요.

"기본 사이트에서 프록시를 사용합니다. 브랜드 호스트도 사용할 수 있나요?" 브랜드 CNAME은 DNS 전용으로 유지하세요. 브랜딩의 특정 호스트가 프록시되지 않는 한 도메인의 나머지 부분은 자체 프록시 설정을 사용할 수 있습니다.

"와일드카드 CNAME을 사용할 수 있나요?" 브랜딩에 표시된 구체적인 호스트 이름을 구성하세요. 그러면 플랫폼이 명확한 주소를 확인하고 테스트할 수 있습니다. 표에 나온 호스트를 와일드카드 레코드로 대체하지 마세요.

"다른 하위 도메인을 사용하고 싶습니다." 도메인의 브랜딩 탭에서 레이블을 변경하고 한 번에 호스트 하나씩 저장하세요. 표에서 새 CNAME을 복사하고, 새 호스트가 활성이 된 뒤에만 테스트하며, 고객 전환을 완료할 때까지 이전 고객 주소를 유지하세요.

"한 네트워크에서 새 레코드를 볼 수 없습니다." 다른 네트워크에서 테스트하거나 영향을 받는 고객에게 나중에 다시 시도하도록 요청하세요. 브랜딩 표에 활성이 표시되고 다른 곳에서 호스트가 작동한다면 남은 지연은 해당 네트워크의 DNS 캐시 때문일 가능성이 큽니다.

다음 단계

• White Label Lite 설정하기: 설정 중이라면 원래 설정 단계 확인
• White Label Lite 요금 FAQ: 결제 관련 질문
• White Label Lite 해지하기: 해지할 때 도메인에 일어나는 일
• 권장 DNS 레코드: TrekMail에서 사용하는 DNS 레코드의 전체 내용

여전히 해결되지 않으면 호스트 이름, 브랜딩의 정확한 상태, DNS 제공업체 및 레코드 스크린샷과 함께 지원 티켓을 여세요. DNS 제공업체 암호나 API 토큰을 보내지 마세요.