• 先决条件
• 为您的自定义域名启用 Let’s Encrypt 集成
• 故障排除
  • 错误 “Something went wrong while obtaining the Let’s Encrypt certificate”
  • 消息 “GitLab is obtaining a Let’s Encrypt SSL certificate for this domain. This process can take some time. Please try again later.” 持续超过一小时

Pages 与 Let’s Encrypt 集成

Pages 与 Let’s Encrypt (LE) 的集成允许您将 LE 证书用于具有自定义域名的 Pages 网站，而无需自己发布和更新它们。

Let’s Encrypt 是一个免费的、自动化的和开源的证书颁发机构。

先决条件

在为您的域名启用 SSL 证书的自动配置之前，请确保您具有：

• 在极狐GitLab 中创建了一个项目，其中包含您网站的源代码。
• 获取一个域名 (example.com) 并添加一个 DNS 条目，将其指向您的 Pages 网站。顶级域名 (.com) 必须是公共后缀。
• 将您的域名添加到您的 Pages 项目并验证您的所有权。
• 验证您的网站已启动并正在运行，可通过您的自定义域名访问。

对于私有化部署实例，请确保您的管理员已启用它。

为您的自定义域名启用 Let’s Encrypt 集成

满足要求后，启用 Let’s Encrypt 集成：

1. 导航到您项目的 设置 > Pages。
2. 找到您的域并选择 详情。
3. 选择右上角的 编辑。

4. 通过切换 使用 Let’s Encrypt 的自动证书管理 启用 Let’s Encrypt 集成：

   

5. 选择 保存修改。

启用后，系统将获得 LE 证书并将其添加到关联的 Pages 域名。系统也会自动更新它。

注意：

• 颁发证书和更新 Pages 配置最多可能需要一个小时。
• 如果您在域名设置中已经有 SSL 证书，它会继续工作，直到被 Let’s Encrypt 的证书取代。

故障排除

错误 “Something went wrong while obtaining the Let’s Encrypt certificate”

如果您收到错误 “Something went wrong while obtaining the Let’s Encrypt certificate”，首先，请确保您的 Pages 站点在项目的 设置 > 通用 > 可见性 中设置为“所有人”，这样可以允许 Let’s Encrypt Servers 访问您的 Pages 站点。确认后，您可以按照以下步骤再次尝试获取证书：

1. 转到您项目的 设置 > Pages。
2. 在您的域中选择 编辑。
3. 选择 重试。
4. 如果您仍然看到相同的错误：
   1. 确保您只为您的域名正确设置了一个 DNS CNAME 或 A 记录。
   2. 确保您的域名没有 AAAA DNS 记录。
   3. 如果您的域名或任何更高级别的域名有 CAA DNS 记录，请确保 它包括 letsencrypt.org。
   4. 确保您的域名已验证。
   5. 转到步骤 1。

消息 “GitLab is obtaining a Let’s Encrypt SSL certificate for this domain. This process can take some time. Please try again later.” 持续超过一小时

如果您已启用 Let’s Encrypt 集成，但一个小时后证书不存在，并且您看到消息 “GitLab is obtaining a Let’s Encrypt SSL certificate for this domain. This process can take some time. Please try again later.”，尝试按照以下步骤再次删除和添加 Pages 的域名：

1. 转到您项目的 设置 > Pages。
2. 在您的域名中选择 删除。
3. 再次添加域名并验证。
4. 为您的域名启用 Let’s Encrypt 集成。
5. 如果一段时间后您仍然看到相同的消息：
   1. 确保您只为您的域名正确设置了一个 DNS CNAME 或 A 记录。
   2. 确保您的域名没有 AAAA DNS 记录。
   3. 如果您的域名或任何更高级别的域名有 CAA DNS 记录，请确保它包括 letsencrypt.org。
   4. 转到步骤 1。