GitLab Pages integration with Let's Encrypt · Gitlab 中文文檔

# GitLab Pages integration with Let's Encrypt > 原文：[https://docs.gitlab.com/ee/user/project/pages/custom_domains_ssl_tls_certification/lets_encrypt_integration.html](https://docs.gitlab.com/ee/user/project/pages/custom_domains_ssl_tls_certification/lets_encrypt_integration.html) * [Requirements](#requirements) * [Enabling Let’s Encrypt integration for your custom domain](#enabling-lets-encrypt-integration-for-your-custom-domain) * [Troubleshooting](#troubleshooting) * [Error “Something went wrong while obtaining the Let’s Encrypt certificate”](#error-something-went-wrong-while-obtaining-the-lets-encrypt-certificate) * [Message “GitLab is obtaining a Let’s Encrypt SSL certificate for this domain. This process can take some time. Please try again later.” hangs for more than an hour](#message-gitlab-is-obtaining-a-lets-encrypt-ssl-certificate-for-this-domain-this-process-can-take-some-time-please-try-again-later-hangs-for-more-than-an-hour) # GitLab Pages integration with Let’s Encrypt[](#gitlab-pages-integration-with-lets-encrypt "Permalink") 在 GitLab 12.1 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/28996) . 對于 GitLab 12.1 之前的版本，請參見[手冊"讓我們加密"說明](../lets_encrypt_for_gitlab_pages.html) . GitLab Pages 與 Let's Encrypt（LE）的集成使您可以將 LE 證書用于具有自定義域的 Pages 網站，而不必麻煩自己發行和更新它們. GitLab 現成的為您服務. [Let's Encrypt](https://letsencrypt.org)是一個免費，自動化和開源的證書頒發機構. **警告：**此功能僅涵蓋**自定義域的**證書，而不包含運行[Pages 守護程序](../../../../administration/pages/index.html)所需的通配符證書 . 在[此問題中](https://gitlab.com/gitlab-org/omnibus-gitlab/-/issues/3342)跟蹤通配符證書的生成. ## Requirements[](#requirements "Permalink") 在為您的域啟用自動配置 SSL 證書之前，請確保您具有： * 創建一個[項目](../getting_started_part_two.html)在 GitLab 包含您的網站的源代碼. * 獲取域（ `example.com` ）并添加一個[DNS 條目，](index.html)將其指向您的 Pages 網站. * [將您的域添加到您的 Pages 項目](index.html#1-add-a-custom-domain-to-pages)并驗證您的所有權. * 確認您的網站已啟動并且正在運行，可以通過您的自定義域進行訪問. **注意：** GitLab 的"讓我們加密"集成已啟用，并在 GitLab.com 上可用. 對于**自我管理的** GitLab 實例，請確保您的管理員已[啟用它](../../../../administration/pages/index.html#lets-encrypt-integration) . ## Enabling Let’s Encrypt integration for your custom domain[](#enabling-lets-encrypt-integration-for-your-custom-domain "Permalink") 滿足要求后，啟用"讓我們加密"集成： 1. 導航到項目的**"設置">"頁面"** . 2. 找到您的域，然后單擊**詳細信息** . 3. 點擊右上角的**編輯** . 4. 通過**使用 Let's Encrypt**切換**自動證書管理來**啟用 Let's Encrypt 集成： [![Enable Let's Encrypt](https://img.kancloud.cn/bb/82/bb82414d2dec7acc69f83e395f9b99a3_1268x197.png)](img/lets_encrypt_integration_v12_1.png) 5. Click **保存更改**. 啟用后，GitLab 將獲得 LE 證書并將其添加到關聯的 Pages 域中. 它也會由 GitLab 自動更新. > **Notes:** > > * 頒發證書和更新 Pages 配置**可能需要一個小時** . > * 如果您在域設置中已經具有 SSL 證書，它將繼續工作，直到被 Let's Encrypt 的證書替換為止. ## Troubleshooting[](#troubleshooting "Permalink") ### Error “Something went wrong while obtaining the Let’s Encrypt certificate”[](#error-something-went-wrong-while-obtaining-the-lets-encrypt-certificate "Permalink") 在 GitLab 13.0 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/30146) . 如果您遇到錯誤， **則在獲取 Let's Encrypt 證書時出了點問題** ，您可以嘗試按照以下步驟再次獲取證書： 1. 轉到項目的**設置>頁面** . 2. 在您的域上單擊" **編輯** ". 3. Click **Retry**. 4. 如果您仍然看到相同的錯誤： 1. 請確保您已正確設置只有一個`CNAME`或`A` DNS 記錄為您的域. 2. 確保您的域**沒有** `AAAA` DNS 記錄. 3. 如果您的域或任何更高級別的域都有`CAA` DNS 記錄，請確保[其中包含`letsencrypt.org`](https://letsencrypt.org/docs/caa/) . 4. 確保[您的域已驗證](index.html#1-add-a-custom-domain-to-pages) . 5. 轉到步驟 1\. ### Message “GitLab is obtaining a Let’s Encrypt SSL certificate for this domain. This process can take some time. Please try again later.” hangs for more than an hour[](#message-gitlab-is-obtaining-a-lets-encrypt-ssl-certificate-for-this-domain-this-process-can-take-some-time-please-try-again-later-hangs-for-more-than-an-hour "Permalink") 如果您啟用了 Let's Encrypt 集成，但是一個小時后缺少證書，則會看到以下消息：" GitLab 正在為此域獲取 Let's Encrypt SSL 證書. 此過程可能需要一些時間. 請稍后再試."，請按照以下步驟嘗試刪除并再次為 GitLab 頁面添加域： 1. 轉到項目的**設置>頁面** . 2. 在您的域上單擊**刪除** . 3. [Add the domain again and verify it](index.html#1-add-a-custom-domain-to-pages). 4. [Enable Let’s Encrypt integration for your domain](#enabling-lets-encrypt-integration-for-your-custom-domain). 5. 如果一段時間后仍然看到相同的消息： 1. 請確保您已正確設置只有一個`CNAME`或`A` DNS 記錄為您的域. 2. 確保您的域**沒有** `AAAA` DNS 記錄. 3. 如果您的域或任何更高級別的域都有`CAA` DNS 記錄，請確保[其中包含`letsencrypt.org`](https://letsencrypt.org/docs/caa/) . 4. 轉到步驟 1\.