콘솔로 이동

커스텀 도메인 연결

맞춤 도메인(example.com 또는 myrealtimeapp.example.com)을 Firebase 호스팅 사이트에 연결할 수 있습니다.

Firebase 호스팅은 각 도메인의 SSL 인증서를 프로비저닝하고 글로벌 CDN을 통해 콘텐츠를 제공합니다.

일반적으로 Firebase 호스팅에서는 SSL 인증서 발급 제한 때문에 최상위 맞춤 도메인 하나에 하위 도메인을 20개 이하로 설정하는 것이 좋습니다.

호스팅용 도메인 설정

Firebase 프로젝트에서 Firebase 호스팅 사이트를 사용하려면 프로젝트의 Firebase 호스팅 페이지에서 '시작하기' 마법사를 완료했는지 확인하세요.

  1. 프로젝트의 호스팅 페이지에서 맞춤 도메인에 연결하기 위해 마법사로 들어갑니다.

    • 호스팅 사이트가 하나만 있는 경우 도메인 연결을 클릭합니다.
    • 호스팅 사이트가 2개 이상 있는 경우 원하는 사이트의 를 클릭한 후 도메인 연결을 클릭합니다.
  2. 호스팅 사이트에 연결하려는 맞춤 도메인을 입력합니다.

  3. (선택사항) 맞춤 도메인의 모든 요청을 지정된 두 번째 도메인으로 리디렉션하려면 체크박스를 선택합니다.

  4. 계속을 클릭하여 검증 프로세스를 시작합니다. 그런 다음 요청이 있으면 설정 마법사의 안내에 따라 도메인 소유권을 확인합니다.

    이러한 단계를 통해 도메인을 Firebase 프로젝트에 아직 연결한 적이 없고, 지정된 도메인을 소유하고 있음을 확인합니다.

  5. 맞춤 도메인 설정을 완료하려는 대부분의 경우에 빠른 설정 모드를 사용할 수 있습니다.

    하지만 다른 호스팅 제공업체에서 이미 실행 중인 사이트를 다운타임 없이 마이그레이션하려면 설정 모드 드롭다운 목록에서 고급 설정을 선택합니다.

    • 빠른 설정 — 도메인의 DNS A 레코드가 Firebase 호스팅을 가리키도록 설정합니다.

    • 고급 설정 — 화면 안내에 따라 도메인의 DNS TXT 레코드를 업데이트하거나 기존 사이트의 지정된 위치로 파일을 업로드합니다. 인증이 완료된 후 DNS A 레코드가 Firebase 호스팅을 가리키도록 설정해도 문제가 없습니다.

  6. DNS A 레코드가 Firebase 호스팅을 가리키도록 설정한 후 24시간 내에 Firebase는 SSL 인증서를 프로비저닝합니다.

맞춤 도메인에 대한 설정 상태 설명

상태 설명
설정 필요

DNS 레코드를 사용하여 구성을 변경해야 할 수 있습니다.

  • 대부분은 DNS A 레코드가 도메인 이름 제공업체에서 Firebase 호스팅 서버로 전파되지 않은 경우입니다.
    문제해결 팁: 24시간이 지난 경우 레코드가 Firebase 호스팅을 가리키도록 설정되었는지 확인하세요.

  • 드물지만 특히 고급 설정 과정을 사용하는 경우에 다음과 같은 이유로 SSL 챌린지가 실패할 수 있습니다.

    • DNS 레코드의 A 레코드 또는 CNAME 레코드가 다른 호스팅 제공업체를 가리킵니다.
      문제해결 팁: A 레코드가 Firebase 호스팅만 가리키는지 확인하고 CNAME 레코드를 모두 삭제하세요.
    • 마이그레이션할 수 없고 토큰(사이트에 제공한 DNS TXT 레코드 또는 업로드된 파일)이 현재 유효하지 않습니다.
      문제해결 팁: 도메인에 대한 를 클릭한 후 기존 도메인에 새 토큰을 제공하세요.
대기중

맞춤 도메인을 올바르게 설정했지만 Firebase 호스팅이 SSL 인증서를 프로비저닝하지 않았습니다.

경우에 따라 다음 문제 때문에 맞춤 도메인의 SSL 인증서 발급이 지연될 수 있습니다.

  • CAA 레코드가 지나치게 제한적입니다.
    문제해결 팁: 인증 기관인 Let's Encrypt가 도메인의 SSL 인증서를 만들 수 있도록 설정되어 있는지 확인하세요.
  • 챌린지 코드가 잘못되었습니다.
    고급 설정 과정을 사용 중이고 마이그레이션할 수 없으면 토큰 및 토큰의 챌린지 코드가 유효하지 않습니다. 문제해결 팁: 도메인에 대한 를 클릭한 후 기존 도메인에 새 토큰을 제공하세요.
  • 너무 많은 하위 도메인에 대해 인증서를 요청했습니다.
    문제해결 팁: 일반적으로 Firebase 호스팅에서는 SSL 인증서 발급 제한 때문에 루트 커스텀 도메인 하나에 하위 도메인을 20개 이하로 설정하는 것이 좋습니다.
연결됨

맞춤 도메인에 올바른 DNS 레코드와 SSL 인증서가 있습니다.
사이트 콘텐츠를 제공할 수 있습니다.

SSL 인증서 프로비저닝 대기

도메인 소유권이 확인되면 도메인의 SSL 인증서가 프로비저닝되어 글로벌 CDN을 통해 배포됩니다. 이 절차는 몇 시간이 걸릴 수 있지만 프로젝트의 Firebase 호스팅 페이지에서 진행률 메시지를 확인할 수 있습니다.

FirebaseApp SSL 인증서에 도메인이 주체 대체 이름(SAN) 중 하나로 표시됩니다. 브라우저의 보안 도구를 사용하면 이 인증서를 볼 수 있습니다. 도메인이 프로비저닝되는 동안 도메인 이름이 포함되지 않는 잘못된 인증서가 표시될 수 있습니다. 이는 정상적인 절차 중 한 부분이며 도메인 인증서를 사용할 수 있게 되면 해결됩니다.