커스텀 도메인 연결

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

이 문서의 나머지 부분에서는 다음 방법 중 하나로 커스텀 도메인을 연결하는 단계를 안내합니다.

• 도메인 이전
• 새 도메인 연결

서비스를 중단 없이 이용하려면 DNS 레코드를 특정 순서대로 업데이트해야 합니다. 안내에 따라 도메인을 이전하여 앱의 다운타임을 방지하세요.

웹 앱에 새로 연결하는 도메인과 같이 다운타임이 문제가 되지 않는 경우 새 도메인 연결 안내를 따르세요.

시작하기 전에: DNS 레코드 유형

App Hosting 도메인 설정 마법사에서는 도메인의 현재 구성에 따라 DNS 레코드를 1~5개 추가하거나 삭제하라는 메시지가 표시될 수 있습니다. 레코드의 유형에 따라 기능이 결정됩니다. App Hosting에서 요청할 수 있는 기록 유형은 다음과 같습니다.

유형	설명	독점
A	이러한 레코드에는 IPv4 값 (예: 8.8.8.8)이 포함되어 있으며, 이는 브라우저가 도메인에 연결하려고 할 때 사용할 주소를 알려줍니다.	예
AAAA	이러한 레코드에는 IPv6 값 (예: 2001:4860:4860::8888)이 포함되어 있으며, A 레코드와 거의 동일한 기능을 하는 다른 유형의 주소 레코드입니다. App Hosting에서는 현재 AAAA 레코드를 사용하지 않지만, 있는 경우 도메인에서 기존 레코드를 삭제하도록 요청합니다.	예
CNAME	이러한 레코드에는 DNS 쿼리를 확인하기 위해 현재 도메인 대신 사용해야 하는 별도의 도메인 이름이 포함되어 있습니다. CNAME 레코드는 하위 도메인 (예: www.example.com)에서만 허용됩니다. App Hosting에서는 다음과 같은 두 가지 이유로 CNAME 레코드를 사용합니다. 간편한 온보딩: 가능한 경우 App Hosting에서는 _custom-domain...로 시작하는 사전 구성된 도메인에 CNAME을 지정하도록 요청합니다. SSL 인증서 확인: App Hosting는 Cloud Certificate Manager를 사용하여 커스텀 도메인의 SSL 인증서를 프로비저닝합니다. _acme-challenge... 하위 도메인의 CNAME 레코드를 사용하면 인증서 관리자가 인증서를 만들고 갱신할 수 있습니다. 온보딩 후에는 이 레코드를 삭제해서는 안 됩니다. 그렇지 않으면 인증서 보증이 만료됩니다.	예
TXT	이러한 레코드를 사용하면 도메인에 임의의 메타데이터를 연결할 수 있습니다. App Hosting를 사용하면 TXT 레코드의 특정 형식인 fah-claim=[UUID]를 사용하여 도메인에서 제공해야 하는 맞춤 도메인을 나타낼 수 있습니다.	아니요
CAA	이러한 레코드는 도메인의 SSL 인증서를 민팅할 수 있는 인증 기관을 지정하는 허용 목록으로 작동합니다. App Hosting는 도메인의 인증서 민팅이 차단된 경우에만 CAA 레코드를 요청합니다.	아니요

시작하기 전에: 맞춤 도메인 이름

DNS 레코드를 추가하거나 수정할 때 서로 다른 도메인 제공업체의 DNS 관리 사이트 내 호스트 (또는 호스트 이름) 필드에는 서로 다른 입력 값을 입력해야 합니다. App Hosting 맞춤 도메인 마법사에서는 이름 필드에 동일한 값을 입력해야 합니다.

아래에 자주 사용되는 제공업체의 일반적인 입력 값이 정리되어 있습니다. 자세한 안내는 도메인 제공업체의 문서를 참고하세요.

도메인 유형	맞춤 도메인 이름
최상위 도메인	일반적인 입력 값은 다음과 같습니다. @ 최상위 도메인 이름(예: example.com) 호스트 필드 비우기
하위 도메인	일반적인 입력 값은 다음과 같습니다. 전체 하위 도메인 이름(예: app.example.com) 하위 도메인 부분만(예: .example.com을 제외한 app)

일반적인 도메인 제공업체

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

Cloudflare

호스트	입력
example.com.	@
www.example.com.	www

Google Cloud DNS

호스트	입력
example.com.	.example.com.
www.example.com.	www.example.com.

NameCheap

호스트	입력
example.com.	@
www.example.com.	www

Squarespace

호스트	입력
example.com.	@
www.example.com.	www

도메인 마이그레이션

다운타임 없이 다른 제공업체에서 App Hosting로 도메인을 이전하려면 Firebase Console에서 도메인 이전 흐름을 사용하면 됩니다. 이 흐름은 트래픽을 App Hosting 서버로 연결하기 전에 App Hosting가 도메인에서 콘텐츠를 제공할 수 있도록 준비하는 2단계 프로세스를 안내합니다.

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

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

