Kết nối một miền tuỳ chỉnh

Bạn không phải từ bỏ tên miền riêng biệt, 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 tuỳ 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.

Firebase Hosting 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 để kết nối miền tuỳ chỉnh.

Thiết lập miền cho Hosting

Hãy đảm bảo rằng bạn đã hoàn tất trình hướng dẫn "Bắt đầu" trên trang Firebase Hosting của dự án để có một Firebase Hosting trong dự án Firebase.

Bước 1: Thêm miền tuỳ chỉnh

  1. Trên trang Hosting của dự án, hãy nhập trình hướng dẫn để kết nối miền tuỳ chỉnh:

    • Nếu bạn chỉ có một trang web Hosting, hãy nhấp vào Add custom domain (Thêm miền tuỳ chỉnh).
    • Nếu bạn có nhiều hơn một Hosting trang web, hãy nhấp vào View (Xem) cho trang web bạn muốn, sau đó nhấp vào Add custom domain (Thêm miền tuỳ chỉnh).

  2. Nhập tên miền tuỳ chỉnh mà bạn muốn kết nối với trang web Hosting.

  3. (Không bắt buộc) Đánh dấu vào hộp để chuyển hướng tất cả yêu cầu trên miền tuỳ chỉnh đến một miền thứ hai đã chỉ định (để example.com và www.example.com chuyển hướng đến cùng một nội dung).

  4. Nhấp vào Continue (Tiếp tục) để định cấu hình bản ghi DNS và hoàn tất việc thiết lập miền tuỳ chỉnh.

Bước 2: Thiết lập miền tuỳ chỉnh

Nếu được yêu cầu trong trình hướng dẫn thiết lập Connect Domain (Kết nối miền), hãy xác minh miền đỉnh.

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 một dự án Firebase và bạn sở hữu miền đã chỉ định.

  1. Trên trang web của nhà cung cấp miề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 thông tin đầu vào sau:

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

      Firebase Hosting yêu cầu bạn liên tục giữ bản ghi TXT này trong phần cài đặt DNS để chứng minh quyền sở hữu miền và cho phép Firebase chỉ định 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à "Record Type" (Loại bản ghi).

    • Host (Máy chủ lưu trữ): Nhập khoá miền đỉnh.

      Việc chứng minh quyền sở hữu miền đỉnh (hoặc miền gốc) cũng chứng minh quyền sở hữu tất cả miền con của miền đó.

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

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

      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 miền của bạn có thể liệt kê thuật ngữ này là "Data" (Dữ liệu).

  3. Vui lòng đợi tối đa 24 giờ để các bản ghi TXT đã cập nhật được truyền tải, sau đó nhấp vào Verify (Xác minh).

    Xin lưu ý rằng bạn có thể nhấp vào Cancel (Huỷ) để đóng an toàn cửa sổ Connect Domain (Kết nối miền) và mở lại vào lúc khác. Việc này không ảnh hưởng đến thời gian truyền tải, nhưng bạn sẽ được nhắc nhập lại tên miền khi mở lại cửa sổ.

    Sau khi có đủ thời gian truyền tải, việc nhấp vào Verify (Xác minh) trong cửa sổ Connect Domain (Kết nối miền) 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, việc truyền tải bản ghi và xác minh miền của bạn sẽ diễn ra trong vòng vài giờ, tuỳ thuộc vào nhà cung cấp miền của bạn. Hãy tham khảo tài liệu của nhà cung cấp miề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 tải.

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

Trong trình hướng dẫn Add Custom Domain (Thêm miền tuỳ chỉnh) của bảng điều khiển Firebase, hãy chọn Quick Setup (Thiết lập nhanh) hoặc Advanced Setup (Thiết lập nâng cao).

Bạn có thể sử dụng Quick Setup (Thiết lập nhanh) 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 Hosting trang web khác. Bạn có thể sử dụng Advanced Setup (Thiết lập nâng cao) nếu đã có một miền nhận yêu cầu 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 bị gián đoạn.

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

Chờ cung cấ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 đến Firebase Hosting.

Miền của bạn sẽ được liệt kê là một trong các Tên thay thế của thực thể (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ẽ được giải quyết sau khi chứng chỉ của miền có sẵn.

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

Khoá miền tuỳ 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 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 Host (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. Hãy tham khảo tài liệu của nhà cung cấp miền để biết hướng dẫn chi tiết.

Loại miền Khoá miền tuỳ chỉnh
Miền đỉnh

Các thông tin đầu vào phổ biến bao gồm:

  • @
  • Tên miền đỉnh (ví dụ: example.com)
  • Để trống trường Host (Máy chủ lưu trữ)
Miền phụ

Các thông tin đầ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ỏ qua .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 thông tin đầu vào mà mỗi nhà cung cấp có thể yêu cầu. Chúng tôi cố gắng cập nhật thông tin này thường xuyên nhất có thể, nhưng hãy tham khảo tài liệu của nhà cung cấp miền để biết hướng dẫn chi tiết.

Nội dung mô tả trạng thái thiết lập cho miền tuỳ chỉnh

Trạng thái Mô tả
Needs setup (Cần thiết lập)

Bạn có thể cần thay đổi cấu hình bằng bản ghi DNS.

  • 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ải 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 đã quá 24 giờ, hãy kiểm tra để đảm bảo rằng bạn đã trỏ bản ghi đến Firebase Hosting.

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

    • Các thử thách về chứng chỉ SSL không thành công và mã thông báo (bản ghi DNS TXT records or uploaded file đượ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 View (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.
Đang chờ xử lý

Bạn đã thiết lập miền tuỳ chỉnh đúng cách, nhưng Firebase Hosting chưa cung cấp chứng chỉ SSL.

Đôi khi, các vấn đề sau đây có thể làm chậm quá trình tạo chứng chỉ SSL chứng chỉ cho miền tuỳ chỉnh:

  • Bản ghi CAA của bạn quá hạn chế.
    Mẹo khắc phục sự cố: Đảm bảo rằng các 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 (và mã thử thách của mã thông báo đó) hiện không hợp lệ.
    Mẹo khắc phục sự cố: Nhấp vào View (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 miền con.
    Mẹo khắc phục sự cố: Nhìn chung, Firebase Hosting khuyên bạn không nên có quá 20 miền con trên một miền tuỳ chỉnh đỉnh, do giới hạn về việc tạo chứng chỉ SSL.
Minting Certificate (Đang tạo chứng chỉ)

Chứng chỉ SSL đang được tạo cho miền của bạn.
Connected (Đã kết nối)

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