Cách gắn tên miền riêng vào GitHub Pages

Trả lời nhanh

Để dùng tên miền riêng với GitHub Pages, hãy mở Settings > Pages, nhập tên miền vào Custom domain rồi nhấp Save. Sau đó tạo bản ghi CNAME trỏ www tới <user>.github.io, hoặc 4 bản ghi A cho tên miền gốc. Gói Free của Convika cũng kết nối tên miền của bạn, kèm biểu mẫu và 90 ngày số liệu khách truy cập.

Đưa trang lên tên miền của tôi

Gói Free: không cần thẻ tín dụng, 1 tên miền riêng, 1 trang đã xuất bản, hiện 50 câu trả lời biểu mẫu mỗi tháng.

Trong trang này

Để gắn tên miền riêng vào một trang GitHub Pages, hãy mở Settings > Pages trong kho mã, nhập tên miền vào ô Custom domain rồi nhấp Save. Sau đó thêm bản ghi DNS ở nhà cung cấp DNS của bạn: một bản ghi CNAME trỏ www tới <user>.github.io, hoặc 4 bản ghi A cho tên miền gốc example.com. Thay đổi DNS có thể mất tới 24 giờ để lan ra, sau đó bạn chọn Enforce HTTPS.

Các bước và mọi giá trị DNS dưới đây lấy từ tài liệu của GitHub, đọc ngày 17 tháng 11 năm 2026. Màn hình của GitHub chỉ có tiếng Anh, nên tên nút được ghi bằng tiếng Anh.

Các bản ghi DNS mà GitHub Pages cần

Tên miền của bạnLoại bản ghiTênGiá trị
www.example.comCNAMEwww<user>.github.io hoặc <organization>.github.io
Tên miền phụ khác, như blog.example.comCNAMEblog<user>.github.io hoặc <organization>.github.io
Tên miền gốc example.comA (thêm cả 4)@185.199.108.153, 185.199.109.153, 185.199.110.153, 185.199.111.153
Tên miền gốc, có IPv6AAAA (thêm cả 4, bên cạnh các bản ghi A)@2606:50c0:8000::153, 2606:50c0:8001::153, 2606:50c0:8002::153, 2606:50c0:8003::153
Tên miền gốc, khi nhà cung cấp DNS có ALIAS hoặc ANAMEALIAS hoặc ANAME, thay cho các bản ghi A@<user>.github.io hoặc <organization>.github.io

Ba quy tắc trong tài liệu của GitHub giúp tiết kiệm thời gian nhất:

  • Giá trị CNAME không có tên kho mã. GitHub viết rằng bản ghi luôn phải trỏ tới <user>.github.io hoặc <organization>.github.io, không kèm tên kho mã, kể cả với trang của dự án.
  • Thêm tên miền trên GitHub trước khi sửa DNS. GitHub cảnh báo: cấu hình DNS trước có thể khiến người khác đặt được trang lên một tên miền phụ của bạn.
  • Không dùng bản ghi đại diện. GitHub khuyên mạnh là không dùng *.example.com, vì nó khiến tên miền có nguy cơ bị chiếm ngay.

Gắn tên miền riêng trong 5 bước

Xác minh tên miền trong tài khoản

GitHub khuyên xác minh tên miền trước khi thêm vào kho mã. Nhấp vào ảnh hồ sơ, rồi Settings, rồi Pages ở thanh bên, và Add a domain. Nhập tên miền, chọn Add domain và tạo bản ghi TXT mà GitHub hiển thị, có tên _github-pages-challenge-USERNAME.example.com. Khi bản ghi đã có hiệu lực, nhấp Verify. Hãy giữ bản ghi TXT: nó giữ cho tên miền luôn được xác minh, và không tài khoản GitHub nào khác xuất bản được trang trên tên miền đó hay các tên miền phụ trực tiếp của nó.

Thêm tên miền vào kho mã

Trong kho mã của trang, nhấp Settings, rồi Pages ở mục "Code, planning, and automation". Ở ô Custom domain, nhập www.example.com hoặc example.com rồi nhấp Save. Nếu trang xuất bản từ một nhánh, thao tác này tạo một commit thêm tệp CNAME vào thư mục gốc của nhánh nguồn. Nếu trang xuất bản bằng quy trình GitHub Actions, không có tệp CNAME nào được tạo và cũng không cần.

