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

Bạn không cần phải từ bỏ tên miền duy nhất, tập trung vào thương hiệu cho các ứng dụng được triển khai trên Firebase App 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 App Hosting cung cấp một chứng chỉ SSL cho từng miền của bạn.

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 App Hosting

Đảm bảo rằng bạn đã hoàn tất các tác vụ thiết lập App Hosting cơ bản để có một trang web Firebase App Hosting trong dự án Firebase.

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

  1. Mở trang App Hosting của dự án.
  2. Chọn một phần phụ trợ App Hosting bằng tuỳ chọn Xem trang tổng quan.
  3. Chọn thẻ Cài đặt, rồi nhấp vào Thêm miền tuỳ chỉnh.
  4. Nhập tên miền tuỳ chỉnh mà bạn muốn kết nối với trang web App Hosting.
  5. (Không bắt buộc) Đánh dấu vào hộp để chuyển hướng tất cả các yêu cầu trên miền tuỳ chỉnh sang một miền thứ hai được chỉ định (chẳng hạn như example.comwww.example.com chuyển hướng đến cùng một nội dung).
  6. Nhấp vào 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

  1. Trình hướng dẫn Thêm miền tuỳ chỉnh của bảng điều khiển Firebase sẽ hiển thị các bản ghi cần thiết cần cập nhật để trỏ trang của bạn đến dịch vụ Lưu trữ ứng dụng Firebase. Thêm, xoá và lưu bản ghi từ miền của bạn trong nhà cung cấp DNS bằng các thông tin đầu vào sau:

    • Loại: Thêm bản ghi DNS được cung cấp.
    • Máy chủ lưu trữ: Nhập khoá miền tuỳ chỉnh cho các bản ghi. Máy chủ lưu trữ mà bạn chỉ định là miền mà bạn muốn phân phát nội dung; miền này có thể là miền cấp cao nhất hoặc miền con. Nhà cung cấp 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 "Miền".

    • Value (Giá trị): Chỉ định giá trị được cung cấp cho bản ghi. Nhà cung cấp miền của bạn có thể liệt kê thuật ngữ này là "Dữ liệu", "Điểm đến", "Nội dung", "Địa chỉ" hoặc "Địa chỉ IP". Nội dung của trường giá trị thay đổi tuỳ theo loại bản ghi, trong đó bản ghi A và AAAA có địa chỉ IP làm giá trị, còn bản ghi TXT là chuỗi.

Hãy chờ chứng chỉ SSL được cấp phép. Quá trình này thường mất vài giờ, nhưng đôi khi có thể mất đến 24 giờ sau khi bạn trỏ DNS đến Firebase App Hosting. Trong hầu hết các trường hợp, quá trình truyền tải bản ghi và cấp chứng chỉ SSL sẽ diễn ra trong vòng một giờ, tuỳ thuộc vào nhà cung cấp miền của bạn.

Chờ cấp chứng chỉ SSL

App Hosting có thể mất vài giờ để cấp chứng chỉ SSL cho miền của bạn sau khi bạn cập nhật bản ghi DNS. Trong một số trường hợp, có thể mất đến 24 giờ sau khi bạn trỏ DNS đến Firebase App Hosting.

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 một chứng chỉ không hợp lệ hoặc gặp vấn đề khi kết nối với miền của mình. Đây là một phần bình thường trong quy trình và sẽ được giải quyết sau khi chứng chỉ của miền có sẵn.

Lưu ý: Firebase App Hosting sẽ tự động cấp lại chứng chỉ SSL (nếu cần) cho các miền tuỳ chỉnh.

Loại bản ghi DNS

Trình hướng dẫn Miền tuỳ chỉnh App Hosting có thể yêu cầu bạn thêm 1 đến 5 bản ghi DNS, tuỳ thuộc vào cấu hình hiện tại của miền. Loại của bản ghi xác định chức năng của bản ghi đó. Sau đây là các loại bản ghi mà App Hosting có thể yêu cầu:

Loại Mô tả Độc quyền
A Các bản ghi này chứa các giá trị IPv4 (ví dụ: 8.8.8.8), cho trình duyệt biết địa chỉ cần sử dụng khi cố gắng liên hệ với miền của bạn.
AAAA Các bản ghi này chứa các giá trị IPv6 (ví dụ: 2001:4860:4860::8888), một loại bản ghi địa chỉ khác có chức năng gần giống với bản ghi A. App Hosting hiện không sử dụng bản ghi AAAA, nhưng sẽ yêu cầu bạn xoá mọi bản ghi hiện có khỏi miền của chúng tôi (nếu có).
CNAME Các bản ghi này chứa một tên miền riêng biệt mà bạn nên sử dụng thay vì miền hiện tại để phân giải các truy vấn DNS. Bạn chỉ được phép sử dụng bản ghi CNAME trên miền con (ví dụ: www.example.com). App Hosting sử dụng bản ghi CNAME vì hai lý do:
  • Dễ dàng làm quen: Khi có thể, App Hosting sẽ yêu cầu bạn CNAME đến một miền được định cấu hình trước bắt đầu bằng _custom-domain....
  • Xác minh chứng chỉ SSL: App Hosting sử dụng Trình quản lý chứng chỉ trên đám mây để cấp chứng chỉ SSL cho Miền tuỳ chỉnh của bạn. Bản ghi CNAME trên miền con _acme-challenge... cho phép Trình quản lý chứng chỉ tạo và gia hạn chứng chỉ cho bạn. Sau khi tham gia, bạn không được xoá bản ghi này nếu không phạm vi chứng chỉ của bạn sẽ hết hạn.
TXT Các bản ghi này cho phép bạn đính kèm siêu dữ liệu tuỳ ý vào miền của mình. App Hosting cho phép bạn sử dụng một định dạng cụ thể của bản ghi TXT, fah-claim=[UUID], để cho biết Miền tuỳ chỉnh nào sẽ phân phát trên miền của bạn. Không
CAA Các bản ghi này hoạt động như một danh sách cho phép để chỉ định các Tổ chức phát hành chứng chỉ được uỷ quyền phát hành chứng chỉ SSL cho miền của bạn. App Hosting chỉ yêu cầu bản ghi CAA nếu bị chặn tạo chứng chỉ cho miền của bạn. Không

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 sẽ yêu cầu bạn nhập thông tin khác nhau cho trường Máy chủ lưu trữ trong trang web quản lý DNS của họ. Dưới đây là danh sách các thông tin đầu vào phổ biến của các nhà cung cấp phổ biế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.

Loại miền Khoá miền tuỳ chỉnh
Miền cấp cao nhất

Dữ liệu đầu vào phổ biến bao gồm:

  • @
  • Tên miền cấp cao nhất (ví dụ: example.com)
  • Để trống trường Host (Máy chủ lưu trữ)
Miền con

Dữ liệu đầu vào phổ biến bao gồm:

  • Tên miền con đầy đủ (ví dụ: app.example.com)
  • Chỉ phần miền con (ví dụ: chỉ app, bỏ qua .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 luôn cập nhật thông tin này càng nhiều càng tốt, 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 của miền tuỳ chỉnh

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

Bạn có thể cần thay đổi cấu hình bằng các 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ừ nhà cung cấp tên miền đến máy chủ Firebase App Hosting.
    Mẹo khắc phục sự cố: Nếu đã hơn 24 giờ, hãy kiểm tra để đảm bảo rằng bạn đã trỏ bản ghi đến Firebase App Hosting.

  • Trong một số ít trường hợp, 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 các bản ghi A chỉ trỏ đến Firebase App Hosting và xoá tất cả các bản ghi CNAME.

Đang chờ xử lý

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

Đôi khi, các bản ghi CAA quá hạn chế có thể làm chậm quá trình tạo chứng chỉ SSL cho miền tuỳ chỉnh. Đả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.

Chứng chỉ đúc

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

Đã kết nối

Miền tuỳ 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ân phát nội dung của trang web.