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

Kết nối miền tùy chỉnh

Bạn không cần phải từ bỏ các tên miền độc đáo, tập trung vào thương hiệu của mình với Dịch vụ lưu trữ Firebase. Bạn có thể sử dụng miền tùy chỉnh (như example.com hoặc app.example.com ) thay vì miền do Firebase tạo cho trang web được lưu trữ trên Firebase của mình.

Dịch vụ lưu trữ Firebase cung cấp chứng chỉ SSL cho từng miền của bạn và phân phát nội dung của bạn qua CDN toàn cầu.

Phần còn lại của tài liệu này sẽ hướng dẫn bạn qua các bước này để kết nối miền tùy chỉnh của bạn.

Thiết lập tên miền của bạn cho Hosting

Đảm bảo rằng bạn đã hoàn thành trình hướng dẫn "Bắt đầu" từ trang Lưu trữ Firebase của dự án để bạn có một trang web Lưu trữ Firebase trong dự án Firebase của mình.

Bước 1 : Thêm tên miền

  1. Từ trang Lưu trữ của dự án của bạn, hãy nhập trình hướng dẫn để kết nối miền tùy chỉnh:

    • Nếu bạn chỉ có một trang Hosting thì nhấn Add custom domain .
    • Nếu bạn có nhiều hơn một Trang web lưu trữ , hãy nhấp vào Xem cho trang web mong muốn, sau đó nhấp vào Thêm miền tùy chỉnh .
  2. Nhập tên miền tùy chỉnh mà bạn muốn kết nối với Trang web lưu trữ của mình.

  3. (Tùy chọn) Chọn hộp để chuyển hướng tất cả các yêu cầu trên miền tùy chỉnh sang miền được chỉ định thứ hai (chẳng hạn như example.comwww.example.com chuyển hướng đến cùng một nội dung).

  4. Nhấp vào Tiếp tục để bắt đầu quá trình xác thực.

Bước 2 : Xác minh quyền sở hữu tên miền

Nếu được yêu cầu trong trình hướng dẫn thiết lập Miền kết nối , hãy xác minh miền apex của bạn.

Các bước này đảm bảo rằng miền của bạn chưa được liên kết với dự án Firebase và bạn sở hữu miền được chỉ định.

  1. Trong trang web của nhà cung cấp tên miền của bạn, tìm trang quản lý DNS.

  2. Thêm và lưu bản ghi mới với các đầu vào sau:

    • Loại : Thêm bản ghi TXT.

      Dịch vụ lưu trữ Firebase yêu cầu bạn phải liên tục hiển thị bản ghi TXT này trong cài đặt DNS của mình để chứng minh quyền sở hữu miền của bạn và ủy quyền cho Firebase chỉ định cũng như gia hạn chứng chỉ SSL cho trang web của bạn.

      Nhà cung cấp tên miền của bạn có thể liệt kê thuật ngữ này là "Loại bản ghi".

    • Máy chủ : Nhập mã miền apex của bạn.

      Việc chứng minh quyền sở hữu của bạn đối với miền apex hoặc miền gốc chứng tỏ quyền sở hữu của bạn đối với tất cả các miền phụ của nó.

      Nhà cung cấp tên miền của bạn có thể liệt kê thuật ngữ này là "Tên máy chủ", "Tên" hoặc "Miền".

    • Giá trị : Sao chép giá trị xác minh duy nhất vào trường.

      Dịch vụ lưu trữ Firebase kiểm tra giá trị này để chứng minh quyền sở hữu miền của bạn.

      Nhà cung cấp tên miền của bạn có thể liệt kê thuật ngữ này là "Dữ liệu".

  3. Cho phép tối đa 24 giờ để truyền các bản ghi TXT đã cập nhật của bạn, sau đó nhấp vào Xác minh .

    Lưu ý rằng bạn có thể nhấp vào Hủy để đóng cửa sổ Kết nối miền một cách an toàn và mở lại sau. Điều này không ảnh hưởng đến thời gian lan truyền, nhưng bạn sẽ được nhắc nhập lại tên miền của mình khi mở lại cửa sổ.

    Sau một thời gian truyền bá rộng rãi, việc nhấp vào Xác minh trong cửa sổ Miền kết nối của bảng điều khiển Firebase sẽ cho phép bạn bắt đầu quy trình cung cấp chứng chỉ SSL.

    Trong hầu hết các trường hợp, quá trình truyền bản ghi và xác minh miền của bạn sẽ diễn ra trong vòng vài giờ, tùy thuộc vào nhà cung cấp miền của bạn. Tham khảo tài liệu của nhà cung cấp miền của bạn để biết hướng dẫn chi tiết về cách thêm bản ghi TXT và thời gian lan truyền.

    Nếu nhấp vào Xác minh sẽ đưa ra thông báo lỗi, thì bản ghi của bạn chưa được lan truyền hoặc giá trị của bạn có thể không chính xác.

