Dengan Firebase Hosting, Anda tidak harus mengorbankan nama domain unik yang berkaitan erat dengan merek Anda. Anda dapat menggunakan domain kustom (seperti example.com atau app.example.com) untuk situs yang dihosting Firebase, tidak harus domain yang dihasilkan oleh Firebase.
Firebase Hosting akan menyediakan sertifikat SSL untuk setiap domain dan menayangkan konten Anda melalui CDN global.
Bagian selanjutnya dari dokumen ini akan memandu Anda menyelesaikan langkah-langkah untuk menghubungkan domain kustom Anda.
Menyiapkan domain Anda untuk Hosting
Pastikan Anda telah menyelesaikan wizard "Memulai" dari halaman Firebase Hosting project sehingga Anda memiliki situs Firebase Hosting di project Firebase.
Langkah 1: Tambahkan domain
Dari halaman Hosting project Anda, buka wizard untuk menghubungkan domain kustom:
Jika Anda hanya memiliki satu situs Hosting, klik Add custom domain.
Jika Anda memiliki lebih dari satu situs Hosting, klik View untuk situs yang diinginkan, lalu klik Add custom domain.
Masukkan nama domain kustom yang ingin Anda hubungkan ke situs Hosting.
(Opsional) Centang kotak untuk mengalihkan semua permintaan di domain kustom ke domain kedua yang ditentukan (sedemikian rupa sehingga example.com dan www.example.com mengarah ke konten yang sama).
Klik Lanjutkan untuk memulai proses validasi.
Langkah 2: Verifikasi kepemilikan domain
Jika diminta dalam wizard penyiapan Hubungkan Domain, verifikasi domain apex Anda.
Langkah-langkah ini memastikan bahwa domain Anda belum ditautkan dengan project Firebase dan bahwa Anda memiliki domain yang ditentukan.
Di situs penyedia domain Anda, cari halaman pengelolaan DNS.
Tambahkan dan simpan data baru yang menyertakan input berikut:
Type: Tambahkan data TXT.
Firebase Hosting mengharuskan Anda menyimpan data TXT ini secara terus-menerus di setelan DNS untuk membuktikan kepemilikan domain tersebut dan untuk mengizinkan Firebase menetapkan dan memperbarui sertifikat SSL untuk situs Anda.
Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Record Type".
Dengan membuktikan kepemilikan domain apex atau domain root, Anda membuktikan kepemilikan atas semua subdomainnya.
Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain".
Value: Salin nilai verifikasi unik ke dalam kolom.
Firebase Hosting memeriksa keberadaan nilai ini untuk membuktikan kepemilikan domain Anda.
Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Data".
Tunggu penerapan data TXT terbaru Anda hingga 24 jam, lalu klik Verifikasi.
Perhatikan bahwa Anda dapat mengklik Batal untuk menutup jendela Hubungkan Domain dengan aman dan membukanya kembali di lain waktu. Hal ini tidak memengaruhi waktu penerapan, tetapi Anda akan diminta untuk memasukkan kembali nama domain saat membuka jendela ini lagi.
Setelah cukup waktu penerapan, Anda dapat memulai proses penyediaan sertifikat SSL dengan mengklik Verifikasi di jendela Hubungkan Domain di Firebase Console.
Dalam kebanyakan kasus, penerapan data dan verifikasi domain Anda akan berlangsung selama beberapa jam, tergantung penyedia domain Anda. Lihat dokumentasi penyedia domain Anda untuk mendapatkan petunjuk terperinci mengenai cara menambahkan data TXT dan waktu penerapan.
Jika pesan error muncul setelah Verifikasi diklik, artinya data Anda belum diterapkan atau nilai Anda mungkin salah.
Langkah 3: Mulai menayangkan
Di jendela Connect Domain di Firebase console, pilih Quick Setup untuk situs baru atau Advanced Setup jika Anda sudah memiliki situs yang berjalan di penyedia hosting lain dan perlu migrasi tanpa periode nonaktif.
Penyiapan Cepat
Kembali ke situs pengelolaan DNS penyedia nama domain Anda untuk membuat data A DNS yang mengarahkan halaman Anda ke Firebase Hosting. Tambahkan dan simpan data dengan input berikut:
Host yang Anda nyatakan adalah domain tempat Anda ingin menayangkan konten, yang mungkin merupakan domain apex atau subdomain.
Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain".
Value: Tetapkan satu nilai ke setiap data A DNS untuk mengarahkan domain Anda ke alamat IP yang ditentukan.
Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Data", "Points To", "Content", "Address", atau "IP Address".
Tunggu proses penyediaan sertifikat SSL Anda selesai.
Ini bisa memakan waktu hingga 24 jam setelah Anda mengarahkan data A ke Firebase Hosting.
Dalam kebanyakan kasus, penerapan data dan penyediaan sertifikat SSL Anda akan berlangsung selama beberapa jam, tergantung penyedia domain Anda.
Penyiapan Lanjutan
Jendela Hubungkan Domain di Firebase console akan meminta Anda memberikan token untuk memigrasi situs yang sudah ada. Anda hanya perlu melakukan salah satu hal berikut untuk memberikan token:
Perbarui data TXT DNS: Kunjungi situs pengelolaan DNS penyedia domain Anda. Tambahkan data TXT dengan kunci domain dan nilai yang diberikan.
Tunggu penerapan data TXT Anda hingga 24 jam.
Upload file ke situs yang ada: Upload token ke situs Anda yang ada di URL yang ditentukan dan verifikasi keberadaannya.
Halaman ini harus ditayangkan melalui HTTPS dan tidak harus valid atau aman. Token terenkripsi hanya valid untuk satu kali percobaan. Jika migrasi gagal, token baru akan dibuat untuk data Anda.
Tunggu proses penyediaan sertifikat SSL Anda selesai.
Proses ini mungkin memerlukan waktu hingga 24 jam.
Dalam kebanyakan kasus, penerapan data dan penyediaan sertifikat SSL Anda akan berlangsung selama beberapa jam, tergantung penyedia domain Anda.
Setelah sertifikat SSL Anda tersedia, kembali ke situs pengelolaan DNS penyedia DNS untuk menambahkan data A DNS yang mengarahkan halaman Anda ke Firebase Hosting. Tambahkan dan simpan data dengan input berikut:
Host yang Anda nyatakan adalah domain tempat Anda ingin menayangkan konten, yang mungkin merupakan domain apex atau subdomain.
Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Host Name", "Name", atau "Domain".
Value: Tetapkan satu nilai ke setiap data A DNS untuk mengarahkan domain Anda ke alamat IP yang ditentukan.
Penyedia domain Anda dapat mencantumkan istilah ini sebagai "Data", "Points To", "Content", "Address", atau "IP Address".
Menunggu penyediaan sertifikat SSL
Setelah memverifikasi kepemilikan domain, kami menyediakan sertifikat SSL untuk domain Anda dan men-deploy di seluruh CDN global kami dalam waktu 24 jam setelah Anda mengarahkan data A DNS ke Firebase Hosting.
Domain Anda akan terdaftar sebagai Nama Alternatif Subjek (SAN) dalam sertifikat SSL FirebaseApp. Anda dapat melihat sertifikat ini menggunakan alat keamanan browser. Saat domain disediakan, Anda mungkin melihat sertifikat tidak valid yang tidak menyertakan nama domain Anda. Ini adalah bagian proses yang normal dan akan teratasi setelah sertifikat domain Anda tersedia.
Situs milik pengguna dengan Penyiapan Lanjutan akan dihosting oleh penyedia hosting sebelumnya hingga status penyiapan di halaman Firebase Hosting project berubah menjadi Terhubung.
Kunci domain kustom Anda
Saat data DNS ditambahkan atau diedit, input yang Anda masukkan pada kolom Host di situs pengelolaan DNS dapat berbeda-beda di setiap penyedia domain. Kami telah mengumpulkan input umum dari penyedia populer di bawah ini.
Lihat dokumentasi penyedia domain Anda untuk mendapatkan petunjuk terperinci.
Jenis domain
Kunci domain kustom
Domain apex
Input umum meliputi:
@
Nama domain apex (misalnya, example.com)
Membiarkan kolom Host kosong.
Subdomain
Input umum meliputi:
Nama subdomain lengkap (misalnya, app.example.com)
Hanya bagian subdomain (misalnya, app saja, tanpa menyertakan .example.com)
Hanya www untuk subdomain www.example.com
Penyedia domain umum
Berikut adalah beberapa penyedia domain umum dan jenis input yang mungkin diperlukan setiap penyedia domain.
Informasi ini sebisa mungkin selalu diperbarui, tetapi lihat dokumentasi penyedia domain Anda untuk petunjuk terperinci.
Cloudflare
Type
Host
Value
input data TXT DNS
TXT
example.com
nilai verifikasi yang disediakan di Firebase console
input data A DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
Google Domains
Type
Host
Value
input data TXT DNS
TXT
@
nilai verifikasi yang disediakan di Firebase console
input data A DNS
A
@
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
Type
Host
Value
input data TXT DNS
TXT
example.com
nilai verifikasi yang disediakan di Firebase console
input data A DNS
A
example.com
199.36.158.100
A
www
199.36.158.100
NameCheap
Type
Host
Value
input data TXT DNS
TXT
@
nilai verifikasi yang disediakan di Firebase console
input data A DNS
A
@
199.36.158.100
A
@
199.36.158.100
Squarespace
Type
Host
Value
input data TXT DNS
TXT
@
nilai verifikasi yang disediakan di Firebase console
input data A DNS
A
@
199.36.158.100
A
www
199.36.158.100
Deskripsi status penyiapan untuk domain kustom
Status
Deskripsi
Perlu penyiapan
Anda mungkin perlu mengubah konfigurasi dengan data DNS Anda.
Pada kebanyakan kasus, data A DNS Anda belum diterapkan dari penyedia nama domain ke server Firebase Hosting.
Tips pemecahan masalah: Jika sudah lebih dari 24 jam, pastikan bahwa Anda telah mengarahkan data ke Firebase Hosting.
Pada kasus yang lebih jarang terjadi, terutama jika Anda menggunakan alur Penyiapan Lanjutan, tantangan SSL mungkin akan gagal karena:
Data DNS Anda memiliki data A atau data CNAME yang mengarah ke penyedia hosting lain.
Tips pemecahan masalah: Pastikan data A Anda hanya mengarah ke Firebase Hosting, dan hapus semua data CNAME.
Migrasi gagal, dan token (data TXT DNS atau file yang diupload dan diberikan ke situs Anda) sudah tidak valid.
Tips pemecahan masalah: Klik Lihat untuk domain tersebut, lalu berikan token baru ke domain Anda yang ada.
Tertunda
Anda menyiapkan domain kustom dengan benar, tetapi Firebase Hosting belum menyediakan sertifikat SSL.
Terkadang, masalah berikut dapat menghentikan pembuatan sertifikat SSL untuk suatu domain kustom:
Pembatasan data CAA Anda terlalu ketat.
Tips pemecahan masalah: Pastikan certificate authority `letsencrypt.org` dan `pki.goog` diizinkan membuat sertifikat SSL untuk domain Anda.
Kode tantangan tidak valid. Jika Anda menggunakan alur Penyiapan Lanjutan dan migrasi gagal, token Anda (serta kode tantangannya) akan menjadi tidak valid.
Tips pemecahan masalah: Klik Lihat untuk domain tersebut, lalu berikan token baru ke domain Anda yang ada.
Anda meminta sertifikat untuk terlalu banyak subdomain.
Tips pemecahan masalah: Secara umum, Firebase Hosting merekomendasikan tidak lebih dari 20 subdomain di satu domain kustom apex, karena adanya batas pembuatan sertifikat SSL.
Terhubung
Domain kustom Anda memiliki data DNS yang sesuai dan memiliki sertifikat SSL.
Anda dapat menayangkan konten situs.
Perlu Verifikasi Ulang
Firebase mungkin meminta Anda untuk memverifikasi ulang kepemilikan domain secara manual jika data TXT yang ditambahkan saat Anda memverifikasi kepemilikan domain telah diubah atau dihapus dari setelan DNS domain Anda.
Perhatikan bahwa beberapa data TXT dengan token verifikasi situs google diizinkan pada satu domain.
Data TXT harus selalu ada di setelan DNS untuk membuktikan kepemilikan Anda atas domain tersebut dan mengizinkan kami untuk menetapkan dan memperpanjang sertifikat SSL untuk situs Anda.
Tips pemecahan masalah: Buka halaman Hosting project Anda untuk menyelesaikan proses verifikasi ulang dalam rentang waktu yang ditentukan (biasanya 30 hari) agar domain kustom Anda tidak diputus secara otomatis dari Firebase Hosting.