Catch up on highlights from Firebase at Google I/O 2023. Learn more

เชื่อมต่อโดเมนที่กำหนดเอง

คุณไม่จำเป็นต้องละทิ้งชื่อโดเมนเฉพาะที่มีแบรนด์เป็นศูนย์กลางด้วย Firebase Hosting คุณสามารถใช้โดเมนที่กำหนดเอง (เช่น example.com หรือ app.example.com ) แทนโดเมนที่สร้างโดย Firebase สำหรับไซต์ที่โฮสต์โดย Firebase

Firebase Hosting จัดเตรียมใบรับรอง SSL สำหรับแต่ละโดเมนของคุณและให้บริการเนื้อหาของคุณผ่าน CDN ส่วนกลาง

ส่วนที่เหลือของเอกสารนี้จะอธิบายขั้นตอนเหล่านี้เพื่อเชื่อมต่อโดเมนที่กำหนดเองของคุณ

ตั้งค่าโดเมนของคุณสำหรับการโฮสต์

ตรวจสอบให้แน่ใจว่าคุณได้ดำเนินการตามวิซาร์ด "เริ่มต้นใช้งาน" จาก หน้าโฮสติ้ง Firebase ของโครงการของคุณแล้ว เพื่อให้คุณมีไซต์โฮสติ้ง Firebase ในโครงการ Firebase ของคุณ

ขั้นตอนที่ 1 : เพิ่มโดเมน

  1. จาก หน้าโฮสติ้ง ของโปรเจ็กต์ ให้ป้อนวิซาร์ดเพื่อเชื่อมต่อโดเมนแบบกำหนดเอง:

    • หากคุณมีเว็บไซต์โฮสติ้งเพียงแห่งเดียว ให้คลิก เพิ่มโดเมนที่กำหนดเอง
    • หากคุณมี ไซต์โฮสติ้งมากกว่าหนึ่งแห่ง ให้คลิก ดู ไซต์ที่ต้องการ จากนั้นคลิก เพิ่มโดเมนที่กำหนดเอง
  2. ป้อนชื่อโดเมนแบบกำหนดเองที่คุณต้องการเชื่อมต่อกับไซต์โฮสติ้งของคุณ

  3. (ไม่บังคับ) ทำเครื่องหมายในช่องเพื่อเปลี่ยนเส้นทางคำขอทั้งหมดบนโดเมนที่กำหนดเองไปยังโดเมนที่สองที่ระบุ (เช่น example.com และ www.example.com เปลี่ยนเส้นทางไปยังเนื้อหาเดียวกัน)

  4. คลิก ดำเนินการต่อ เพื่อเริ่มกระบวนการตรวจสอบ

ขั้นตอนที่ 2 : ยืนยันความเป็นเจ้าของโดเมน

หากมีการร้องขอในวิซาร์ดการตั้งค่า Connect Domain ให้ตรวจสอบโดเมน apex ของคุณ