Bước 3 : Phát trực tiếp

Trong cửa sổ Kết nối miền của bảng điều khiển Firebase, chọn Thiết lập nhanh cho trang web mới hoặc Thiết lập nâng cao nếu bạn đã có một trang web chạy trên một nhà cung cấp dịch vụ lưu trữ khác và cần di chuyển mà không cần thời gian ngừng hoạt động.

Chờ cung cấp chứng chỉ SSL

Sau khi xác minh quyền sở hữu miền, chúng tôi cung cấp chứng chỉ SSL cho miền của bạn và triển khai chứng chỉ đó trên CDN toàn cầu của chúng tôi trong vòng 24 giờ sau khi bạn trỏ bản ghi DNS A của mình tới Dịch vụ lưu trữ Firebase.

Miền của bạn sẽ được liệt kê là một trong các Tên thay thế chủ đề (SAN) trong chứng chỉ SSL FirebaseApp. Bạn có thể xem chứng chỉ này bằng các công cụ bảo mật của trình duyệt. Trong khi miền đang được cung cấp, bạn có thể thấy một chứng chỉ không hợp lệ không bao gồm tên miền của bạn. Đây là một phần bình thường của quy trình và sẽ giải quyết sau khi chứng chỉ miền của bạn khả dụng.

Đối với người dùng Thiết lập nâng cao , trang web của bạn sẽ được nhà cung cấp dịch vụ lưu trữ trước đó lưu trữ cho đến khi trạng thái thiết lập trong trang Lưu trữ Firebase của dự án cập nhật thành Đã kết nối .

Khóa miền tùy chỉnh của bạn

Khi thêm hoặc chỉnh sửa bản ghi DNS, các nhà cung cấp tên miền khác nhau yêu cầu bạn nhập các đầu vào khác nhau cho trường Máy chủ lưu trữ trong các trang web quản lý DNS của họ. Chúng tôi đã tổng hợp các thông tin đầu vào phổ biến từ các nhà cung cấp phổ biến bên dưới. Tham khảo tài liệu của nhà cung cấp tên miền của bạn để biết hướng dẫn chi tiết.

loại tên miền Khóa miền tùy chỉnh
miền đỉnh

Đầu vào phổ biến bao gồm:

  • @
  • Tên miền apex (ví dụ: example .com )
  • Để trống trường Máy chủ
tên miền phụ

Đầu vào phổ biến bao gồm:

  • Tên miền phụ đầy đủ (ví dụ: app. example .com )
  • Chỉ phần tên miền phụ (ví dụ: chỉ app và bỏ qua . example .com )
  • Chỉ www cho tên miền phụ của www. example .com

Nhà cung cấp tên miền phổ biến

Dưới đây là một số nhà cung cấp miền phổ biến và loại đầu vào mà mỗi nhà cung cấp có thể yêu cầu. Thông tin này được cập nhật nhiều nhất có thể, nhưng hãy tham khảo tài liệu của nhà cung cấp miền của bạn để biết hướng dẫn chi tiết.

Thiết lập mô tả trạng thái cho miền tùy chỉnh

Trạng thái Sự miêu tả
Cần thiết lập

