Ikuti sorotan dari Firebase di Google I/O 2023. Pelajari lebih lanjut

Menghubungkan domain kustom

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

  1. 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.
  2. Masukkan nama domain kustom yang ingin Anda hubungkan ke situs Hosting.

  3. (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).

  4. 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.

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

  2. 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".

    • Host: Masukkan kunci domain apex Anda.

      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".

  3. 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.

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.

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.