Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

사용자 지정 도메인 연결

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Firebase 호스팅을 사용하면 브랜드 중심의 고유한 도메인 이름을 포기할 필요가 없습니다. Firebase 호스팅 사이트에 Firebase 생성 도메인 대신 맞춤 도메인(예: example.com 또는 app.example.com )을 사용할 수 있습니다.

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

이 문서의 나머지 부분에서는 사용자 지정 도메인을 연결하기 위한 이러한 단계를 안내합니다.

호스팅을 위한 도메인 설정

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

1단계 : 도메인 추가

  1. 프로젝트의 호스팅 페이지 에서 맞춤 도메인을 연결하기 위한 마법사를 입력합니다.

    • 호스팅 사이트가 하나만 있는 경우 맞춤 도메인 추가 를 클릭합니다.
    • 호스팅 사이트가 두 개 이상인 경우 원하는 사이트에 대해 보기 를 클릭한 다음 맞춤 도메인 추가 를 클릭합니다.

  2. 호스팅 사이트에 연결할 사용자 정의 도메인 이름을 입력하십시오.

  3. (선택 사항) 맞춤 도메인의 모든 요청을 지정된 두 번째 도메인으로 리디렉션하려면 확인란을 선택합니다(예: example.com 및 www.example.com 이 동일한 콘텐츠로 리디렉션됨).

  4. 계속 을 클릭하여 유효성 검사 프로세스를 시작합니다.

2단계 : 도메인 소유권 확인

도메인 연결 설정 마법사에서 요청하는 경우 apex 도메인을 확인합니다.

이러한 단계를 통해 도메인이 이미 Firebase 프로젝트에 연결되어 있지 않고 지정된 도메인을 소유하고 있는지 확인할 수 있습니다.

  1. 도메인 공급자의 사이트에서 DNS 관리 페이지를 찾습니다.

  2. 다음 입력을 사용하여 새 레코드를 추가하고 저장합니다.

    • 유형 : TXT 레코드를 추가합니다.

      Firebase 호스팅을 사용하려면 DNS 설정에 이 TXT 레코드를 지속적으로 유지하여 도메인 소유권을 증명하고 Firebase가 사이트에 대한 SSL 인증서를 할당 및 갱신하도록 승인해야 합니다.

      귀하의 도메인 공급자는 이 용어를 "레코드 유형"으로 나열할 수 있습니다.

    • 호스트 : apex 도메인 키 를 입력합니다.

      apex 도메인 또는 루트 도메인의 소유권을 증명하면 모든 하위 도메인의 소유권이 증명됩니다.

      귀하의 도메인 공급자는 이 용어를 "호스트 이름", "이름" 또는 "도메인"으로 나열할 수 있습니다.

    • 값 : 고유한 검증 값을 필드에 복사합니다.

      Firebase 호스팅은 이 값을 확인하여 도메인 소유권을 증명합니다.

      귀하의 도메인 공급자는 이 용어를 "데이터"로 나열할 수 있습니다.

  3. 업데이트된 TXT 레코드가 전파될 때까지 최대 24시간을 기다린 다음 확인 을 클릭합니다.

    취소 를 클릭하여 도메인 연결 창을 안전하게 닫고 나중에 다시 열 수 있습니다. 이는 전파 시간에 영향을 미치지 않지만 창을 다시 열 때 도메인 이름을 다시 입력 하라는 메시지가 표시됩니다.

    충분한 전파 시간이 지난 후 Firebase 콘솔의 도메인 연결 창에서 확인 을 클릭하면 SSL 인증서 프로비저닝 프로세스를 시작할 수 있습니다.

    대부분의 경우 레코드 전파 및 도메인 확인은 도메인 공급자에 따라 몇 시간 내에 이루어집니다. TXT 레코드 및 전파 시간 추가에 대한 자세한 지침은 도메인 공급자의 설명서를 참조하십시오.

    확인 을 클릭할 때 오류 메시지가 나타나면 레코드가 전파되지 않았거나 값이 올바르지 않을 수 있습니다.

3단계 : 실시간 스트리밍

Firebase 콘솔의 도메인 연결 창에서 새 사이트에 대한 빠른 설정 을 선택하거나 이미 다른 호스팅 제공업체에서 실행 중인 사이트가 있고 다운타임 없는 마이그레이션이 필요한 경우 고급 설정 을 선택합니다.

SSL 인증서 프로비저닝 대기

도메인 소유권을 확인한 후 DNS A 레코드를 Firebase 호스팅으로 지정한 후 24시간 이내에 도메인에 대한 SSL 인증서를 프로비저닝하고 글로벌 CDN에 배포합니다.

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

고급 설정 사용자의 경우 프로젝트의 Firebase 호스팅 페이지 설정 상태 가 연결됨 으로 업데이트될 때까지 이전 호스팅 제공업체에서 웹사이트를 호스팅합니다.

