Catch up on everthing we announced at this year's Firebase Summit. 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 tên miền tùy chỉnh (như example.com hoặc app.example.com ) thay vì một miền căn cứ hỏa lực tạo cho trang web của căn cứ hỏa lực-lưu trữ 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 qua 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ữ

Hãy chắc chắn rằng bạn đã hoàn thành thuật sĩ "Bắt đầu" từ dự án của bạn trang Hosting căn cứ hỏa lực để bạn có một trang web Hosting căn cứ hỏa lực trong dự án căn cứ hỏa lực của bạn.

Bước 1: Add miền

  1. Từ dự án của bạn của trang Hosting , nhập wizard để kết nối một miền tùy chỉnh:

    • Nếu bạn chỉ có một Hosting trang web, nhấp vào miền Connect.
    • Nếu bạn có nhiều hơn một trang web Hosting , bấm Xem cho các trang web mong muốn, sau đó nhấp vào miền Connect.
  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. (Không bắt buộc) Đánh dấu vào ô để chuyển hướng tất cả các yêu cầu trên miền tùy chỉnh cho một miền xác định thứ hai (ví dụ rằng 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 nhận.

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

Nếu được yêu cầu trong hướng dẫn cài đặt Connect Domain, xác minh tên miền đỉnh 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:

    • Gõ: 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".

    • Host: Nhập khóa tên miền đỉnh .

      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 lĩnh vực này.

      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 lên đến 24 giờ để tuyên 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ể bấm Cancel để an toàn đóng cửa sổ Connect miền và mở lại sau một thời gian. Điều này không ảnh hưởng đến thời gian công tác tuyên truyền, nhưng bạn sẽ được nhắc nhở để nhập lại tên miền của bạn khi bạn mở lại cửa sổ.

    Sau thời gian tuyên truyền phong phú, nhấp Xác minh trong cửa sổ Connect miền của các firebase console cho phép bạn bắt đầu quá trình chứng chỉ SSL provisioning.

    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 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 lan truyền.

    Nếu nhấp Xác nhắc nhở một thông báo lỗi, hồ sơ của bạn đã không tuyên truyền hoặc giá trị của bạn có thể không đúng.

Bước 3: Quay sống

Trong cửa sổ Connect miền của các firebase console, chọn Quick Setup cho một trang web mới hoặc cài đặt nâng cao nếu bạn đã có một trang web chạy trên một nhà cung cấp hosting và cần một sự chuyển đổi zero-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 cài đặt nâng cao, trang web của bạn sẽ được tổ chức bởi nhà cung cấp hosting trước đó của bạn cho đến khi tình trạng thiết lập trong dự án của bạn căn cứ hỏa lực Hosting trang cập nhật để 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 các bản ghi DNS, các nhà cung cấp tên miền khác nhau hy vọng bạn nhập nguyên liệu đầu vào khác nhau cho các lĩnh vực chủ 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 để có 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 đỉnh (ví dụ, example .com )
  • Rời bỏ trống trường Máy chủ
Tên miền phụ

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

  • Tên đầy đủ tên miền phụ (ví dụ, app. example .com )
  • Chỉ có phần tên miền phụ (ví dụ, app duy nhất, và để lại ra . example .com )
  • Chỉ www cho tên 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 đến 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 đã chuyển hồ sơ của mình tới Lưu trữ Firebase chưa.

  • Trong những trường hợp hiếm 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ệ.
      Khắc phục sự cố tip: Nhấp vào Xem cho tên miền, sau đó cung cấp mã thông báo mới đến tên miền hiện tại 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, mã thông báo của bạn (và mã thử thách của nó) hiện không hợp lệ.
    Khắc phục sự cố tip: Nhấp vào Xem cho tên miền, sau đó cung cấp mã thông báo mới đến tên 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 đề 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 bạn.

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 xảy ra bất kỳ trường hợp nào sau đây:

  • Bản ghi TXT thêm vào khi bạn bước đầu xác nhận quyền sở hữu tên miền của bạn đã bị thay đổi hoặc loại bỏ khỏi thiết lập DNS của tên miền của bạn.
    • Lưu ý rằng nhiều bản ghi TXT với 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 nhận quyền sở hữu miền không còn được gán một vai trò IAM có chứa sự cho phép cần thiết để xác minh quyền sở hữu tên miền. Các 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.
Khắc phục sự cố tip: web của dự án của bạn trang Hosting để hoàn tất quá trình tái xác minh trong cửa sổ thời gian nhất định (thường là 30 ngày) để tránh miền tùy chỉnh của bạn không bị tự động ngắt kết nối từ căn cứ hỏa lực Hosting.