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ỏ tên miền độc đáo, tập trung vào thương hiệu của mình với Firebase Hosting. 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.

Firebase Hosting cung cấp chứng chỉ SSL cho từng miền của bạn và phân phối 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 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ó trang web Lưu trữ Firebase trong dự án Firebase của mình.

Bước 1 : Thêm tên miền tùy chỉnh

  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 Thêm miền tùy chỉnh .
    • Nếu bạn có nhiều trang web Lưu trữ , hãy nhấp vào Xem cho trang 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 để định cấu hình bản ghi DNS và hoàn tất thiết lập miền tùy chỉnh của bạn.

Bước 2 : Thiết lập tên miền tùy chỉnh

Nếu được yêu cầu trong trình hướng dẫn thiết lập Connect Domain , 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, hãy tìm trang quản lý DNS.

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

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

      Firebase Hosting yêu cầu bạn 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 và 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 khóa tên 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 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ủ", "Tên" hoặc "Miền".

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

      Firebase Hosting 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 bá 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 khi mở lại cửa sổ.

    Sau nhiều thời gian phổ biến, việc 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 sẽ cho phép bạn bắt đầu quá trình cấp phép chứng chỉ SSL.

    Trong hầu hết các trường hợp, việc phổ biến hồ sơ và xác minh tên 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 tên miền của bạn. 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 về cách thêm bản ghi TXT và thời gian truyền bá.

    Nếu thao tác nhấp vào Xác minh sẽ xuất hiện thông báo lỗi thì có nghĩa là hồ sơ của bạn chưa được phổ biến hoặc các giá trị của bạn có thể không chính xác.

Trong trình hướng dẫn Thêm miền tùy chỉnh của bảng điều khiển Firebase, chọn Thiết lập nhanh hoặc Thiết lập nâng cao .

Thiết lập nhanh có thể được sử dụng cho các miền mới hiện không nhận được lưu lượng truy cập hoặc các miền mà bạn đang cố gắng chuyển từ một trang web Lưu trữ khác. Bạn có thể sử dụng Thiết lập nâng cao nếu bạn đã có miền nhận được yêu cầu từ nhà cung cấp dịch vụ lưu trữ khác và cần di chuyển không có thời gian ngừng hoạt động.

Trình hướng dẫn Thiết lập nâng cao sẽ giúp bạn thiết lập chứng chỉ SSL và xác nhận quyền sở hữu để cho phép Hosting phục vụ lưu lượng truy cập trên miền trước khi nhận lưu lượng truy cập.

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 sẽ 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 Firebase Hosting.

Tên 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 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 có chứng chỉ miền của bạn.

Đố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ủa bạ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 thông tin đầu vào khác nhau cho trường Máy chủ trong trang web quản lý DNS của họ. Chúng tôi đã tổng hợp 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 tên miền tùy chỉnh
Tên miền Apex

Đầ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

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

Dưới đây là một số nhà cung cấp tên miền phổ biến và loại thông tin đầ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 tên 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 thay đổi cấu hình với 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 đến máy chủ Firebase Hosting.
    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 Dịch vụ lưu trữ Firebase hay chưa.

  • Trong những 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 để đảm bảo rằng 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 tên miền, sau đó cung cấp mã thông báo mới cho tên miền hiện có 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 Firebase Hosting chưa cung cấp chứng chỉ SSL.

Đôi khi, các vấn đề sau có thể cản trở việc 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 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 tên miền, sau đó cung cấp mã thông báo mới cho tên 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, Firebase Hosting khuyến nghị không quá 20 tên miền phụ trên một miền tùy chỉnh đỉnh, do giới hạn tạo chứng chỉ SSL.
Giấy chứng nhận khai thác

Chứng chỉ SSL đang được tạo cho miền của bạn.

Đã kết nối

Miền tùy chỉnh của bạn 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 bạn.