Thêm các bản ghi DNS

Ở nhà cung cấp DNS, thêm các bản ghi trong bảng trên: một CNAME cho tên miền phụ, hoặc 4 bản ghi A cho tên miền gốc. Nếu nhà cung cấp đã đặt sẵn một bản ghi mặc định cùng tên, hãy xóa nó trước. GitHub khuyên cài www cùng với tên miền gốc: khi cả hai đã cấu hình, GitHub Pages chuyển hướng từ tên này sang tên kia.

Kiểm tra các bản ghi

Thay đổi DNS mất tới 24 giờ. Để kiểm tra từ cửa sổ dòng lệnh:

dig www.example.com +nostats +nocomments +nocmd
dig example.com +noall +answer -t A

Lệnh đầu cho thấy một CNAME tới <user>.github.io; lệnh sau cho thấy 4 bản ghi A. Windows không có dig: hãy dùng Resolve-DnsName trong PowerShell.

Bật Enforce HTTPS

Quay lại Settings > Pages và chọn Enforce HTTPS. Khi bước kiểm tra DNS đã qua, GitHub tự xin chứng chỉ từ Let's Encrypt và hiện dấu kiểm bên cạnh tên miền khi xong. Tùy chọn này có thể mất tới 24 giờ mới dùng được.

www, tên miền gốc, hay cả hai

GitHub khuyên luôn dùng tên miền phụ www, kể cả khi bạn dùng tên miền gốc, vì tên miền phụ www không bị ảnh hưởng khi địa chỉ IP của máy chủ GitHub thay đổi. Hãy đặt tên bạn muốn khách thấy làm tên miền riêng, và thêm bản ghi DNS cho cả hai:

  • Tên miền riêng www.example.com, cùng các bản ghi A của tên miền gốc: example.com chuyển hướng tới www.example.com.
  • Tên miền riêng example.com, cùng CNAME của www: www.example.com chuyển hướng tới example.com.

Tên miền riêng trên trang của người dùng hoặc tổ chức cũng áp dụng cho các trang dự án của tài khoản đó: với www.octocat.com trên trang người dùng, kho mã octo-project mở ở www.octocat.com/octo-project.

Sửa tên miền riêng GitHub Pages không hoạt động

  • Tên miền riêng biến mất sau khi triển khai. Một bản dựng force push lên nhánh xuất bản sẽ ghi đè tệp CNAME. Hãy giữ tệp này trong mã nguồn để bản dựng nào cũng có. Tên tệp viết hoa toàn bộ, và trong tệp chỉ có một tên miền, không gì khác.
  • "Domain is already taken". Một kho mã khác đang giữ tên miền. Hãy xác minh tên miền trong tài khoản của bạn để gỡ nó khỏi trang của người dùng khác, hoặc nhấp Remove ở mục Custom domain trong kho mã kia.
  • Enforce HTTPS bị mờ, hoặc "Certificate not yet created". HTTPS có thể mất tới một giờ sau khi đặt tên miền. Nếu bị kẹt, nhấp Remove bên cạnh tên miền, nhập lại rồi nhấp Save để yêu cầu chứng chỉ chạy lại. Bản ghi A, AAAA, ALIAS hoặc ANAME thừa trên @, hoặc một CNAME thứ hai trên tên miền phụ, có thể chặn chứng chỉ. Nếu tên miền có bản ghi CAA, một trong số đó phải cho phép letsencrypt.org.
  • Trang mở được ở www nhưng không mở ở tên miền gốc, hoặc ngược lại. Tên không mở được đang thiếu bản ghi. Thêm 4 bản ghi A cho tên miền gốc hoặc CNAME cho www. Đừng trỏ CNAME của tên miền phụ về tên miền gốc của bạn: GitHub viết rằng làm vậy sẽ hỏng HTTPS.
  • Ảnh hoặc kiểu dáng biến mất sau khi bật HTTPS. Trang đang tải chúng qua http://. Hãy đổi các URL đó sang https://.
  • Địa chỉ cũ vẫn mở. Hãy xóa bộ nhớ đệm của trình duyệt.

