Skip to main content

About GitHub Pages - GitHub Docs

Bạn có thể sử dụng GitHub Pages để lưu trữ trang web về bản thân, tổ chức hoặc dự án của mình trực tiếp từ kho lưu trữ trên GitHub.

Ai có thể sử dụng tính năng này?​

GitHub Pages có sẵn trong các kho lưu trữ công cộng với GitHub Free và GitHub Free dành cho tổ chức, và trong các kho lưu trữ công cộng và riêng tư với GitHub Pro, GitHub Team, GitHub Enterprise Cloud và GitHub Enterprise Server. Để biết thêm thông tin, hãy xem " Kế hoạch của GitHub ".

GitHub Pages hiện sử dụng GitHub Actions để thực thi bản dựng Jekyll. Khi sử dụng nhánh làm nguồn bản dựng của bạn, GitHub Actions phải được bật trong kho lưu trữ của bạn nếu bạn muốn sử dụng quy trình làm việc Jekyll tích hợp. Ngoài ra, nếu GitHub Actions không khả dụng hoặc bị tắt, việc thêm tệp .nojekyllvào gốc nhánh nguồn của bạn sẽ bỏ qua quy trình dựng Jekyll và triển khai nội dung trực tiếp. Để biết thêm thông tin về cách bật GitHub Actions, hãy xem " Quản lý cài đặt GitHub Actions cho kho lưu trữ ".

Giới thiệu về GitHub Pages​

GitHub Pages là dịch vụ lưu trữ trang web tĩnh lấy các tệp HTML, CSS và JavaScript trực tiếp từ kho lưu trữ trên GitHub, tùy chọn chạy các tệp thông qua quy trình xây dựng và xuất bản trang web. Bạn có thể xem các ví dụ về trang web GitHub Pages trong bộ sưu tập ví dụ GitHub Pages .

Bạn có thể lưu trữ trang web của mình trên miền GitHub github.iohoặc miền tùy chỉnh của riêng bạn. Để biết thêm thông tin, hãy xem " Cấu hình miền tùy chỉnh cho trang GitHub Pages của bạn ".

Bạn có thể tạo các trang GitHub Pages có sẵn công khai trên internet. Các tổ chức sử dụng GitHub Enterprise Cloud cũng có thể xuất bản các trang web riêng tư bằng cách quản lý quyền kiểm soát truy cập cho trang web. Để biết thêm thông tin, hãy xem " Thay đổi khả năng hiển thị của trang GitHub Pages của bạn " trong tài liệu GitHub Enterprise Cloud.

Để bắt đầu, hãy xem " Tạo trang GitHub Pages ".

Chủ sở hữu tổ chức có thể vô hiệu hóa việc xuất bản các trang GitHub Pages từ kho lưu trữ của tổ chức. Để biết thêm thông tin, hãy xem " Quản lý việc xuất bản các trang GitHub Pages cho tổ chức của bạn ".

Các loại trang GitHub Pages​

Có ba loại trang GitHub Pages: dự án, người dùng và tổ chức. Các trang dự án được kết nối với một dự án cụ thể được lưu trữ trên GitHub, chẳng hạn như thư viện JavaScript hoặc bộ sưu tập công thức nấu ăn. Các trang người dùng và tổ chức được kết nối với một tài khoản cụ thể trên GitHub.com.

Để xuất bản trang web của người dùng, bạn phải tạo một kho lưu trữ thuộc sở hữu của tài khoản cá nhân của bạn có tên là <username>.github.io. Để xuất bản trang web của tổ chức, bạn phải tạo một kho lưu trữ thuộc sở hữu của tổ chức có tên là <organization>.github.io. Trừ khi bạn đang sử dụng tên miền tùy chỉnh, các trang web của người dùng và tổ chức sẽ khả dụng tại http(s)://<username>.github.iohoặc http(s)://<organization>.github.io.

Các tệp nguồn cho một trang web dự án được lưu trữ trong cùng một kho lưu trữ với dự án của họ. Trừ khi bạn đang sử dụng một miền tùy chỉnh, các trang web dự án có sẵn tại http(s)://<username>.github.io/<repository>hoặc http(s)://<organization>.github.io/<repository>.

Để biết thêm thông tin về cách tên miền tùy chỉnh ảnh hưởng đến URL cho trang web của bạn, hãy xem " Giới thiệu về tên miền tùy chỉnh và Trang GitHub ."

Bạn chỉ có thể tạo một trang web người dùng hoặc tổ chức cho mỗi tài khoản trên GitHub. Các trang web dự án, dù thuộc sở hữu của tổ chức hay tài khoản cá nhân, đều không giới hạn.