ขั้นตอนเหล่านี้ช่วยให้แน่ใจว่าโดเมนของคุณไม่ได้เชื่อมโยงกับโปรเจ็กต์ Firebase และคุณเป็นเจ้าของโดเมนที่ระบุ

  1. ในเว็บไซต์ของผู้ให้บริการโดเมน ให้ไปที่หน้าการจัดการ DNS

  2. เพิ่มและบันทึกเรกคอร์ดใหม่ด้วยอินพุตต่อไปนี้:

    • ประเภท : เพิ่มระเบียน TXT

      โฮสติ้ง Firebase กำหนดว่าคุณต้องเก็บบันทึก TXT นี้อย่างต่อเนื่องในการตั้งค่า DNS เพื่อพิสูจน์ความเป็นเจ้าของโดเมนและอนุญาตให้ Firebase กำหนดและต่ออายุใบรับรอง SSL สำหรับไซต์ของคุณ

      ผู้ให้บริการโดเมนของคุณอาจระบุคำนี้เป็น "ประเภทระเบียน"

    • โฮสต์ : ป้อน รหัสโดเมนเอเพ็กซ์ ของคุณ

      การพิสูจน์ความเป็นเจ้าของโดเมนเอเพ็กซ์หรือโดเมนรูทของคุณ พิสูจน์ความเป็นเจ้าของโดเมนย่อยทั้งหมดของโดเมนนั้น

      ผู้ให้บริการโดเมนของคุณอาจระบุคำนี้เป็น "ชื่อโฮสต์" "ชื่อ" หรือ "โดเมน"

    • ค่า : คัดลอกค่าการตรวจสอบที่ไม่ซ้ำกันลงในฟิลด์

      Firebase Hosting ตรวจสอบค่านี้เพื่อพิสูจน์ความเป็นเจ้าของโดเมนของคุณ

      ผู้ให้บริการโดเมนของคุณอาจระบุคำนี้เป็น "ข้อมูล"

  3. ให้เวลาไม่เกิน 24 ชั่วโมงในการเผยแพร่ระเบียน TXT ที่อัปเดตของคุณ จากนั้นคลิก ยืนยัน

    โปรดทราบว่าคุณอาจคลิก ยกเลิก เพื่อปิดหน้าต่าง เชื่อมต่อโดเมน อย่างปลอดภัยและเปิดใหม่ในภายหลัง การดำเนินการนี้ไม่ส่งผลต่อเวลาในการเผยแพร่ แต่คุณจะได้รับแจ้งให้ ป้อนชื่อโดเมนอีกครั้ง เมื่อคุณเปิดหน้าต่างอีกครั้ง

    หลังจากเวลาเผยแพร่เพียงพอ การคลิก ยืนยัน ในหน้าต่าง เชื่อมต่อโดเมน ของคอนโซล Firebase จะช่วยให้คุณเริ่มกระบวนการจัดเตรียมใบรับรอง SSL ได้

    ในกรณีส่วนใหญ่ การเผยแพร่บันทึกและการยืนยันโดเมนของคุณจะเกิดขึ้นภายในไม่กี่ชั่วโมง ขึ้นอยู่กับผู้ให้บริการโดเมนของคุณ โปรดดูเอกสารประกอบของผู้ให้บริการโดเมนของคุณสำหรับคำแนะนำโดยละเอียดสำหรับการเพิ่มระเบียน TXT และเวลาเผยแพร่

    หากคลิก ยืนยัน แล้วมีข้อความแสดงข้อผิดพลาด บันทึกของคุณยังไม่เผยแพร่หรือค่าของคุณอาจไม่ถูกต้อง

ขั้นตอนที่ 3 : ถ่ายทอดสด

ในหน้าต่าง เชื่อมต่อโดเมน ของคอนโซล Firebase ให้เลือก การตั้งค่าด่วน สำหรับไซต์ใหม่หรือ การตั้งค่าขั้นสูง หากคุณมีไซต์ที่ทำงานบนผู้ให้บริการโฮสติ้งรายอื่นอยู่แล้ว และต้องการการย้ายข้อมูลแบบไม่ต้องหยุดทำงาน

รอการจัดเตรียมใบรับรอง SSL

หลังจากที่เรายืนยันความเป็นเจ้าของโดเมนแล้ว เราจะจัดเตรียมใบรับรอง SSL สำหรับโดเมนของคุณและปรับใช้กับ CDN ทั่วโลกภายใน 24 ชั่วโมงหลังจากที่คุณชี้ระเบียน DNS A ไปยังโฮสติ้ง Firebase