Một trang nhận một tên miền gốc và một tên miền phụ www. Tài liệu của GitHub ghi là không hỗ trợ nhiều hơn một tên miền gốc, nhiều hơn một tên miền phụ www, hay một tên miền gốc cùng một tên miền phụ riêng khác trên cùng một trang.

GitHub Pages yêu cầu gì ở trang đứng sau tên miền

  • Kho mã công khai trên GitHub Free. Với GitHub Free, Pages dùng được trong kho mã công khai, và trong kho mã riêng tư từ GitHub Pro. Dù thế nào, trang đã xuất bản vẫn công khai.
  • Không dùng cho kinh doanh trực tuyến. Trang giới hạn của GitHub viết rằng Pages không nhằm và không được phép dùng làm dịch vụ lưu trữ web miễn phí để chạy việc kinh doanh trực tuyến, trang thương mại điện tử, hay bất kỳ trang nào chủ yếu phục vụ giao dịch thương mại hoặc cung cấp phần mềm thương mại dạng dịch vụ (SaaS). GitHub Pages và việc dùng cho thương mại (tiếng Anh) nói rõ ranh giới nằm ở đâu.
  • Chỉ có tệp. Pages là dịch vụ lưu trữ trang tĩnh, nên biểu mẫu liên hệ hay biểu mẫu đăng ký cần một dịch vụ riêng.
  • Dung lượng và lưu lượng. Một trang có thể nặng tới 1 GB, với giới hạn mềm về băng thông là 100 GB mỗi tháng. Giới hạn của GitHub Pages (tiếng Anh) liệt kê phần còn lại.

Tên miền riêng kèm biểu mẫu và số liệu khách truy cập: Convika

Một trang nhận đăng ký, đặt chỗ hay đơn hàng cần nhiều hơn là có tệp trên mạng. Trên Convika, gói Free kết nối tên miền của bạn với trang bạn tải lên, không cần kho mã và không cần bản dựng, và mọi gói đều cho phép dùng vào việc kinh doanh.

Convika FreeGitHub Pages
Bạn xuất bản gìMột tệp HTML, một thư mục hoặc tệp ZIP, tải lên từ trình duyệt, hoặc mã dán từ cuộc trò chuyện với AICác tệp trong kho mã GitHub; công khai trên GitHub Free
Tên miền riêng1, như www.yourbrand.comMột tên miền phụ hoặc tên miền gốc
Bản ghi DNSMột CNAME và một TXT cho www; một bản ghi A đưa yourbrand.com về đóMột CNAME cho www; 4 bản ghi A cho tên miền gốc; một TXT để xác minh
HTTPSTự cấp khi tìm thấy các bản ghiTự cấp; bạn chọn Enforce HTTPS
Trang để bán hàngĐược phép ở mọi góiKhông được phép cho việc kinh doanh trực tuyến hay trang thương mại điện tử
Biểu mẫu lưu câu trả lờiCó: được lưu, gửi email cho bạn, xuất ra CSV hoặc JSON; hiện 50 câu trả lời mỗi thángChỉ có tệp
Số liệu khách truy cậpLượt truy cập, nguồn giới thiệu, chiến dịch UTM, thiết bị, quốc gia và lượt nhấp nút trong 90 ngàyTài liệu không nhắc tới
Giá0 US$, có thanh Convika; Pro giá 12 US$ mỗi thángMiễn phí

Để chuyển một trang sang đó, hãy tải index.html của nó từ kho mã về, hoặc cả thư mục có CSS và ảnh, rồi thả vào ô tải lên của Convika. Nhấp Giữ lại trang này — miễn phí, không cần thẻ, rồi Xuất bản trang, Công khai, Tiếp và Xuất bản miễn phí. Trên màn hình của trang, nhấp Connect my domain [kết nối tên miền của tôi; bảng điều khiển hiện nút này bằng tiếng Anh], thêm www.yourbrand.com và thay bản ghi CNAME đang trỏ tới <user>.github.io bằng bản ghi Convika hiển thị. Đưa trang lên tên miền của riêng bạn (tiếng Anh) đi qua từng màn hình, và mã biểu mẫu liên hệ HTML (tiếng Anh) có sẵn một biểu mẫu để sao chép.

Để xem thêm dịch vụ khác, hãy đọc các lựa chọn thay thế GitHub Pages (tiếng Anh).

Skipbox

