Buka konsol

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 yourdomain.com atau app.yourdomain.com), alih-alih domain yang dihasilkan Firebase, untuk situs yang dihosting di Firebase.

Firebase Hosting akan menyediakan sertifikat SSL, yang ditandatangani oleh Let's Encrypt, untuk setiap domain Anda dan menayangkan konten Anda melalui CDN global.

Bagian selanjutnya dari dokumen ini akan menuntun Anda menyelesaikan langkah-langkah ini 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: Menambahkan domain

  1. Dari halaman Hosting project Anda, buka wizard untuk menghubungkan domain kustom:

    • Jika Anda hanya memiliki satu situs Hosting, klik Hubungkan domain.
    • Jika Anda memiliki lebih dari satu situs Hosting, klik Lihat untuk situs yang diinginkan, lalu klik Hubungkan domain.
  2. Masukkan domain kustom yang ingin Anda hubungkan ke situs Hosting.

  3. (Opsional) Centang kotak untuk mengalihkan semua permintaan pada domain kustom ke domain kedua yang ditentukan (sedemikian rupa sehingga yourdomain.com dan www.yourdomain.com mengalihkan ke konten yang sama)

  4. Klik Lanjutkan untuk memulai proses validasi.

Langkah 2: Memverifikasi 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.

      Membuktikan kepemilikan domain apex atau domain root, membuktikan kepemilikan Anda 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 penerapan meluas, mengklik Verifikasi di jendela Hubungkan Domain di Firebase Console memungkinkan Anda untuk memulai proses penyediaan sertifikat SSL.

    Dalam kebanyakan kasus, penerapan data Anda 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 Anda mengklik Verifikasi, data Anda belum diterapkan atau nilai Anda mungkin salah.

Langkah 3: Mulai menayangkan

Pada 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 perlu migrasi tanpa periode nonaktif.

Menunggu 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 data A DNS ke Firebase Hosting.

Domain Anda akan terdaftar sebagai Subject Alternative Names (SAN) dalam sertifikat SSL FirebaseApp. Anda dapat melihat sertifikat ini menggunakan fitur 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.

Untuk pengguna dengan Penyiapan Lanjutan, situs Anda akan dihosting oleh penyedia hosting sebelumnya hingga status penyiapan di halaman Firebase Hosting project Anda berubah menjadi Terhubung.

Kunci domain kustom Anda

Saat menambahkan atau mengedit data DNS, 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 instruksi lebih detail.

Jenis domain Kunci domain kustom
Domain apex

Input yang umum meliputi:

  • @

  • Nama domain apex (yourdomain.com).

  • Membiarkan kolom Host kosong.

Subdomain

Input yang umum meliputi:

  • Nama subdomain (app.yourdomain.com).
  • Hanya bagian subdomain (app, tanpa menyertakan .yourdomain.com).
    • Contoh penggunaan yang umum adalah memasukkan www sebagai kunci untuk subdomain www.yourdomain.com.

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 Anda hanya mengarah ke Firebase Hosting, dan hapus semua data CNAME.
    • Migrasi gagal, dan token (data TXT DNS atau file diupload yang diberikan ke situs Anda) sekarang 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 memberikan sertifikat SSL.

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

  • Data CAA Anda terlalu ketat.
    Tips pemecahan masalah: Pastikan otoritas sertifikat Let's Encrypt diizinkan untuk 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.
    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, terkait 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 mengharuskan Anda memverifikasi ulang kepemilikan domain secara manual jika salah satu situasi berikut terjadi:

  • 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.
    • Kami mewajibkan data TXT selalu ada di setelan DNS Anda karena data ini membuktikan Anda memiliki domain dan mengizinkan kami untuk menetapkan dan memperpanjang sertifikat SSL untuk situs Anda.
  • Orang yang membuktikan kepemilikan domain telah dihapus sebagai anggota project Firebase Anda.
Tips pemecahan masalah: Buka halaman Hosting project Anda untuk menyelesaikan proses verifikasi ulang dalam rentang waktu yang ditentukan (biasanya 30 hari) untuk menghindari domain kustom Anda diputus otomatis dari Firebase Hosting.