GitLab Pages · Gitlab 中文文檔

# GitLab Pages > 原文：[https://docs.gitlab.com/ee/user/project/pages/#getting-started](https://docs.gitlab.com/ee/user/project/pages/#getting-started) * [Getting started](#getting-started) * [How it works](#how-it-works) * [Access to your Pages site](#access-to-your-pages-site) * [Pages examples](#pages-examples) * [Administer GitLab Pages for self-managed instances](#administer-gitlab-pages-for-self-managed-instances) # GitLab Pages[](#gitlab-pages "Permalink") 版本歷史 * 在 GitLab 企業版 8.3 中[引入](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/80) . * GitLab 企業版 8.5 中[引入](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/173)了具有 TLS 支持的自定義 CNAME. * [移植](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/14605)到 GitLab 8.17 中的 GitLab 社區版. * 在 GitLab 11.8 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/30548)了對子組項目網站的支持. * 捆綁的項目模板在 GitLab 11.8 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/47857) . 借助 GitLab 頁面，您可以直接從 GitLab 中的存儲庫發布靜態網站. * 用于任何個人或企業網站. * 使用任何靜態站點生成器（SSG）或純 HTML. * 為您的項目，組或用戶帳戶創建網站. * 免費在自己的 GitLab 實例或 GitLab.com 上托管您的網站. * 連接您的自定義域和 TLS 證書. * 將任何許可歸于您的內容. ![Examples of SSGs supported by Pages](https://img.kancloud.cn/60/b9/60b9bf04efe42919d2f712c5807c8d16_600x280.png) 要發布包含 Pages 的網站，您可以使用任何 SSG，例如 Gatsby，Jekyll，Hugo，Middleman，Harp，Hexo 和 Brunch 等. 您還可以發布直接用純 HTML，CSS 和 JavaScript 編寫的任何網站. 網頁**不**支持動態服務器端的處理，例如，作為`.php`和`.asp`需要. 了解更多有關[靜態網站和動態網站的信息](https://about.gitlab.com/blog/2016/06/03/ssg-overview-gitlab-pages-part-1-dynamic-x-static/) . ## Getting started[](#getting-started "Permalink") 要創建一個 GitLab Pages 網站： | Document | Description | | --- | --- | | [Fork a sample project](getting_started/pages_forked_sample_project.html) | 通過分叉示例項目，使用已配置的 Pages 創建一個新項目. | | [Use a new project template](getting_started/pages_new_project_template.html) | 使用已經使用新項目模板配置的 Pages 創建一個新項目. | | [Use a `.gitlab-ci.yml` template](getting_started/pages_ci_cd_template.html) | 將 Pages 網站添加到現有項目. 使用預填充的 CI 模板文件. | | [Create a `gitlab-ci.yml` file from scratch](getting_started/pages_from_scratch.html) | 將 Pages 網站添加到現有項目. 了解如何創建和配置自己的 CI 文件. | 要更新 GitLab Pages 網站： | Document | Description | | --- | --- | | [GitLab Pages domain names, URLs, and base URLs](getting_started_part_one.html) | 了解有關 GitLab Pages 默認域的信息. | | [Explore GitLab Pages](introduction.html) | 要求，技術方面，特定的 GitLab CI / CD 配置選項，訪問控制，自定義 404 頁面，限制，常見問題解答. | | [Custom domains and SSL/TLS Certificates](custom_domains_ssl_tls_certification/index.html) | 自定義域和子域，DNS 記錄和 SSL / TLS 證書. | | [Let’s Encrypt integration](custom_domains_ssl_tls_certification/lets_encrypt_integration.html) | 使用 Let's Encrypt 證書保護您的 Pages 網站，該證書由 GitLab 自動獲取并更新. | | [CloudFlare certificates](https://about.gitlab.com/blog/2017/02/07/setting-up-gitlab-pages-with-cloudflare-certificates/) | 使用 CloudFlare 證書保護您的 Pages 網站. | 了解更多信息并查看示例： | Document | Description | | --- | --- | | [Static vs dynamic websites](https://about.gitlab.com/blog/2016/06/03/ssg-overview-gitlab-pages-part-1-dynamic-x-static/) | 靜態與動態網站概述. | | [Modern static site generators](https://about.gitlab.com/blog/2016/06/10/ssg-overview-gitlab-pages-part-2/) | SSG 概述. | | [Build any SSG site with GitLab Pages](https://about.gitlab.com/blog/2016/06/17/ssg-overview-gitlab-pages-part-3-examples-ci/) | 對 GitLab 頁面使用 SSG. | ## How it works[](#how-it-works "Permalink") 要使用 GitLab 頁面，您必須在 GitLab 中創建一個項目以將您網站的文件上傳到該項目. 這些項目可以是公共的，內部的或私人的. GitLab 始終從資源庫中一個非常特定的文件夾`public`部署您的網站. 在 GitLab 中創建新項目時， [存儲庫](../repository/index.html)將自動可用. 為了部署您的站點，GitLab 使用其內置工具[GitLab CI / CD](../../../ci/README.html)來構建您的站點并將其發布到 GitLab Pages 服務器. GitLab CI / CD 運行以完成此任務的腳本序列是從名為`.gitlab-ci.yml`的文件中[創建的](getting_started/pages_from_scratch.html) ，您可以隨意[創建和修改](getting_started/pages_from_scratch.html) . 配置文件中稱為`pages`的特定`job`會使 GitLab 知道您正在部署 GitLab Pages 網站. 您可以將 GitLab 的[默認域用于](getting_started_part_one.html#gitlab-pages-default-domain-names) `*.gitlab.io` [GitLab Pages 網站](getting_started_part_one.html#gitlab-pages-default-domain-names) `*.gitlab.io` ，也可以使用自己的域（ `example.com` ）. 在這種情況下，您需要對您域的注冊商（或控制面板）具有管理員權限，才能使用 Pages 對其進行設置. 下圖顯示了開始使用 Pages 可能需要遵循的工作流程. ![New projects for GitLab Pages](https://img.kancloud.cn/59/74/5974318eeb94aebb664f2326051362ff_2517x1957.png) ## Access to your Pages site[](#access-to-your-pages-site "Permalink") 如果您使用的是 GitLab Pages 默認域（ `.gitlab.io` ），則您的網站將自動安全并在 HTTPS 下可用. 如果您使用自己的自定義域，則可以選擇使用 SSL / TLS 證書對其進行保護. If you’re using GitLab.com, your website will be publicly available to the internet. To restrict access to your website, enable [GitLab Pages Access Control](pages_access_control.html). 如果您使用的是自我管理的實例（Core，Starter，Premium 或 Ultimate），則根據 sysadmin 選擇的[Pages admin 設置](../../../administration/pages/index.html) ，您的網站將發布在您自己的服務器上，管理員可以將其設置為公開或內部. ## Pages examples[](#pages-examples "Permalink") 有一些因特定原因而建立的 GitLab Pages 網站的出色示例. 這些示例可以教您使用高級技術并適應您自己的需求： * [Posting to your GitLab Pages blog from iOS](https://about.gitlab.com/blog/2016/08/19/posting-to-your-gitlab-pages-blog-from-ios/). * [GitLab CI: Run jobs sequentially, in parallel, or build a custom pipeline](https://about.gitlab.com/blog/2016/07/29/the-basics-of-gitlab-ci/). * [GitLab CI: Deployment & environments](https://about.gitlab.com/blog/2016/08/26/ci-deployment-and-environments/). * [Building a new GitLab docs site with Nanoc, GitLab CI, and GitLab Pages](https://about.gitlab.com/blog/2016/12/07/building-a-new-gitlab-docs-site-with-nanoc-gitlab-ci-and-gitlab-pages/). * [Publish code coverage reports with GitLab Pages](https://about.gitlab.com/blog/2016/11/03/publish-code-coverage-report-with-gitlab-pages/). ## Administer GitLab Pages for self-managed instances[](#administer-gitlab-pages-for-self-managed-instances "Permalink") 如果您正在運行 GitLab 的自我管理實例（GitLab 社區版和企業版），請[按照管理步驟](../../../administration/pages/index.html)來配置頁面. 觀看有關如何開始使用 GitLab 頁面管理的[視頻教程](https://www.youtube.com/watch?v=dD8c7WNcc6s) .