Xuất bản nguồn cho các trang GitHub Pages​

Cảnh báo : Các trang GitHub Pages có sẵn công khai trên internet, ngay cả khi kho lưu trữ của trang web là riêng tư (nếu kế hoạch hoặc tổ chức của bạn cho phép). Nếu bạn có dữ liệu nhạy cảm trong kho lưu trữ của trang web, bạn có thể muốn xóa dữ liệu trước khi xuất bản. Để biết thêm thông tin, hãy xem " Giới thiệu về kho lưu trữ ".

Bạn có thể xuất bản trang web của mình khi có thay đổi được đẩy đến một nhánh cụ thể hoặc bạn có thể viết quy trình công việc GitHub Actions để xuất bản trang web của mình.

Nếu bạn không cần bất kỳ quyền kiểm soát nào đối với quy trình xây dựng cho trang web của mình, chúng tôi khuyên bạn nên xuất bản trang web của mình khi các thay đổi được đẩy đến một nhánh cụ thể. Bạn có thể chỉ định nhánh và thư mục nào để sử dụng làm nguồn xuất bản của mình. Nhánh nguồn có thể là bất kỳ nhánh nào trong kho lưu trữ của bạn và thư mục nguồn có thể là gốc của kho lưu trữ ( /) trên nhánh nguồn hoặc một /docsthư mục trên nhánh nguồn. Bất cứ khi nào các thay đổi được đẩy đến nhánh nguồn, các thay đổi trong thư mục nguồn sẽ được xuất bản lên trang GitHub Pages của bạn.

Nếu bạn muốn sử dụng quy trình xây dựng khác ngoài Jekyll hoặc không muốn có nhánh chuyên dụng để lưu trữ các tệp tĩnh đã biên dịch, chúng tôi khuyên bạn nên viết quy trình làm việc GitHub Actions để xuất bản trang web của mình. GitHub cung cấp các mẫu quy trình làm việc cho các tình huống xuất bản phổ biến để giúp bạn viết quy trình làm việc của mình.

Để biết thêm thông tin, hãy xem " Cấu hình nguồn xuất bản cho trang GitHub Pages của bạn ".

Máy phát trang web tĩnh​

GitHub Pages xuất bản bất kỳ tệp tĩnh nào bạn đẩy lên kho lưu trữ của mình. Bạn có thể tạo tệp tĩnh của riêng mình hoặc sử dụng trình tạo trang web tĩnh để xây dựng trang web cho bạn. Bạn cũng có thể tùy chỉnh quy trình xây dựng của riêng mình cục bộ hoặc trên máy chủ khác.

Nếu bạn sử dụng quy trình xây dựng tùy chỉnh hoặc trình tạo trang web tĩnh khác với Jekyll, bạn có thể viết GitHub Actions để xây dựng và xuất bản trang web của mình. GitHub cung cấp các mẫu quy trình làm việc cho một số trình tạo trang web tĩnh. Để biết thêm thông tin, hãy xem " Cấu hình nguồn xuất bản cho trang web GitHub Pages của bạn ".

Nếu bạn xuất bản trang web của mình từ nhánh nguồn, GitHub Pages sẽ sử dụng Jekyll để xây dựng trang web của bạn theo mặc định. Nếu bạn muốn sử dụng trình tạo trang web tĩnh khác ngoài Jekyll, chúng tôi khuyên bạn nên viết GitHub Actions để xây dựng và xuất bản trang web của mình thay thế. Nếu không, hãy tắt quy trình xây dựng Jekyll bằng cách tạo một tệp trống có tên .nojekylltrong thư mục gốc của nguồn xuất bản của bạn, sau đó làm theo hướng dẫn của trình tạo trang web tĩnh để xây dựng trang web của bạn cục bộ.

GitHub Pages không hỗ trợ các ngôn ngữ phía máy chủ như PHP, Ruby hoặc Python.

Giới hạn sử dụng GitHub Pages​

Các trang GitHub Pages được tạo sau ngày 15 tháng 6 năm 2016 và sử dụng github.iotên miền được phục vụ qua HTTPS. Nếu bạn đã tạo trang web của mình trước ngày 15 tháng 6 năm 2016, bạn có thể bật hỗ trợ HTTPS cho lưu lượng truy cập vào trang web của mình. Để biết thêm thông tin, hãy xem " Bảo mật trang GitHub Pages của bạn bằng HTTPS ".

Sử dụng bị cấm​

