GitLab Pages domain names, URLs, and baseurls
GitLab Pages domain names, URLs, and baseurls
在本文档中,了解如何根据所需网站的 URL 为 GitLab Pages 命名项目.
注意:如果您使用自己的 GitLab 实例通过 GitLab Pages 部署站点,请与 sysadmin 一起检查什么是 Pages 通配符域. 本指南适用于任何 GitLab 实例,您只需要用自己的实例替换 GitLab.com( )上的 Pages 通配符域.
警告:关于在通用域名和 HTTPS 下提供的名称空间存在一些已知限制 . 确保阅读该部分.
要清楚地了解 Pages 域,请阅读以下示例.
- 您在用户名
john
下创建了一个名为的项目,因此您的项目 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/
下.
User and Group website examples
- 在您的用户名
john
,您创建了一个名为john.gitlab.io
的项目. 您的项目 URL 将为https://gitlab.com/john/john.gitlab.io
. 为项目启用 GitLab Pages 后,您的网站将发布在https://john.gitlab.io
下. - 在小组 ,您创建了一个名为
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 服务器域. 向您的系统管理员询问此信息.
每个静态网站发生器(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: ""
GitLab 页面支持通过 HTTP 或 HTTPS 提供服务的自定义域和子域. 有关更多信息,请参见GitLab Pages 自定义域和 SSL / TLS 证书 .