Ikuti semua informasi yang diumumkan di Firebase Summit, dan pelajari bagaimana Firebase dapat membantu Anda mempercepat pengembangan aplikasi dan menjalankan aplikasi dengan percaya diri. Pelajari Lebih Lanjut

Hubungkan domain khusus

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Anda tidak perlu menyerahkan nama domain unik yang berpusat pada merek dengan Firebase Hosting. Anda dapat menggunakan domain khusus (seperti example.com atau app.example.com ) alih-alih domain yang dibuat oleh Firebase untuk situs yang dihosting oleh Firebase.

Firebase Hosting menyediakan sertifikat SSL untuk setiap domain Anda dan menyajikan konten Anda melalui CDN global.

Sisa dokumen ini memandu Anda melalui langkah-langkah ini untuk menghubungkan domain khusus Anda.

Siapkan domain Anda untuk Hosting

Pastikan Anda telah menyelesaikan wizard "Memulai" dari halaman Firebase Hosting proyek Anda sehingga Anda memiliki situs Firebase Hosting di proyek Firebase Anda.

Langkah 1 : Tambahkan domain

  1. Dari halaman Hosting proyek Anda , masukkan wizard untuk menghubungkan domain khusus:

    • Jika Anda hanya memiliki satu situs Hosting, klik Tambahkan domain khusus .
    • Jika Anda memiliki lebih dari satu situs Hosting , klik Lihat untuk situs yang diinginkan, lalu klik Tambahkan domain khusus .
  2. Masukkan nama domain khusus yang ingin Anda sambungkan ke situs Hosting Anda.

  3. (Opsional) Centang kotak untuk mengalihkan semua permintaan di domain khusus ke domain kedua yang ditentukan (misalnya example.com dan www.example.com dialihkan ke konten yang sama).

  4. Klik Lanjutkan untuk memulai proses validasi.

Langkah 2 : Verifikasi kepemilikan domain

Jika diminta di wizard penyiapan Connect Domain , verifikasi domain apex Anda.

Langkah-langkah ini memastikan bahwa domain Anda belum ditautkan dengan proyek Firebase dan Anda memiliki domain yang ditentukan.

  1. Di situs penyedia domain Anda, temukan halaman pengelolaan DNS.

  2. Tambahkan dan simpan record baru dengan input berikut:

    • Jenis : Tambahkan data TXT.

      Firebase Hosting mengharuskan Anda menyimpan data TXT ini secara terus-menerus di setelan DNS untuk membuktikan kepemilikan domain dan memberi otorisasi kepada Firebase untuk menetapkan dan memperbarui sertifikat SSL untuk situs Anda.

      Penyedia domain Anda mungkin mencantumkan istilah ini sebagai "Jenis Rekaman".

    • Host : Masukkan kunci domain apex Anda.

      Membuktikan kepemilikan Anda atas domain apex, atau domain root, membuktikan kepemilikan Anda atas semua subdomainnya.

      Penyedia domain Anda mungkin mencantumkan istilah ini sebagai "Nama Inang", "Nama", atau "Domain".

    • Nilai : Salin nilai verifikasi unik ke dalam bidang.

      Firebase Hosting memeriksa nilai ini untuk membuktikan kepemilikan domain Anda.

      Penyedia domain Anda mungkin mencantumkan istilah ini sebagai "Data".

  3. Tunggu hingga 24 jam untuk menyebarkan data TXT Anda yang diperbarui, lalu klik Verifikasi .

    Perhatikan bahwa Anda dapat mengklik Batal untuk menutup jendela Hubungkan Domain dengan aman dan membukanya kembali di lain waktu. Ini tidak mempengaruhi waktu propagasi, tetapi Anda akan diminta untuk memasukkan kembali nama domain Anda saat membuka kembali jendela.

    Setelah waktu propagasi yang cukup, mengklik Verifikasi di jendela Connect Domain dari Firebase console memungkinkan Anda untuk memulai proses penyediaan sertifikat SSL.

    Dalam kebanyakan kasus, penyebaran catatan dan verifikasi domain Anda akan terjadi dalam beberapa jam, tergantung pada penyedia domain Anda. Lihat dokumentasi penyedia domain Anda untuk petunjuk mendetail untuk menambahkan data TXT dan waktu propagasi.

    Jika mengklik Verifikasi meminta pesan kesalahan, catatan Anda belum disebarkan atau nilai Anda mungkin salah.

Langkah 3 : Tayangkan

Di jendela Hubungkan Domain di Firebase console, pilih Penyiapan Cepat untuk situs baru atau Penyiapan Lanjutan jika Anda sudah memiliki situs yang berjalan di penyedia hosting lain dan memerlukan migrasi tanpa waktu henti.

Tunggu penyediaan sertifikat SSL

Setelah memverifikasi kepemilikan domain, kami menyediakan sertifikat SSL untuk domain Anda dan menerapkannya di seluruh CDN global kami dalam waktu 24 jam setelah Anda mengarahkan catatan DNS A ke Firebase Hosting.

Domain Anda akan terdaftar sebagai salah satu Nama Alternatif Subjek (SAN) dalam sertifikat SSL FirebaseApp. Anda dapat melihat sertifikat ini menggunakan alat keamanan browser. Saat domain sedang disiapkan, Anda mungkin melihat sertifikat tidak valid yang tidak menyertakan nama domain Anda. Ini adalah bagian normal dari proses dan akan teratasi setelah sertifikat domain Anda tersedia.