GitHub Pages không được thiết kế hoặc cho phép sử dụng như một dịch vụ lưu trữ web miễn phí để điều hành doanh nghiệp trực tuyến, trang web thương mại điện tử hoặc bất kỳ trang web nào khác chủ yếu hướng đến mục đích tạo điều kiện cho các giao dịch thương mại hoặc cung cấp phần mềm thương mại dưới dạng dịch vụ (SaaS). Không nên sử dụng các trang GitHub Pages cho các giao dịch nhạy cảm như gửi mật khẩu hoặc số thẻ tín dụng.

Ngoài ra, việc bạn sử dụng GitHub Pages phải tuân theo Điều khoản dịch vụ của GitHub , bao gồm các hạn chế về chương trình làm giàu nhanh chóng, nội dung khiêu dâm và nội dung hoặc hoạt động bạo lực hoặc đe dọa.

Bài tập giáo dục​

Việc sử dụng GitHub Pages để tạo bản sao của trang web hiện có làm bài tập học tập không bị cấm. Tuy nhiên, ngoài việc tuân thủ Điều khoản dịch vụ của GitHub , bạn phải tự viết mã, trang web không được thu thập bất kỳ dữ liệu người dùng nào và bạn phải đưa vào tuyên bố từ chối trách nhiệm nổi bật trên trang web cho biết rằng dự án không liên quan đến bản gốc và chỉ được tạo ra cho mục đích giáo dục.

Giới hạn sử dụng​

Các trang GitHub Pages phải tuân theo các giới hạn sử dụng sau:

  • Kho lưu trữ nguồn GitHub Pages có giới hạn khuyến nghị là 1 GB. Để biết thêm thông tin, hãy xem " Về các tệp lớn trên GitHub "

  • Các trang GitHub Pages đã xuất bản không được lớn hơn 1 GB.

  • Việc triển khai GitHub Pages sẽ hết thời gian nếu mất hơn 10 phút.

  • Các trang GitHub Pages có giới hạn băng thông mềm là 100 GB mỗi tháng.

  • Các trang GitHub Pages có giới hạn mềm là 10 bản dựng mỗi giờ. Giới hạn này không áp dụng nếu bạn xây dựng và xuất bản trang web của mình bằng quy trình làm việc GitHub Actions tùy chỉnh.

  • Để cung cấp chất lượng dịch vụ nhất quán cho tất cả các trang GitHub Pages, có thể áp dụng giới hạn tốc độ. Các giới hạn tốc độ này không nhằm mục đích can thiệp vào việc sử dụng hợp pháp GitHub Pages. Nếu yêu cầu của bạn kích hoạt giới hạn tốc độ, bạn sẽ nhận được phản hồi phù hợp với mã trạng thái HTTP là 429, cùng với nội dung HTML có thông tin.

Nếu trang web của bạn vượt quá hạn ngạch sử dụng này, chúng tôi có thể không thể phục vụ trang web của bạn hoặc bạn có thể nhận được email lịch sự từ GitHub Support đề xuất các chiến lược để giảm tác động của trang web của bạn lên máy chủ của chúng tôi, bao gồm đặt mạng phân phối nội dung (CDN) của bên thứ ba trước trang web của bạn, sử dụng các tính năng khác của GitHub như bản phát hành hoặc chuyển sang dịch vụ lưu trữ khác có thể phù hợp hơn với nhu cầu của bạn.

Các loại MIME trên GitHub Pages​

Kiểu MIME là tiêu đề mà máy chủ gửi đến trình duyệt, cung cấp thông tin về bản chất và định dạng của các tệp mà trình duyệt yêu cầu. GitHub Pages hỗ trợ hơn 750 kiểu MIME trên hàng nghìn phần mở rộng tệp. Danh sách các kiểu MIME được hỗ trợ được tạo từ dự án mime-db .

Mặc dù bạn không thể chỉ định các loại MIME tùy chỉnh trên cơ sở từng tệp hoặc từng kho lưu trữ, bạn có thể thêm hoặc sửa đổi các loại MIME để sử dụng trên GitHub Pages. Để biết thêm thông tin, hãy xem hướng dẫn đóng góp mime-db .

Thu thập dữ liệu​

Khi truy cập trang GitHub Pages, địa chỉ IP của khách truy cập sẽ được ghi lại và lưu trữ cho mục đích bảo mật, bất kể khách truy cập có đăng nhập vào GitHub hay không. Để biết thêm thông tin về các biện pháp bảo mật của GitHub, hãy xem Tuyên bố về quyền riêng tư của GitHub .

Đọc thêm​

5:11:27 AM