사용자 지정 도메인 키

DNS 레코드를 추가하거나 편집할 때 다른 도메인 공급자는 DNS 관리 사이트 내에서 호스트 필드에 대해 다른 입력을 입력할 것으로 예상합니다. 아래에 인기 있는 제공업체의 일반적인 입력 내용을 정리했습니다. 자세한 지침은 도메인 공급자의 설명서를 참조하십시오.

도메인 유형 맞춤 도메인 키
에이펙스 도메인

일반적인 입력에는 다음이 포함됩니다.

  • @
  • apex 도메인 이름(예: example .com )
  • 호스트 필드를 비워두기
하위 도메인

일반적인 입력에는 다음이 포함됩니다.

  • 전체 하위 도메인 이름(예: app. example .com )
  • 하위 도메인 부분만(예: app , . example .com 제외)
  • www 의 하위 도메인에 대한 www. example .com

일반 도메인 공급자

다음은 몇 가지 일반적인 도메인 공급자와 각각 필요할 수 있는 입력 유형입니다. 이 정보는 가능한 한 최신 상태로 유지되지만 자세한 지침은 도메인 공급자의 설명서를 참조하십시오.

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

상태 설명
설정 필요

DNS 레코드로 구성을 변경해야 할 수도 있습니다.

  • 대부분의 경우 DNS A 레코드는 도메인 이름 공급자에서 Firebase 호스팅 서버로 전파되지 않았습니다.
    문제 해결 팁: 24시간이 지난 경우 레코드가 Firebase 호스팅을 가리키고 있는지 확인하십시오.

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

    • DNS 레코드에는 다른 호스팅 공급자를 가리키는 A 레코드 또는 CNAME 레코드가 있습니다.
      문제 해결 도움말: A 레코드가 Firebase 호스팅만 가리키는지 확인하고 모든 CNAME 레코드를 삭제하세요.
    • 이전에 실패했으며 토큰(사이트에 제공된 DNS TXT 레코드 또는 업로드된 파일)이 이제 유효하지 않습니다.
      문제 해결 팁: 도메인에 대해 보기 를 클릭한 다음 기존 도메인에 새 토큰을 제공하십시오.
보류 중

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

경우에 따라 다음 문제로 인해 사용자 지정 도메인에 대한 SSL 인증서 생성이 중단될 수 있습니다.

  • CAA 레코드가 너무 제한적입니다.
    문제 해결 팁: 인증 기관 `letsencrypt.org` 및 `pki.goog`가 도메인에 대한 SSL 인증서를 생성하도록 허용되었는지 확인하십시오.
  • 귀하의 챌린지 코드가 유효하지 않습니다.
    고급 설정 흐름을 사용 중이고 마이그레이션에 실패한 경우 이제 토큰(및 해당 챌린지 코드)이 유효하지 않습니다.
    문제 해결 팁: 도메인에 대해 보기 를 클릭한 다음 기존 도메인에 새 토큰을 제공하십시오.
  • 너무 많은 하위 도메인에 대한 인증서를 요청했습니다.
    문제 해결 팁: 일반적으로 Firebase 호스팅은 SSL 인증서 발행 제한으로 인해 하나의 apex 커스텀 도메인에 20개 이하의 하위 도메인을 권장합니다.
연결됨

사용자 지정 도메인에 적절한 DNS 레코드와 SSL 인증서가 있습니다.
사이트의 콘텐츠를 제공할 수 있습니다.

재확인 필요

다음과 같은 상황이 발생하면 Firebase에서 수동으로 도메인 소유권을 다시 확인하도록 요구할 수 있습니다.

  • 도메인 소유권을 처음 확인 했을 때 추가된 TXT 레코드가 변경되었거나 도메인의 DNS 설정에서 제거되었습니다.
    • google-site-verification 토큰이 있는 여러 TXT 레코드는 단일 도메인에서 허용됩니다.
    • TXT 레코드는 귀하의 DNS 설정에 지속적으로 존재해야 합니다. 이는 귀하가 도메인을 소유하고 있음을 증명하고 귀하의 사이트에 대한 SSL 인증서를 할당 및 갱신하도록 당사에 권한을 부여하기 때문입니다.
  • 도메인 소유권을 확인한 사람에게는 도메인 소유권을 확인하는 데 필요한 권한이 포함된 IAM 역할 이 더 이상 할당되지 않습니다. 이러한 역할에는 소유자, 편집자, Firebase 관리자 및 Firebase 개발 관리자가 포함됩니다.
문제 해결 팁: 사용자 정의 도메인이 Firebase 호스팅에서 자동으로 연결 해제되지 않도록 프로젝트의 호스팅 페이지 를 방문하여 지정된 기간(일반적으로 30일) 내에 재확인 프로세스를 완료하세요.