โดเมนของคุณจะแสดงเป็นหนึ่งใน Subject Alternative Names (SAN) ในใบรับรอง SSL ของ FirebaseApp คุณสามารถดูใบรับรองนี้ได้โดยใช้เครื่องมือการรักษาความปลอดภัยของเบราว์เซอร์ ขณะที่โดเมนกำลังจัดเตรียม คุณอาจเห็นใบรับรองที่ไม่ถูกต้องซึ่งไม่มีชื่อโดเมนของคุณ นี่เป็นส่วนหนึ่งของกระบวนการปกติและจะแก้ไขได้หลังจากใบรับรองโดเมนของคุณพร้อมใช้งาน

สำหรับผู้ใช้ การตั้งค่าขั้นสูง เว็บไซต์ของคุณจะโฮสต์โดยผู้ให้บริการโฮสต์รายก่อนหน้าจนกว่า สถานะการตั้งค่า ใน หน้าโฮสติ้ง Firebase ของโปรเจ็กต์จะอัปเดตเป็น Connected

คีย์โดเมนที่คุณกำหนดเอง

เมื่อเพิ่มหรือแก้ไขระเบียน DNS ผู้ให้บริการโดเมนต่างๆ คาดหวังให้คุณป้อนอินพุตที่แตกต่างกันสำหรับ ฟิลด์โฮสต์ ภายในไซต์การจัดการ DNS ของตน เราได้รวบรวมข้อมูลทั่วไปจากผู้ให้บริการยอดนิยมด้านล่าง โปรดดูเอกสารประกอบของผู้ให้บริการโดเมนของคุณสำหรับคำแนะนำโดยละเอียด

ประเภทโดเมน คีย์โดเมนที่กำหนดเอง
โดเมนเอเพ็กซ์

อินพุตทั่วไปประกอบด้วย:

  • @
  • ชื่อโดเมนเอเพ็กซ์ (เช่น example .com )
  • เว้นช่อง โฮสต์ ว่างไว้
โดเมนย่อย

อินพุตทั่วไปประกอบด้วย:

  • ชื่อโดเมนย่อยแบบเต็ม (เช่น app. example .com )
  • เฉพาะส่วนโดเมนย่อย (เช่น เฉพาะ app และตัดออก . example .com )
  • เฉพาะ www สำหรับโดเมนย่อยของ www. example .com

ผู้ให้บริการโดเมนทั่วไป

ต่อไปนี้คือผู้ให้บริการโดเมนทั่วไปบางส่วนและประเภทของอินพุตที่แต่ละรายการอาจต้องการ ข้อมูลนี้ได้รับการปรับปรุงให้ทันสมัยอยู่เสมอ แต่โปรดดูคำแนะนำโดยละเอียดจากเอกสารประกอบของผู้ให้บริการโดเมนของคุณ

ตั้งค่าคำอธิบายสถานะสำหรับโดเมนที่กำหนดเอง

สถานะ คำอธิบาย
ต้องการการตั้งค่า

คุณอาจต้องเปลี่ยนการกำหนดค่าด้วยระเบียน DNS ของคุณ

  • ในกรณีส่วนใหญ่ ระเบียน DNS A ของคุณไม่ได้เผยแพร่จากผู้ให้บริการชื่อโดเมนของคุณไปยังเซิร์ฟเวอร์โฮสติ้งของ Firebase
    เคล็ดลับการแก้ปัญหา: หากเกิน 24 ชั่วโมง ให้ตรวจสอบว่าคุณได้ชี้บันทึกของคุณไปที่โฮสติ้งของ Firebase

  • ในกรณีที่เกิดไม่บ่อย โดยเฉพาะอย่างยิ่งหากคุณใช้โฟลว์การตั้งค่าขั้นสูง ปัญหา SSL อาจล้มเหลวเนื่องจาก:

    • ระเบียน DNS ของคุณมีระเบียน A หรือระเบียน CNAME ที่ชี้ไปยังผู้ให้บริการโฮสติ้งรายอื่น
      เคล็ดลับการแก้ปัญหา: ตรวจสอบว่าระเบียน A ของคุณชี้ไปที่ Firebase Hosting เท่านั้น และลบระเบียน CNAME ทั้งหมด
    • การย้ายข้อมูลล้มเหลว และโทเค็น (ระเบียน DNS TXT หรือไฟล์ที่อัปโหลดไปยังไซต์ของคุณ) ไม่ถูกต้อง
      เคล็ดลับการแก้ปัญหา: คลิก ดู สำหรับโดเมน จากนั้นระบุโทเค็นใหม่ให้กับโดเมนที่คุณมีอยู่
