Firebase App Hosting에 배포된 앱에 고유한 브랜드 중심 도메인 이름을 포기할 필요가 없습니다. Firebase 호스팅 사이트에 Firebase에서 생성된 도메인 대신 커스텀 도메인 (예: example.com
또는 app.example.com
)을 사용할 수 있습니다. Firebase App Hosting은 각 도메인의 SSL 인증서를 프로비저닝합니다.
이 문서의 나머지 부분에서는 커스텀 도메인을 연결하는 단계를 설명합니다.
App Hosting용 도메인 설정
기본 App Hosting 설정 작업을 완료하여 Firebase 프로젝트에 Firebase App Hosting 사이트가 있는지 확인합니다.
1단계: 커스텀 도메인 추가
- 프로젝트의 App Hosting 페이지를 엽니다.
- 대시보드 보기 옵션을 사용하여 App Hosting 백엔드를 선택합니다.
- 설정 탭을 선택한 다음 커스텀 도메인 추가를 클릭합니다.
- App Hosting 사이트에 연결할 커스텀 도메인 이름을 입력합니다.
- (선택사항) 커스텀 도메인의 모든 요청을 지정된 두 번째 도메인으로 리디렉션하려면 체크박스를 선택합니다 (
example.com
과www.example.com
가 동일한 콘텐츠로 리디렉션됨). - 계속을 클릭하여 DNS 레코드를 구성하고 커스텀 도메인 설정을 완료합니다.
2단계: 커스텀 도메인 설정
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 관리 사이트 내의 호스트 필드에 다른 입력을 입력해야 합니다. 아래에 자주 사용되는 제공업체의 일반적인 입력 값이 정리되어 있습니다. 자세한 안내는 도메인 제공업체의 문서를 참조하세요.
도메인 유형 | 커스텀 도메인 키 |
---|---|
최상위 도메인 |
일반적인 입력 값은 다음과 같습니다.
|
하위 도메인 | 일반적인 입력 값은 다음과 같습니다.
|
일반적인 도메인 제공업체
다음은 몇 가지 일반적인 도메인 제공업체 및 각 제공업체에 필요한 입력 유형입니다. 이 정보는 가능한 한 최신 상태로 유지되지만, 자세한 안내는 도메인 제공업체의 문서를 참조하세요.
커스텀 도메인에 대한 상태 설명
상태 | 설명 |
---|---|
설정 필요 |
DNS 레코드를 사용하여 구성을 변경해야 할 수 있습니다.
|
대기중 | 커스텀 도메인을 올바르게 설정했지만 Firebase App Hosting에서 SSL 인증서를 프로비저닝하지 않았습니다. 경우에 따라 과도하게 제한적인 CAA 레코드로 인해 커스텀 도메인의 SSL 인증서 발급이 지연될 수 있습니다. 인증 기관 `letsencrypt.org` 및 `pki.goog` 가 도메인의 SSL 인증서를 만들 수 있는지 확인하세요. |
인증서 민팅 | SSL 인증서가 도메인에 대해 생성됩니다. |
연결됨 | 커스텀 도메인에 올바른 DNS 레코드와 SSL 인증서가 있습니다. |