Untuk pengguna Penyiapan Lanjutan , situs web Anda akan dihosting oleh penyedia hosting Anda sebelumnya hingga status penyiapan di halaman Firebase Hosting proyek Anda diperbarui menjadi Terhubung .

Kunci domain khusus Anda

Saat menambahkan atau mengedit data DNS, penyedia domain yang berbeda mengharapkan Anda memasukkan input yang berbeda untuk bidang Host dalam situs manajemen DNS mereka. Kami telah mengumpulkan masukan umum dari penyedia populer di bawah ini. Lihat dokumentasi penyedia domain Anda untuk petunjuk mendetail.

Jenis domain Kunci domain khusus
Domain puncak

Masukan umum meliputi:

  • @
  • Nama domain puncak (misalnya, example .com )
  • Membiarkan bidang Host kosong
Subdomain

Masukan umum meliputi:

  • Nama subdomain lengkap (misalnya, app. example .com )
  • Hanya bagian subdomain (misalnya, hanya app , dan tidak menyertakan . example .com )
  • Hanya www untuk subdomain dari www. example .com

Penyedia domain umum

Berikut adalah beberapa penyedia domain umum dan jenis input yang mungkin diperlukan masing-masing. Informasi ini selalu diperbarui sebanyak mungkin, tetapi lihat dokumentasi penyedia domain Anda untuk petunjuk mendetail.

Siapkan deskripsi status untuk domain khusus

Status Keterangan
Perlu pengaturan

Anda mungkin perlu mengubah konfigurasi dengan catatan DNS Anda.

  • Dalam kebanyakan kasus, data DNS A Anda belum disebarkan dari penyedia nama domain Anda ke server Firebase Hosting.
    Kiat pemecahan masalah: Jika sudah lebih dari 24 jam, periksa apakah Anda telah mengarahkan catatan Anda ke Firebase Hosting.

  • Dalam kasus yang lebih jarang, terutama jika Anda menggunakan alur Penyiapan Lanjutan, tantangan SSL mungkin gagal karena:

    • Catatan DNS Anda memiliki catatan A atau catatan CNAME yang mengarah ke penyedia hosting lain.
      Kiat pemecahan masalah: Pastikan catatan A Anda hanya mengarah ke Firebase Hosting, dan hapus semua data CNAME.
    • Migrasi gagal, dan token (data TXT DNS atau file yang diunggah yang disediakan ke situs Anda) sekarang tidak valid.
      Kiat pemecahan masalah: Klik Lihat untuk domain, lalu berikan token baru ke domain Anda yang sudah ada.
Tertunda

Anda telah menyiapkan domain kustom dengan benar, tetapi Firebase Hosting belum menyediakan sertifikat SSL.

Terkadang, masalah berikut dapat menghentikan pencetakan sertifikat SSL untuk domain kustom:

  • Catatan CAA Anda terlalu membatasi.
    Kiat pemecahan masalah: Pastikan otoritas sertifikat `letsencrypt.org` dan `pki.goog` diizinkan membuat sertifikat SSL untuk domain Anda.
  • Kode tantangan Anda tidak valid.
    Jika Anda menggunakan alur Penyiapan Lanjutan dan migrasi gagal, token Anda (dan kode tantangannya) sekarang tidak valid.
    Kiat pemecahan masalah: Klik Lihat untuk domain, lalu berikan token baru ke domain Anda yang sudah ada.
  • Anda meminta sertifikat untuk terlalu banyak subdomain.
    Tip pemecahan masalah: Umumnya, Firebase Hosting merekomendasikan tidak lebih dari 20 subdomain pada satu domain kustom apex, karena batas pembuatan sertifikat SSL.
Terhubung

Domain kustom Anda memiliki data DNS yang tepat dan memiliki sertifikat SSL.
Anda dapat menyajikan konten situs Anda.

Perlu Verifikasi Ulang

Firebase mungkin mengharuskan Anda untuk memverifikasi ulang kepemilikan domain secara manual jika salah satu situasi berikut terjadi:

  • Data TXT yang ditambahkan saat Anda pertama kali memverifikasi kepemilikan domain telah diubah atau dihapus dari setelan DNS domain Anda.
    • Perhatikan bahwa beberapa data TXT dengan token verifikasi situs google diizinkan di satu domain.
    • Kami mengharuskan catatan TXT selalu ada di pengaturan DNS Anda karena ini membuktikan bahwa Anda adalah pemilik domain dan mengizinkan kami untuk menetapkan dan memperbarui sertifikat SSL untuk situs Anda.
  • Orang yang memverifikasi kepemilikan domain tidak lagi diberi peran IAM yang berisi izin yang diperlukan untuk memverifikasi kepemilikan domain. Peran ini termasuk Pemilik, Editor, Firebase Admin, dan Firebase Develop Admin.
Kiat pemecahan masalah: Kunjungi halaman Hosting proyek Anda untuk menyelesaikan proses verifikasi ulang dalam jangka waktu yang ditentukan (biasanya 30 hari) agar domain khusus Anda tidak terputus secara otomatis dari Firebase Hosting.