GitLab Pages domain names, URLs, and baseurls · Gitlab 中文文檔

# GitLab Pages domain names, URLs, and baseurls > 原文：[https://docs.gitlab.com/ee/user/project/pages/getting_started_part_one.html](https://docs.gitlab.com/ee/user/project/pages/getting_started_part_one.html) * [GitLab Pages default domain names](#gitlab-pages-default-domain-names) * [Project website examples](#project-website-examples) * [User and Group website examples](#user-and-group-website-examples) * [URLs and baseurls](#urls-and-baseurls) * [Custom domains](#custom-domains) # GitLab Pages domain names, URLs, and baseurls[](#gitlab-pages-domain-names-urls-and-baseurls "Permalink") 在本文檔中，了解如何根據所需網站的 URL 為 GitLab Pages 命名項目. ## GitLab Pages default domain names[](#gitlab-pages-default-domain-names "Permalink") > **注意：**如果您使用自己的 GitLab 實例通過 GitLab Pages 部署站點，請與 sysadmin 一起檢查什么是 Pages 通配符域. 本指南適用于任何 GitLab 實例，您只需要用自己的實例替換 GitLab.com（ `*.gitlab.io` ）上的 Pages 通配符域. 如果您在 GitLab 上設置了 GitLab Pages 項目，則可以在`namespace.example.io`的子域下自動訪問它. [`namespace`](../../group/index.html#namespaces)由您在 GitLab.com 上的用戶名或在其下創建此項目的組名定義. 對于 GitLab 自我管理的實例，將`example.io`替換為實例的 Pages 域. 對于 GitLab.com，頁面域為`*.gitlab.io` . | GitLab 頁面的類型 | The name of the project created in GitLab | 網址 | | --- | --- | --- | | 用戶頁面 | `username.example.io` | `http(s)://username.example.io` | | 組頁面 | `groupname.example.io` | `http(s)://groupname.example.io` | | 用戶擁有的項目頁面 | `projectname` | `http(s)://username.example.io/projectname` | | 小組擁有的項目頁面 | `projectname` | `http(s)://groupname.example.io/projectname` | | 子組擁有的項目頁面 | `subgroup/projectname` | `http(s)://groupname.example.io/subgroup/projectname` | **警告：**關于在通用域名和 HTTPS 下提供的名稱空間存在一些已知[限制](introduction.html#limitations) . 確保閱讀該部分. 要清楚地了解 Pages 域，請閱讀以下示例. ### Project website examples[](#project-website-examples "Permalink") * 您在用戶名`john`下創建了一個名為`blog`的項目，因此您的項目 URL 為`https://gitlab.com/john/blog/` . 為該項目啟用 GitLab Pages 并構建您的網站后，即可在`https://john.gitlab.io/blog/`下找到該網站. * 您為所有網站創建了一個組，稱為`websites` ，該組中的一個項目稱為`blog` . 您的項目 URL 為`https://gitlab.com/websites/blog/` . 為該項目啟用 GitLab 頁面后，該站點將位于`https://websites.gitlab.io/blog/`下. * 您為工程部門創建了一個名為`engineering`的組，為所有文檔網站創建了一個名為`docs`的子組，該子組中的一個項目稱為`workflows` . 您的項目網址為`https://gitlab.com/engineering/docs/workflows/` . 為該項目啟用 GitLab 頁面后，該站點將位于`https://engineering.gitlab.io/docs/workflows`下. ### User and Group website examples[](#user-and-group-website-examples "Permalink") * 在您的用戶名`john` ，您創建了一個名為`john.gitlab.io`的項目. 您的項目 URL 將為`https://gitlab.com/john/john.gitlab.io` . 為項目啟用 GitLab Pages 后，您的網站將發布在`https://john.gitlab.io`下. * 在小組`websites` ，您創建了一個名為`websites.gitlab.io`的項目. 您項目的 URL 將為`https://gitlab.com/websites/websites.gitlab.io` . 為項目啟用 GitLab Pages 后，您的網站將發布在`https://websites.gitlab.io`下. **一般示例：** * 在 GitLab.com 上，項目站點將始終在`https://namespace.gitlab.io/project-name`下可用 * 在 GitLab.com 上，將在`https://namespace.gitlab.io/`下提供用戶或組網站. * 在您的 GitLab 實例上，將上述`gitlab.io`替換為 Pages 服務器域. 向您的系統管理員詢問此信息. ## URLs and baseurls[](#urls-and-baseurls "Permalink") 每個靜態網站發生器（SSG）的默認配置期望找到您的網站下一個（子）域（ `example.com` ），而不是在該領域（的子目錄`example.com/subdir` ）. 因此，每當發布項目網站（ `namespace.gitlab.io/project-name` ）時，都必須在 SSG 文檔中查找此配置（基本 URL）并進行設置以反映此模式. 例如，對于 Jekyll 站點， `baseurl`是在 Jekyll 配置文件`_config.yml`定義的. 如果您的網站 URL 是`https://john.gitlab.io/blog/` ，則需要將此行添加到`_config.yml` ： ``` baseurl: "/blog" ``` 相反，如果您在派生我們的[默認示例](https://gitlab.com/pages)之一后部署網站，則已經以這種方式配置了 baseurl，因為所有示例都包含項目網站. 如果您決定將自己的網站設為用戶或網上論壇，則必須從項目中刪除此配置. 對于我們剛剛提到的 Jekyll 示例，您必須將 Jekyll 的`_config.yml`更改為： ``` baseurl: "" ``` ## Custom domains[](#custom-domains "Permalink") GitLab 頁面支持通過 HTTP 或 HTTPS 提供服務的自定義域和子域. 有關更多信息，請參見[GitLab Pages 自定義域和 SSL / TLS 證書](custom_domains_ssl_tls_certification/index.html) .