Check out what’s new from Firebase at Google I/O 2022. 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 duy nhất, tập trung vào thương hiệu của mình với 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 bạn.

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 các bước sau để kết nối miền tùy chỉnh của bạn.

Thiết lập miền của bạn cho Lưu trữ

Đả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ó trang web Lưu trữ Firebase trong dự án Firebase của mình.

Bước 1 : Thêm 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 web Lưu trữ, hãy nhấp vào Kết nối miền .
    • Nếu bạn có nhiều trang Lưu trữ , hãy nhấp vào Xem cho trang mong muốn, sau đó nhấp vào Kết nối miền .

  2. Nhập tên miền tùy chỉnh mà bạn muốn kết nối với trang 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 đến miền được chỉ định thứ hai (chẳng hạn như example.com và www.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 nhận.

Bước 2 : Xác minh quyền sở hữu 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 miền của bạn, hãy tìm trang quản lý DNS.

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

    • Nhập : Thêm bản ghi TXT.

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

      Nhà cung cấp 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 khóa 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 minh quyền sở hữu của bạn đối với tất cả các miền phụ của miề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ủ lưu trữ", "Tên" hoặc "Tên miền".

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

      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 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ổ Connect Domain 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 thời gian phổ biến rộng rãi, nhấp vào Xác minh trong cửa sổ Kết nối miền của bảng điều khiển Firebase cho phép bạn bắt đầu quy trình cấp chứng chỉ SSL.

    Trong hầu hết các trường hợp, việc truyền bá hồ sơ 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 truyền.

    Nếu việc nhấp vào Xác minh sẽ đưa ra thông báo lỗi, bản ghi của bạn chưa được truyền hoặc cá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ổ Connect Domain của bảng điều khiển Firebase, chọn Thiết lập nhanh cho một trang web mới hoặc Thiết lập nâng cao nếu bạn đã có một trang web đang chạy trên một nhà cung cấp dịch vụ lưu trữ khác và cần di chuyển không thời gian chết.

Chờ cấp phé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ỉ này 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 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ấp phép, bạn có thể thấy 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 đầ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 miền của bạn để biết hướng dẫn chi tiết.

Loại miền Khóa miền tùy chỉnh
Miền Apex

Các yếu tố đầu vào phổ biến bao gồm:

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

Các yếu tố đầu vào phổ biến bao gồm:

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

Các nhà cung cấp miền phổ biến

Dưới đây là một số nhà cung cấp miền phổ biến và các 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 để có hướng dẫn chi tiết.

Thiết lập mô tả trạng thái cho các 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 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 không được truyền từ nhà cung cấp tên miền của bạn tới các 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ỏ hồ sơ của mình tới 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 các bản ghi A của bạn chỉ trỏ đến Lưu trữ Firebase và xóa tất cả các bản ghi CNAME.
    • Di chuyển không thành công và mã thông báo (bản ghi TXT DNS 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 có của bạn.
Chưa giải quyết

Bạn đã thiết lập chính xác miền tùy chỉnh của mình nhưng Lưu trữ Firebase chưa cấp chứng chỉ SSL.

Đôi khi, các sự cố sau có thể làm đình trệ việc tạo chứng chỉ SSL cho một 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 tổ chức phát hành 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ử thách 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 có 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 đề xuất không quá 20 tên miền phụ trên một tên miền tùy chỉnh apex, do giới hạn đúc chứng chỉ SSL.
Đã kết nối

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

Cần xác minh lại

Firebase có thể yêu cầu bạn xác minh lại thủ công quyền sở hữu miền của mình nếu có bất kỳ trường hợp nào sau đây xảy ra:

  • 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 bị 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 tên 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à ủy quyền cho chúng tôi chuyển nhượng và gia hạn chứng chỉ SSL cho trang web của bạn.
  • Người đã xác minh quyền sở hữu miền không còn được chỉ định vai trò IAM có chứa quyền cần thiết để xác minh quyền sở hữu miền. Những vai trò này bao gồm Chủ sở hữu, Biên tập viên, Quản trị viên Firebase và Quản trị viên phát triển Firebase.
Mẹo khắc phục sự cố: Truy cập trang Lưu trữ của dự án của bạn để hoàn tất quá trình xác minh lại trong khoảng thời gian được 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 Lưu trữ Firebase.