รอดำเนินการ

คุณตั้งค่าโดเมนที่กำหนดเองอย่างถูกต้องแล้ว แต่ Firebase Hosting ยังไม่ได้จัดเตรียมใบรับรอง SSL

ในบางครั้ง ปัญหาต่อไปนี้อาจขัดขวางการสร้างใบรับรอง SSL สำหรับโดเมนแบบกำหนดเอง:

  • บันทึก CAA ของคุณเข้มงวดเกินไป
    เคล็ดลับการแก้ปัญหา: ตรวจสอบให้แน่ใจว่าผู้ออกใบรับรอง `letsencrypt.org` และ `pki.goog` ได้รับอนุญาตให้สร้างใบรับรอง SSL สำหรับโดเมนของคุณ
  • รหัสท้าทายของคุณไม่ถูกต้อง
    หากคุณใช้โฟลว์การตั้งค่าขั้นสูงและการย้ายข้อมูลล้มเหลว โทเค็นของคุณ (และรหัสการทดสอบ) จะไม่ถูกต้อง
    เคล็ดลับการแก้ปัญหา: คลิก ดู สำหรับโดเมน จากนั้นระบุโทเค็นใหม่ให้กับโดเมนที่คุณมีอยู่
  • คุณขอใบรับรองสำหรับโดเมนย่อยมากเกินไป
    เคล็ดลับการแก้ปัญหา: โดยทั่วไปแล้ว Firebase Hosting แนะนำให้มีโดเมนย่อยไม่เกิน 20 โดเมนในโดเมนที่กำหนดเองของเอเพ็กซ์หนึ่งโดเมน เนื่องจากขีดจำกัดการสร้างใบรับรอง SSL
เชื่อมต่อแล้ว

โดเมนที่กำหนดเองของคุณมีระเบียน DNS ที่ถูกต้องและมีใบรับรอง SSL
คุณสามารถให้บริการเนื้อหาของไซต์ของคุณได้

ต้องการการตรวจสอบอีกครั้ง

Firebase อาจกำหนดให้คุณต้องยืนยันความเป็นเจ้าของโดเมนอีกครั้งด้วยตนเอง หากระเบียน TXT ที่เพิ่มเมื่อคุณ ยืนยันความเป็นเจ้าของโดเมน ถูกแก้ไขหรือลบออกจากการตั้งค่า DNS ของโดเมน

  • โปรดทราบว่าระเบียน TXT หลายรายการที่มีโทเค็นการยืนยันไซต์ของ Google ได้รับอนุญาตในโดเมนเดียว
  • เรากำหนดให้ระเบียน TXT ปรากฏในการตั้งค่า DNS ของคุณอย่างต่อเนื่อง เนื่องจากเป็นการพิสูจน์ว่าคุณเป็นเจ้าของโดเมนและอนุญาตให้เรากำหนดและต่ออายุใบรับรอง SSL สำหรับไซต์ของคุณ
เคล็ดลับการแก้ปัญหา: ไปที่ หน้าโฮสติ้ง ของโครงการของคุณเพื่อดำเนินการยืนยันซ้ำให้เสร็จสิ้นภายในกรอบเวลาที่กำหนด (ปกติคือ 30 วัน) เพื่อหลีกเลี่ยงไม่ให้โดเมนที่กำหนดเองของคุณถูกตัดการเชื่อมต่อจากโฮสติ้ง Firebase โดยอัตโนมัติ