커스텀 도메인 연결

Firebase App Hosting에 배포된 앱에 고유한 브랜드 중심 도메인 이름을 포기할 필요가 없습니다. Firebase 호스팅 사이트에 Firebase에서 생성된 도메인 대신 커스텀 도메인 (예: example.com 또는 app.example.com)을 사용할 수 있습니다. Firebase App Hosting은 각 도메인의 SSL 인증서를 프로비저닝합니다.

이 문서의 나머지 부분에서는 커스텀 도메인을 연결하는 단계를 설명합니다.

App Hosting용 도메인 설정

기본 App Hosting 설정 작업을 완료하여 Firebase 프로젝트에 Firebase App Hosting 사이트가 있는지 확인합니다.

1단계: 커스텀 도메인 추가

  1. 프로젝트의 App Hosting 페이지를 엽니다.
  2. 대시보드 보기 옵션을 사용하여 App Hosting 백엔드를 선택합니다.
  3. 설정 탭을 선택한 다음 커스텀 도메인 추가를 클릭합니다.
  4. App Hosting 사이트에 연결할 커스텀 도메인 이름을 입력합니다.
  5. (선택사항) 커스텀 도메인의 모든 요청을 지정된 두 번째 도메인으로 리디렉션하려면 체크박스를 선택합니다 (example.com과 www.example.com가 동일한 콘텐츠로 리디렉션됨).
  6. 계속을 클릭하여 DNS 레코드를 구성하고 커스텀 도메인 설정을 완료합니다.

2단계: 커스텀 도메인 설정

  1. Firebase Console의 커스텀 도메인 추가 마법사는 페이지가 Firebase 앱 호스팅을 가리키도록 업데이트해야 하는 필요한 레코드를 보여줍니다. 다음 입력을 사용하여 DNS 제공업체에서 도메인의 레코드를 추가, 삭제, 저장합니다.

    • 유형: 제공된 DNS 레코드를 추가합니다.

    • 호스트: 레코드의 커스텀 도메인 키를 입력합니다. 지정한 호스트는 콘텐츠를 제공하려는 도메인입니다. 이 도메인은 루트 도메인 또는 하위 도메인일 수 있습니다. 도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름' 또는 '도메인'으로 표시할 수도 있습니다.

    • 값: 제공된 값을 레코드에 할당합니다. 도메인 제공업체에 따라 이 용어를 '데이터', '대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다. 값 필드의 콘텐츠는 레코드 유형에 따라 다릅니다. TXT 레코드는 문자열입니다.

SSL 인증서가 프로비저닝되기를 기다립니다. DNS가 Firebase App Hosting을 가리키도록 설정한 후 최대 몇 시간이 걸릴 수 있습니다. 대부분의 경우 레코드 전파와 SSL 인증서 프로비저닝은 도메인 공급업체에 따라 1시간 이내에 완료됩니다.

SSL 인증서 프로비저닝 대기

DNS 레코드를 업데이트한 후 App Hosting에서 도메인의 SSL 인증서를 프로비저닝하는 데 최대 몇 시간이 걸릴 수 있습니다.

브라우저의 보안 도구를 사용하여 이 인증서를 볼 수 있습니다. 도메인이 프로비저닝되는 동안 잘못된 인증서가 표시되거나 도메인에 연결하는 데 문제가 발생할 수 있습니다. 이는 정상적인 절차 중 한 부분이며 도메인 인증서를 사용할 수 있게 되면 해결됩니다.

참고: Firebase App Hosting은 필요에 따라 커스텀 도메인에 SSL 인증서를 자동으로 다시 프로비저닝합니다.

커스텀 도메인 키

DNS 레코드를 추가하거나 수정할 때 도메인 제공업체마다 DNS 관리 사이트 내의 호스트 필드에 다른 입력을 입력해야 합니다. 아래에 자주 사용되는 제공업체의 일반적인 입력 값이 정리되어 있습니다. 자세한 안내는 도메인 제공업체의 문서를 참조하세요.

도메인 유형 커스텀 도메인 키
최상위 도메인

일반적인 입력 값은 다음과 같습니다.

  • @
  • 최상위 도메인 이름 (예: example.com)
  • 호스트 필드 비우기
하위 도메인

일반적인 입력 값은 다음과 같습니다.

  • 전체 하위 도메인 이름(예: app.example.com)
  • 하위 도메인 부분만 (예: app만 사용하고 .example.com은 제외)
  • www.example.com의 하위 도메인의 경우 www만

일반적인 도메인 제공업체

다음은 몇 가지 일반적인 도메인 제공업체 및 각 제공업체에 필요한 입력 유형입니다. 이 정보는 가능한 한 최신 상태로 유지되지만, 자세한 안내는 도메인 제공업체의 문서를 참조하세요.

커스텀 도메인에 대한 상태 설명

상태 설명
설정 필요

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

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

  • 드문 경우지만 DNS 레코드에 다른 호스팅 제공업체를 가리키는 A 레코드 또는 CNAME 레코드가 있어 SSL 요청이 실패할 수 있습니다.
    문제 해결 팁: A 레코드가 Firebase App Hosting만 가리키는지 확인하고 CNAME 레코드를 모두 삭제하세요.
대기중

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

경우에 따라 과도하게 제한적인 CAA 레코드로 인해 커스텀 도메인의 SSL 인증서 발급이 지연될 수 있습니다. 인증 기관 `letsencrypt.org` 및 `pki.goog` 가 도메인의 SSL 인증서를 만들 수 있는지 확인하세요.
인증서 민팅

SSL 인증서가 도메인에 대해 생성됩니다.
연결됨

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