Cheap & fast GitHub Actions runners, unlimited for $39 a month

Your own machine keeps Docker layers and package caches between jobs. Switch by changing one runs-on line.

Start a free Skipbox trial⁠

Câu hỏi thường gặp

Tôi có dùng miễn phí tên miền riêng với GitHub Pages được không?

Được. GitHub Pages kết nối tên miền riêng mà không tính phí, từ kho mã công khai trên GitHub Free. Bạn chỉ trả tiền tên miền cho nhà đăng ký. Gói Free của Convika cũng kết nối 1 tên miền riêng, kèm biểu mẫu và số liệu khách truy cập, từ một tệp HTML bạn tải lên.

GitHub Pages cần những bản ghi DNS nào?

Với www hoặc tên miền phụ khác, một bản ghi CNAME trỏ tới <user>.github.io. Với tên miền gốc, 4 bản ghi A: 185.199.108.153, 185.199.109.153, 185.199.110.153 và 185.199.111.153, hoặc một bản ghi ALIAS hay ANAME trỏ tới <user>.github.io. Với IPv6, thêm 4 bản ghi AAAA bên cạnh các bản ghi A.

Tên miền riêng trên GitHub Pages mất bao lâu thì chạy?

Tối đa 24 giờ. Tài liệu của GitHub viết rằng thay đổi DNS có thể mất tới 24 giờ để lan ra, HTTPS có thể mất tới một giờ sau khi cấu hình tên miền, và tùy chọn Enforce HTTPS có thể mất tới 24 giờ mới dùng được.

Vì sao tôi không bật được Enforce HTTPS trên GitHub Pages?

Chứng chỉ chưa được cấp. Hãy chờ tới một giờ sau khi đặt tên miền. Nếu vẫn chưa dùng được, hãy gỡ tên miền riêng rồi thêm lại để chạy lại yêu cầu, xóa các bản ghi A, AAAA hoặc CNAME thừa cùng tên, và kiểm tra rằng bản ghi CAA nào cũng cho phép letsencrypt.org. Tên miền đầy đủ phải ngắn hơn 64 ký tự.

Bản ghi CNAME có nên trỏ tới URL của kho mã không?

Không. Hãy trỏ nó tới <user>.github.io hoặc <organization>.github.io, không kèm tên kho mã, kể cả với trang của dự án. GitHub cũng viết rằng đừng trỏ nó tới địa chỉ *.pages.github.io hiện trong phần cài đặt Pages của kho mã.

Tôi có dùng tên miền riêng trên GitHub Pages với kho mã riêng tư được không?

Từ GitHub Pro. Trên GitHub Free, Pages chỉ chạy trong kho mã công khai. Trong cả hai trường hợp, bản thân trang vẫn công khai trên internet. GitHub Pages và kho mã riêng tư (tiếng Anh) có chi tiết.

Tôi có dùng tên miền riêng GitHub Pages cho trang kinh doanh của mình được không?

GitHub viết rằng Pages không được phép dùng để chạy việc kinh doanh trực tuyến, trang thương mại điện tử hay SaaS. Gói Free của Convika cho phép dùng vào việc kinh doanh và kết nối tên miền của bạn với chính các tệp HTML đó, kèm một biểu mẫu lưu từng yêu cầu.

Tôi có kết nối nhiều tên miền với một trang GitHub Pages được không?

Một tên miền gốc và tên miền phụ www của nó, hai tên chuyển hướng cho nhau. Tài liệu của GitHub ghi là không hỗ trợ nhiều hơn một tên miền gốc, hay một tên miền gốc cùng một tên miền phụ riêng khác, và tệp CNAME chỉ chứa một tên miền.

Nguồn

Tất cả lấy từ GitHub Docs, đọc bằng tiếng Anh ngày 17 tháng 11 năm 2026. Các trang không ghi ngày.

Tên miền của bạn, kèm biểu mẫu lưu mọi câu trả lời

Tải tệp HTML lên, xuất bản miễn phí và kết nối www.yourbrand.com bằng 2 bản ghi DNS. Không cần kho mã, HTTPS tự động.

Đưa trang lên tên miền của tôi

Gói Free: không cần thẻ tín dụng, 1 tên miền riêng, 1 trang đã xuất bản, hiện 50 câu trả lời biểu mẫu mỗi tháng.