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
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 .
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.
(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).
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.
Trong trang web của nhà cung cấp miền của bạn, hãy tìm trang quản lý DNS.
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".
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".
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.
Cài đặt nhanh
Quay lại trang web quản lý DNS của nhà cung cấp tên miền của bạn để tạo bản ghi DNS A trỏ trang của bạn đến Lưu trữ Firebase. Thêm và lưu bản ghi với các đầu vào sau:
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 đỉnh hoặc miền phụ.
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ị : Gán một giá trị cho mỗi bản ghi DNS Một để trỏ miền của bạn đến các địa chỉ IP được chỉ định.
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".
Cho phép thời gian để chứng chỉ SSL của bạn được cấp phép . Quá trình này có thể mất đến 24 giờ sau khi bạn trỏ bản ghi A của mình tới Lưu trữ Firebase. Trong hầu hết các trường hợp, việc truyền bá hồ sơ và cung cấp chứng chỉ SSL 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.
Thiết lập nâng cao
Cửa sổ Connect Domain của bảng điều khiển Firebase sẽ yêu cầu bạn cung cấp mã thông báo để di chuyển trang web hiện có của bạn. Bạn chỉ cần hoàn thành một trong những bước sau để cung cấp mã thông báo:
Cập nhật bản ghi DNS TXT : Truy cập trang web quản lý DNS của nhà cung cấp miền của bạn. Thêm bản ghi TXT với khóa miền của bạn và giá trị được cung cấp.
Cho phép tối đa 24 giờ để truyền các bản ghi TXT của bạn.
Tải tệp lên trang web hiện có : Tải mã thông báo lên trang web hiện có của bạn tại URL được chỉ định và xác minh sự tồn tại của nó.
Trang này phải được cung cấp qua HTTPS và không cần phải hợp lệ hoặc an toàn. Mã thông báo được mã hóa chỉ có giá trị cho một lần thử. Nếu quá trình di chuyển không thành công, một mã thông báo mới sẽ được tạo cho hồ sơ của bạn.
Cho phép thời gian để chứng chỉ SSL của bạn được cấp phép . Quá trình này có thể mất đến 24 giờ. Trong hầu hết các trường hợp, việc truyền bá hồ sơ và cung cấp chứng chỉ SSL 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.
Sau khi chứng chỉ SSL của bạn được cấp phép, hãy quay lại trang web quản lý DNS của nhà cung cấp DNS của bạn để thêm các bản ghi DNS A trỏ trang của bạn đến Lưu trữ Firebase. Thêm và lưu bản ghi với các đầu vào sau:
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 đỉnh hoặc miền phụ.
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".
Giá trị : Gán một giá trị cho mỗi bản ghi DNS Một để trỏ miền của bạn đến các địa chỉ IP được chỉ định.
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".
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.
Cloudflare
Loại
Tổ chức
Giá trị
Đầu vào bản ghi DNS TXT
TXT
example .com
giá trị xác minh được cung cấp trong bảng điều khiển Firebase
DNS A ghi lại các đầu vào
MỘT
example .com
199.36.158.100
MỘT
www
199.36.158.100
Tên miền Google
Loại
Tổ chức
Giá trị
Đầu vào bản ghi DNS TXT
TXT
@
giá trị xác minh được cung cấp trong bảng điều khiển Firebase
DNS A ghi lại các đầu vào
MỘT
@
199.36.158.100
MỘT
www
199.36.158.100
Google Cloud DNS
Loại
Tổ chức
Giá trị
Đầu vào bản ghi DNS TXT
TXT
example .com
giá trị xác minh được cung cấp trong bảng điều khiển Firebase
DNS A ghi lại các đầu vào
MỘT
example .com
199.36.158.100
MỘT
www
199.36.158.100
NameCheap
Loại
Tổ chức
Giá trị
Đầu vào bản ghi DNS TXT
TXT
@
giá trị xác minh được cung cấp trong bảng điều khiển Firebase
DNS A ghi lại các đầu vào
MỘT
@
199.36.158.100
MỘT
@
199.36.158.100
Squarespace
Loại
Tổ chức
Giá trị
Đầu vào bản ghi DNS TXT
TXT
@
giá trị xác minh được cung cấp trong bảng điều khiển Firebase
DNS A ghi lại các đầu vào
MỘT
@
199.36.158.100
MỘT
www
199.36.158.100
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:
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.