Bạn có thể cần phải thay đổi cấu hình với các bản ghi DNS của mình.

  • Trong hầu hết các trường hợp, bản ghi DNS A của bạn chưa được truyền từ nhà cung cấp tên miền của bạn đến máy chủ Lưu trữ Firebase.
    Mẹo khắc phục sự cố: Nếu đã hơn 24 giờ, hãy kiểm tra xem bạn đã trỏ các bản ghi của mình tới Dịch vụ lưu trữ Firebase chưa.

  • Trong một số trường hợp hiếm gặp hơn, đặc biệt nếu bạn đang sử dụng quy trình Thiết lập nâng cao, các thử thách SSL có thể không thành công vì:

    • Bản ghi DNS của bạn có bản ghi A hoặc bản ghi CNAME trỏ đến các nhà cung cấp dịch vụ lưu trữ khác.
      Mẹo khắc phục sự cố: Kiểm tra xem bản ghi A của bạn chỉ trỏ đến Dịch vụ lưu trữ Firebase và xóa tất cả bản ghi CNAME.
    • Quá trình di chuyển không thành công và mã thông báo (bản ghi DNS TXT hoặc tệp đã tải lên được cung cấp cho trang web của bạn) hiện không hợp lệ.
      Mẹo khắc phục sự cố: Nhấp vào Xem cho miền, sau đó cung cấp mã thông báo mới cho miền hiện tại của bạn.
Chưa giải quyết

Bạn đã thiết lập đúng miền tùy chỉnh của mình nhưng Dịch vụ lưu trữ Firebase chưa cung cấp chứng chỉ SSL.

Đôi khi, các vấn đề sau có thể cản trở quá trình tạo chứng chỉ SSL cho miền tùy chỉnh:

  • Hồ sơ CAA của bạn quá hạn chế.
    Mẹo khắc phục sự cố: Đảm bảo rằng cơ quan cấp chứng chỉ `letsencrypt.org` và `pki.goog` được phép tạo chứng chỉ SSL cho miền của bạn.
  • Mã thử thách của bạn không hợp lệ.
    Nếu bạn đang sử dụng quy trình Thiết lập nâng cao và quá trình di chuyển không thành công, thì mã thông báo của bạn (và mã thách thức của nó) hiện không hợp lệ.
    Mẹo khắc phục sự cố: Nhấp vào Xem cho miền, sau đó cung cấp mã thông báo mới cho miền hiện tại của bạn.
  • Bạn đã yêu cầu chứng chỉ cho quá nhiều tên miền phụ.
    Mẹo khắc phục sự cố: Nói chung, Lưu trữ Firebase khuyến nghị không quá 20 miền phụ trên một miền tùy chỉnh apex, do giới hạn tạo chứng chỉ SSL.
kết nối

Miền tùy chỉnh của bạn có bản ghi DNS phù hợp và có chứng chỉ SSL.
Bạn có thể phục vụ nội dung trang web của bạn.

Cần xác minh lại

Firebase có thể yêu cầu bạn xác minh lại quyền sở hữu miền của mình theo cách thủ công nếu bản ghi TXT được thêm vào khi bạn xác minh ban đầu quyền sở hữu miền của mình đã bị thay đổi hoặc xóa khỏi cài đặt DNS của miền.

  • Lưu ý rằng nhiều bản ghi TXT có mã thông báo xác minh trang web của google được phép trên một miền.
  • Chúng tôi yêu cầu bản ghi TXT phải liên tục xuất hiện trong cài đặt DNS của bạn vì điều này chứng tỏ bạn sở hữu miền và cho phép chúng tôi chỉ định cũng như gia hạn chứng chỉ SSL cho trang web của bạn.
Mẹo khắc phục sự cố: Truy cập trang Lưu trữ của dự án để hoàn tất quy trình xác minh lại trong khoảng thời gian đã chỉ định (thường là 30 ngày) để tránh miền tùy chỉnh của bạn tự động bị ngắt kết nối khỏi Dịch vụ lưu trữ Firebase.