2단계: 도메인 준비

1. 도메인 설정 마법사의 도메인 이전 탭을 선택합니다.
2. 첫 번째 단계인 도메인 준비의 안내를 따르세요. 여기에는 App Hosting가 원하는 백엔드를 제공하고 도메인에 보안 TLS 연결을 설정하는 데 필요한 변경사항이 포함되어 있습니다. 필수 레코드에 대해 다음 입력을 사용하여 DNS 제공업체에서 도메인의 레코드를 추가, 삭제, 저장합니다.
   • 이름: 레코드에 커스텀 도메인 이름을 입력합니다. 입력한 호스트는 콘텐츠를 제공할 도메인이며 이 도메인은 최상위 도메인 또는 하위 도메인일 수 있습니다. 도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름', '도메인'으로 표시할 수도 있습니다.
   • 레코드 유형: 제공된 DNS 레코드를 추가합니다.
   • 값: 제공된 값을 레코드에 할당합니다. 도메인 제공업체에 따라 이 용어를 '데이터', '지정 대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다. 값 필드의 콘텐츠는 레코드 유형에 따라 다릅니다. 예를 들어 TXT 레코드는 문자열입니다.
3. 레코드 확인을 선택합니다. App Hosting에서 도메인 공급업체에서 변경한 사항을 감지하려고 시도합니다. 변경사항이 전파되려면 최대 24시간이 소요될 수 있습니다. 백엔드 대시보드의 설정 > 도메인 보기에서 상태를 확인할 수 있습니다.

3단계: App Hosting로 안내

1. App Hosting에서 이전 단계의 레코드 업데이트를 확인하면 마법사가 마지막 App Hosting로 직접 연결 단계로 진행합니다. 이 단계에서는 도메인의 트래픽을 App Hosting 서버로 전달하기 위해 업데이트해야 하는 레코드를 표시합니다. 이전과 마찬가지로 필수 레코드에 대해 다음 입력을 사용하여 DNS 제공업체에서 도메인의 레코드를 추가, 삭제, 저장합니다.
   • 이름: 레코드에 커스텀 도메인 이름을 입력합니다. 입력한 호스트는 콘텐츠를 제공할 도메인이며 이 도메인은 최상위 도메인 또는 하위 도메인일 수 있습니다. 도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름', '도메인'으로 표시할 수도 있습니다.
   • 레코드 유형: 제공된 DNS 레코드를 추가합니다.
   • 값: 제공된 값을 레코드에 할당합니다. 도메인 제공업체에 따라 이 용어를 '데이터', '지정 대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다. 값 필드의 콘텐츠는 레코드 유형에 따라 다릅니다. 예를 들어 TXT 레코드는 문자열입니다.
2. 레코드 확인을 선택합니다. App Hosting에서 도메인 공급업체에서 변경한 사항을 감지하려고 시도합니다. 변경사항이 전파되려면 최대 24시간이 소요될 수 있습니다. 백엔드 대시보드의 설정 > 도메인 보기에서 상태를 확인할 수 있습니다.

새 도메인 연결

웹 앱에 새로 추가되는 도메인을 연결하는 경우와 같이 다운타임이 문제가 되지 않는다면 이 섹션의 안내를 따르세요.

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

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

2단계: DNS 레코드 확인

1. Firebase Console의 도메인 설정 마법사는 페이지를 Firebase App Hosting에 연결하기 위해 업데이트해야 하는 필수 레코드를 보여줍니다. 다음 입력을 사용해서 DNS 제공업체에서 사용자 도메인으로부터 레코드를 추가, 삭제, 저장합니다.
   • 이름: 레코드에 커스텀 도메인 이름을 입력합니다. 입력한 호스트는 콘텐츠를 제공할 도메인이며 이 도메인은 최상위 도메인 또는 하위 도메인일 수 있습니다. 도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름', '도메인'으로 표시할 수도 있습니다.
   • 레코드 유형: 제공된 DNS 레코드를 추가합니다.
   • 값: 제공된 값을 레코드에 할당합니다. 도메인 제공업체에 따라 이 용어를 '데이터', '지정 대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다. 값 필드의 콘텐츠는 레코드 유형에 따라 다릅니다. 예를 들어 TXT 레코드는 문자열입니다.
2. 레코드 확인을 선택합니다. App Hosting에서 도메인 공급업체에서 변경한 사항을 감지하려고 시도합니다. 변경사항이 전파되려면 최대 24시간이 소요될 수 있습니다. 백엔드 대시보드의 설정 > 도메인 보기에서 상태를 확인할 수 있습니다.

SSL 인증서 프로비저닝 대기

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

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

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

커스텀 도메인의 상태 설명

상태	설명
설정 필요	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 인증서가 있습니다. 사이트 콘텐츠를 제공할 수 있습니다.