Tên miền con & tên miền riêng
Website bán hàng của cửa hàng trên Hubport SaaS: tên miền con miễn phí, tên miền riêng, bản ghi DNS cần tạo, trạng thái và chuyển hướng
Chỉ có trên Hubport SaaS
Các endpoint trong mục Tên miền website chỉ hoạt động trên Hubport SaaS. Trên bản cài đặt riêng (máy chủ riêng), chúng trả về
HTTP 404 error_saas_mode_inactive; tên miền website do đơn vị vận hành máy chủ cấu hình.
Hai loại địa chỉ
| Loại | Ví dụ | Cách có |
|---|---|---|
| Tên miền con (miễn phí) | https://tencuahang.hubport.com.vn | Có sẵn theo screenname của cửa hàng, có chứng chỉ SSL, không cần cấu hình. Đuôi tên miền xem trường shop_domain_suffix của Trạng thái nền tảng |
| Tên miền riêng | https://www.shopcuatoi.vn | Cửa hàng tự mua tên miền, thêm vào Hubport, tạo bản ghi DNS. Hubport xác minh quyền sở hữu, tự cấp chứng chỉ SSL và kiểm tra DNS định kỳ |
Mỗi cửa hàng dùng tối đa config.max_domains tên miền riêng (mặc định 1, xem Website của cửa hàng).
Tên miền riêng cần tính năng custom_domain của gói (xem Gói, dùng thử & giới hạn);
không có tính năng thì thêm, kiểm tra, sửa tên miền trả HTTP 402 error_feature_requires_plan.
Nhập tên miền nào thì website chạy ở đâu
| Nhập | Website chạy ở | Tên miền gốc tự chuyển (301) sang website |
|---|---|---|
shopcuatoi.vn hoặc www.shopcuatoi.vn | www.shopcuatoi.vn | shopcuatoi.vn |
cuahang.shopcuatoi.vn | cuahang.shopcuatoi.vn | không có |
Hệ thống tự chuẩn hoá: chữ thường, bỏ http:///https://, đường dẫn, cổng, dấu chấm cuối; tên miền tiếng Việt đổi sang dạng
punycode. Không nhận địa chỉ IP, tên miền nội bộ (.local, .test, .localhost...) và tên miền của Hubport.
Bản ghi DNS cần tạo
Tạo tại nơi quản lý DNS của tên miền (nhà đăng ký, Cloudflare...). Giá trị chính xác cho từng tên miền nằm trong trường
dns.records của Domain Object.
Mục đích (purpose) | Loại | Tên (host) | Giá trị | Ghi chú |
|---|---|---|---|---|
verify | TXT | _hubport | hubport-verify=... | Bắt buộc, chỉ cần một lần. Nên giữ lại sau khi xác minh |
route | CNAME | www (hoặc nhãn đã nhập) | Đích CNAME trong config.cname_target | Bắt buộc |
apex | A | @ | IP trong config.apex_ips | Khuyến nghị, để shopcuatoi.vn chuyển sang www |
- Cột Tên là phần đứng trước tên miền gốc (
@là chính tên miền gốc). Trườngnamecho tên đầy đủ, vd_hubport.shopcuatoi.vn. - Mã TXT cố định theo cửa hàng và tên miền: gỡ rồi thêm lại vẫn là mã cũ.
- Dùng Cloudflare: đặt bản ghi ở chế độ DNS only (đám mây xám) để cấp SSL nhanh nhất. Giữ proxy (đám mây cam) thì đặt SSL/TLS = Full và tắt "Always Use HTTPS".
- Tên miền có bản ghi CAA thì phải cho phép
letsencrypt.org(vd0 issue "letsencrypt.org"). - Bản ghi mới thường có hiệu lực sau vài phút, có nơi tới 24 giờ. Thêm tên miền không ảnh hưởng email theo tên miền (bản ghi MX giữ nguyên).
Trạng thái (status)
| Giá trị | Ý nghĩa | Website chạy trên tên miền riêng |
|---|---|---|
pending | Chờ xác minh: chưa thấy bản ghi TXT đúng | Không |
verified | Đã xác minh quyền sở hữu, chờ bản ghi CNAME/A trỏ về Hubport | Chưa |
ssl_pending | DNS đã đúng, đang cấp chứng chỉ SSL (thường vài phút) | Đang chuẩn bị |
active | Hoạt động với chứng chỉ SSL hợp lệ | Có |
dns_error | Bản ghi DNS không còn trỏ về Hubport (sau khi đã chạy), hoặc CAA chặn Let's Encrypt | Có thể gián đoạn |
ssl_error | Chưa cấp hoặc gia hạn được chứng chỉ SSL (sau 6 giờ chờ, hoặc chứng chỉ hỏng khi đang chạy) | Có thể gián đoạn |
Hubport tự kiểm tra lại định kỳ (dày trong giờ đầu, thưa dần) và gửi email cho chủ cửa hàng khi tên miền hoạt động, gặp lỗi DNS, lỗi chứng chỉ, hoặc bị cửa hàng khác giành quyền. Muốn kiểm ngay: Kiểm tra tên miền.
Cảnh báo (warnings)
| Giá trị | Ý nghĩa |
|---|---|
cloudflare_proxied | Tên miền đang bật proxy Cloudflare. Nên chuyển DNS only |
caa_blocks_letsencrypt | Bản ghi CAA không cho Let's Encrypt cấp chứng chỉ |
apex_not_pointed | Tên miền gốc chưa có bản ghi A về Hubport: khách gõ tên miền không có www chưa được chuyển sang www |
txt_missing | Bản ghi TXT xác minh đã bị xoá. Nên tạo lại để cửa hàng khác không giành được tên miền |
cert_expiring | Chứng chỉ sắp hết hạn mà chưa gia hạn được |
Lỗi gần nhất (last_error)
| Giá trị | Ý nghĩa |
|---|---|
txt_not_found | Chưa thấy bản ghi TXT |
txt_mismatch | Có bản ghi TXT nhưng sai mã |
cname_not_pointed | CNAME/A chưa trỏ về Hubport |
caa_blocks_letsencrypt | CAA chặn Let's Encrypt |
dns_lookup_failed | Không tra được DNS, hệ thống tự thử lại sau ít phút |
tls_cert_invalid, tls_cert_expired | Chứng chỉ chưa hợp lệ / đã hết hạn |
tls_connect_failed, tls_probe_unreachable | Không kết nối được HTTPS / không kiểm được chứng chỉ, sẽ thử lại |
Chuyển hướng
http://luôn chuyển sanghttps://.- Tên miền gốc (
shopcuatoi.vn) chuyển 301 sanghttps://www.shopcuatoi.vn(giữ đường dẫn) khi bản ghi A@đã đúng. - Khi tên miền riêng
active, tên miền con chuyển 301 sang tên miền riêng (tốt cho SEO). Tắt bằngredirect_subdomain=falseở Cập nhật tên miền để giữ cả hai địa chỉ. - Gói không còn tính năng
custom_domain: tên miền riêng chuyển 301 về tên miền con.
Cửa hàng bị khoá
Khi cửa hàng bị tạm khoá hoặc xoá mềm, website (cả tên miền con và tên miền riêng) hiện trang "Cửa hàng tạm ngưng hoạt động" (HTTP 503). Địa chỉ không gắn với cửa hàng nào hiện trang "Không tìm thấy cửa hàng" (HTTP 404).
Giành tên miền đang thuộc cửa hàng khác
Thêm tên miền đang thuộc cửa hàng khác trên Hubport trả HTTP 409 error_domain_taken, kèm bản ghi TXT của bạn trong detail.
Nếu bạn là chủ tên miền: thay bản ghi TXT _hubport bằng giá trị đó (xoá mã cũ), chờ vài phút rồi gửi lại với claim=true.
Xem Thêm tên miền riêng.