跳至主要内容
电子前沿基金会项目

Certbot 指南

您的 HTTP 网站运行在哪个平台上?

我的 HTTP 网站运行在

Linux (pip) 上的网络托管产品

默认
通配符

要使用 Certbot,您需要...

A laptop
命令行
Close button

命令行是一种通过键入文本命令与计算机交互的方式,并接收文本回复。Certbot 通常在类 Unix 服务器上通过命令行界面运行。为了在大多数情况下使用 Certbot,您需要能够在 Web 服务器的命令行上安装并运行它,通常通过 SSH 访问。

命令行是一种通过键入文本命令与计算机交互的方式,并接收文本...

命令行
命令行

命令行是一种通过键入文本命令与计算机交互的方式,并接收文本回复。Certbot 通常在类 Unix 服务器上通过命令行界面运行。为了在大多数情况下使用 Certbot,您需要能够在 Web 服务器的命令行上安装并运行它,通常通过 SSH 访问。

Web browser showing an HTTP site
...和一个
HTTP 网站
Close button

HTTP(超文本传输协议)是传统但非安全的网络浏览器从网络服务器请求网页和其他在线资源内容的方法。它是一种互联网标准,通常与 TCP 端口 80 配合使用。世界上几乎所有网站都支持 HTTP,但是使用 Certbot 或其他设置 HTTPS 的方法配置的网站可能会自动将用户从网站的 HTTP 版本重定向到 HTTPS 版本。

HTTP(超文本传输协议)是传统但非安全的网络浏览器从网络服务器请求...

HTTP 网站
HTTP

HTTP(超文本传输协议)是传统但非安全的网络浏览器从网络服务器请求网页和其他在线资源内容的方法。它是一种互联网标准,通常与 TCP 端口 80 配合使用。世界上几乎所有网站都支持 HTTP,但是使用 Certbot 或其他设置 HTTPS 的方法配置的网站可能会自动将用户从网站的 HTTP 版本重定向到 HTTPS 版本。


已经
在线
Close button

Certbot 通常用于将现有的 HTTP 网站切换为 HTTPS(并且,随后在必要时持续更新网站的 HTTPS 证书)。一些 Certbot 文档假设或建议您拥有一个可以通过 HTTP 在端口 80 上访问的工作网站。这意味着,例如,如果您使用网络浏览器通过 http:// 访问您的域名,您的 Web 服务器会做出响应,并且会显示某种内容(即使它只是默认的欢迎页面而不是您网站的最终版本)。一些使用 Certbot 的方法将此作为先决条件,因此,如果您已经有一个使用 HTTP 设置的网站,您将获得更顺畅的体验。(如果出于策略原因您的网站无法通过这种方式访问,您可能需要使用 DNS 验证才能通过 Certbot 获取证书。)

Certbot 通常用于将现有的 HTTP 网站切换为 HTTPS(并且,随后...

在线
已经在线的网站

Certbot 通常用于将现有的 HTTP 网站切换为 HTTPS(并且,随后在必要时持续更新网站的 HTTPS 证书)。一些 Certbot 文档假设或建议您拥有一个可以通过 HTTP 在端口 80 上访问的工作网站。这意味着,例如,如果您使用网络浏览器通过 http:// 访问您的域名,您的 Web 服务器会做出响应,并且会显示某种内容(即使它只是默认的欢迎页面而不是您网站的最终版本)。一些使用 Certbot 的方法将此作为先决条件,因此,如果您已经有一个使用 HTTP 设置的网站,您将获得更顺畅的体验。(如果出于策略原因您的网站无法通过这种方式访问,您可能需要使用 DNS 验证才能通过 Certbot 获取证书。)


使用一个开放的
端口 80
Close button

不同的互联网服务通过使用不同的 TCP 端口号来区分。未加密的 HTTP 通常使用 TCP 端口 80,而加密的 HTTPS 通常使用 TCP 端口 443。要使用 certbot --webroot、certbot --apache 或 certbot --nginx,您应该在将要使用 Certbot 的服务器上托管一个已经在线的现有 HTTP 网站。该网站应该可以通过端口 80 访问互联网上的其他部分。要使用 certbot --standalone,您不需要一个现有网站,但是您必须确保到服务器上端口 80 的连接不会被防火墙阻止,包括可能由您的互联网服务提供商或网络托管提供商运行的防火墙。如果您不确定,请咨询您的 ISP 或托管提供商。(使用 DNS 验证不需要 Let's Encrypt 与您的服务器建立任何入站连接,因此,特别是在这种情况下,不需要拥有一个现有的 HTTP 网站或接收端口 80 连接的能力。)

不同的互联网服务通过使用不同的 TCP 端口号来区分。未加密的 HTTP ...

端口 80
端口 80

不同的互联网服务通过使用不同的 TCP 端口号来区分。未加密的 HTTP 通常使用 TCP 端口 80,而加密的 HTTPS 通常使用 TCP 端口 443。要使用 certbot --webroot、certbot --apache 或 certbot --nginx,您应该在将要使用 Certbot 的服务器上托管一个已经在线的现有 HTTP 网站。该网站应该可以通过端口 80 访问互联网上的其他部分。要使用 certbot --standalone,您不需要一个现有网站,但是您必须确保到服务器上端口 80 的连接不会被防火墙阻止,包括可能由您的互联网服务提供商或网络托管提供商运行的防火墙。如果您不确定,请咨询您的 ISP 或托管提供商。(使用 DNS 验证不需要 Let's Encrypt 与您的服务器建立任何入站连接,因此,特别是在这种情况下,不需要拥有一个现有的 HTTP 网站或接收端口 80 连接的能力。)

A server
...该网站托管在
服务器
关闭按钮

服务器是互联网上提供服务的计算机,例如网站或电子邮件服务。大多数网站所有者向托管提供商支付费用,以使用位于数据中心的服务器,并通过互联网进行管理。这可能是物理专用服务器、虚拟专用服务器 (VPS) 或共享服务器。其他服务器提供互联网基础设施的其他部分,例如 DNS 服务器。

服务器是互联网上提供服务的计算机,例如网站或电子邮件服务....

服务器
服务器

服务器是互联网上提供服务的计算机,例如网站或电子邮件服务。大多数网站所有者向托管提供商支付费用,以使用位于数据中心的服务器,并通过互联网进行管理。这可能是物理专用服务器、虚拟专用服务器 (VPS) 或共享服务器。其他服务器提供互联网基础设施的其他部分,例如 DNS 服务器。


您可以通过
ssh
关闭按钮
SSH

SSH(代表“安全外壳”)是一种用于连接到远程服务器并访问该服务器上的命令行的技术,通常用于管理它。服务器管理员可以授予其他人 SSH 访问权限,也可以直接使用 SSH 访问权限来远程管理服务器。SSH 通常用于访问运行类 Unix 操作系统的服务器,但您的计算机不必运行 Unix 才能使用 SSH。您通常从计算机的终端中的命令行使用 SSH,方法是键入类似 ssh username@example.com 的命令,尤其是当您的计算机运行 Linux 或 macOS 时。登录后,您将可以访问服务器的命令行。如果您在计算机上使用 Windows,您也可以使用专用的 SSH 应用程序,例如 PuTTY。大多数 Certbot 用户通过 SSH 从远程服务器上的命令提示符运行 Certbot。

SSH(代表“安全外壳”)是一种用于连接到远程服务器并访问该服务器上的命令行的技术,通常用于管理它。服务器管理员可以授予其他人 SSH 访问权限,也可以直接使用 SSH 访问权限来远程管理服务器。SSH 通常用于访问运行类 Unix 操作系统的服务器,但您的计算机不必运行 Unix 才能使用 SSH。您通常从计算机的终端中的命令行使用 SSH,方法是键入类似 ssh username@example.com 的命令,尤其是当您的计算机运行 Linux 或 macOS 时。登录后,您将可以访问服务器的命令行。如果您在计算机上使用 Windows,您也可以使用专用的 SSH 应用程序,例如 PuTTY。大多数 Certbot 用户通过 SSH 从远程服务器上的命令提示符运行 Certbot。

ssh
SSH

SSH(代表“安全外壳”)是一种用于连接到远程服务器并访问该服务器上的命令行的技术,通常用于管理它。服务器管理员可以授予其他人 SSH 访问权限,也可以直接使用 SSH 访问权限来远程管理服务器。SSH 通常用于访问运行类 Unix 操作系统的服务器,但您的计算机不必运行 Unix 才能使用 SSH。您通常从计算机的终端中的命令行使用 SSH,方法是键入类似 ssh username@example.com 的命令,尤其是当您的计算机运行 Linux 或 macOS 时。登录后,您将可以访问服务器的命令行。如果您在计算机上使用 Windows,您也可以使用专用的 SSH 应用程序,例如 PuTTY。大多数 Certbot 用户通过 SSH 从远程服务器上的命令提示符运行 Certbot。


访问,并具有
sudo
关闭按钮

Sudo 是类 Unix 操作系统上最常用的命令,用于以 root(系统管理员)身份运行特定命令。如果您以 root 以外的用户身份登录到您的服务器,您可能需要在 Certbot 命令之前加上 sudo,以便它们以 root 身份运行(例如,sudo certbot 而不是 certbot),尤其是当您使用 Certbot 与像 Apache 或 Nginx 这样的 Web 服务器集成时。(certbot-auto 脚本会在必要时自动运行 sudo,即使您没有指定它。)

Sudo 是类 Unix 操作系统上最常用的命令,用于以 root(系统管理员)身份运行特定命令。如果您以 root 以外的用户身份登录到您的服务器,您可能需要在 Certbot 命令之前加上 sudo,以便它们以 root 身份运行(例如,sudo certbot 而不是 certbot),尤其是当您使用 Certbot 与像 Apache 或 Nginx 这样的 Web 服务器集成时。(certbot-auto 脚本会在必要时自动运行 sudo,即使您没有指定它。)

sudo
sudo

Sudo 是类 Unix 操作系统上最常用的命令,用于以 root(系统管理员)身份运行特定命令。如果您以 root 以外的用户身份登录到您的服务器,您可能需要在 Certbot 命令之前加上 sudo,以便它们以 root 身份运行(例如,sudo certbot 而不是 certbot),尤其是当您使用 Certbot 与像 Apache 或 Nginx 这样的 Web 服务器集成时。(certbot-auto 脚本会在必要时自动运行 sudo,即使您没有指定它。)


权限(如果您想要
通配符证书
关闭按钮

通配符证书是包含一个或多个以*.开头的名称的证书。浏览器将接受星号 (*) 处的任何标签。例如,*.example.com 的证书对 www.example.commail.example.comhello.example.comgoodbye.example.com 有效。

但是,仅包含 *.example.com 名称的通配符证书将example.com 有效:替换标签不能为空。如果要使证书对 example.com 有效,您还需要在证书上包含 example.com(即没有 *. 部分)。

此外,星号只能被一个标签替换,而不能被多个标签替换。例如,hello.goodbye.example.com 名称将不被仅包含 *.example.com 名称的证书覆盖。但是,它将被 *.goodbye.example.com 覆盖。请注意,通配符名称不能包含多个星号。例如,*.*.example.com 无效。

通配符证书是包含一个或多个以*.开头的名称的证书。浏览器将接受星号 (*) 处的任何标签。例如,*.example.com 的证书对 www.example.commail.example.comhello.example.comgoodbye.example.com 有效。

但是,仅包含 *.example.com 名称的通配符证书将example.com 有效:替换标签不能为空。如果要使证书对 example.com 有效,您还需要在证书上包含 example.com(即没有 *. 部分)。

此外,星号只能被一个标签替换,而不能被多个标签替换。例如,hello.goodbye.example.com 名称将不被仅包含 *.example.com 名称的证书覆盖。但是,它将被 *.goodbye.example.com 覆盖。请注意,通配符名称不能包含多个星号。例如,*.*.example.com 无效。

通配符证书
通配符证书

通配符证书是包含一个或多个以*.开头的名称的证书。浏览器将接受星号 (*) 处的任何标签。例如,*.example.com 的证书对 www.example.commail.example.comhello.example.comgoodbye.example.com 有效。

但是,仅包含 *.example.com 名称的通配符证书将example.com 有效:替换标签不能为空。如果要使证书对 example.com 有效,您还需要在证书上包含 example.com(即没有 *. 部分)。

此外,星号只能被一个标签替换,而不能被多个标签替换。例如,hello.goodbye.example.com 名称将不被仅包含 *.example.com 名称的证书覆盖。但是,它将被 *.goodbye.example.com 覆盖。请注意,通配符名称不能包含多个星号。例如,*.*.example.com 无效。

:
DNS 凭据
关闭按钮

DNS 凭据是您的 DNS 提供商允许您用来更改 DNS 记录内容的密码或其他类型的机密信息(例如 API 密钥)。它们通常由您的域名注册商(或其他 DNS 提供商,如果您的 DNS 提供商与您的注册商不同)颁发。DNS 凭据是一种敏感的机密信息,因为它们可以用来完全接管您的网站。您绝不应该公开共享这些凭据,也不应该与未经授权的人员共享。您可以将这些凭据的副本提供给 Certbot,以便它自动执行 DNS 验证,因为它在您的机器上本地运行。

DNS 凭据是您的 DNS 提供商允许您用来更改 DNS 记录内容的密码或其他类型的机密信息(例如 API 密钥)。它们通常由您的域名注册商(或其他 DNS 提供商,如果您的 DNS 提供商与您的注册商不同)颁发。DNS 凭据是一种敏感的机密信息,因为它们可以用来完全接管您的网站。您绝不应该公开共享这些凭据,也不应该与未经授权的人员共享。您可以将这些凭据的副本提供给 Certbot,以便它自动执行 DNS 验证,因为它在您的机器上本地运行。

DNS 凭据
DNS 凭据

DNS 凭据是您的 DNS 提供商允许您用来更改 DNS 记录内容的密码或其他类型的机密信息(例如 API 密钥)。它们通常由您的域名注册商(或其他 DNS 提供商,如果您的 DNS 提供商与您的注册商不同)颁发。DNS 凭据是一种敏感的机密信息,因为它们可以用来完全接管您的网站。您绝不应该公开共享这些凭据,也不应该与未经授权的人员共享。您可以将这些凭据的副本提供给 Certbot,以便它自动执行 DNS 验证,因为它在您的机器上本地运行。

没有这些要求?

别担心!一些托管提供商会自动执行 HTTPS 过程。 查看托管提供商的完整列表 ,或 了解有关如何设置系统的更多信息

  1. SSH 登录服务器

    以具有 sudo 权限的用户身份 SSH 登录运行 HTTP 网站的服务器。

  2. 安装系统依赖项

    系统依赖项可能包括 Python 3.6+(包括 venv 模块)和用于 Apache 插件的 Augeas。

    如果您在安装 cryptography 时遇到问题,您可能需要安装其他依赖项。有关更多信息,请参见 cryptography 项目的网站

    用于安装系统依赖项的命令可能如下所示,在机器的命令行上运行。

    对于基于 APT 的发行版(例如 Debian、Ubuntu ...)

    1. sudo apt update
    2. sudo apt install python3 python3-venv libaugeas0

    对于基于 RPM 的发行版(例如 Fedora、CentOS ...)

    sudo dnf install python3 augeas-libs

    请注意,旧的发行版使用 yum 而不是 dnf,而基于 RHEL 的发行版使用 python3X 而不是 python3(例如 python36<)。

    这些软件包在其他发行版中可能会有略微不同的名称;使用“augeas on”之类的搜索“可能会有所帮助。”

  3. 删除 certbot-auto 和任何 Certbot 操作系统软件包

    如果您使用像 aptdnfyum 这样的操作系统包管理器安装了任何 Certbot 软件包,您应该在安装 Certbot 快照之前将其删除,以确保在运行命令 certbot 时使用快照而不是操作系统包管理器中的安装。执行此操作的确切命令取决于您的操作系统,但常见示例包括 sudo apt-get remove certbotsudo dnf remove certbotsudo yum remove certbot

  4. 设置 Python 虚拟环境

    在命令行上执行以下说明在机器上设置虚拟环境。

    1. sudo python3 -m venv /opt/certbot/
    2. sudo /opt/certbot/bin/pip install --upgrade pip
  5. 安装 Certbot

    在命令行上运行以下命令在机器上安装 Certbot。

    sudo /opt/certbot/bin/pip install certbot
  6. 准备 Certbot 命令

    在命令行上执行以下说明在机器上确保可以运行 certbot 命令。

    sudo ln -s /opt/certbot/bin/certbot /usr/bin/certbot
  7. 选择您希望如何运行 Certbot

    您是否可以暂时停止您的网站?

    是的,我的 Web 服务器当前未在此机器上运行。

    停止您的 Web 服务器,然后运行此命令获取证书。Certbot 将在您的机器上暂时启动一个 Web 服务器。

    sudo certbot certonly --standalone

    不,我需要让我的 Web 服务器保持运行。

    如果您有一个已经在使用端口 80 的 Web 服务器,并且不想在 Certbot 运行时停止它,请运行此命令并按照终端中的说明操作。

    sudo certbot certonly --webroot
  8. 安装您的证书

    您需要在 Web 服务器的配置文件中安装新证书。

  9. 设置自动续订

    我们建议运行以下行,这将向默认的 crontab 添加一个 cron 作业。

    echo "0 0,12 * * * root /opt/certbot/bin/python -c 'import random; import time; time.sleep(random.random() * 3600)' && sudo certbot renew -q" | sudo tee -a /etc/crontab > /dev/null
  10. 确认 Certbot 是否已成功运行

    要确认您的站点是否已正确设置,请在浏览器中访问 https://yourwebsite.com/,并在 URL 栏中查找锁定图标。

  11. [每月] 升级 certbot

    定期更新 Certbot 以使其保持最新状态非常重要。为此,请在机器的命令行上运行以下命令。

    sudo /opt/certbot/bin/pip install --upgrade certbot

    如果此步骤导致错误,请运行 sudo rm -rf /opt/certbot 并重复所有安装说明。

  1. 检查您的 DNS 提供商是否受支持

    通过查看我们 文档 中的此列表,查看您的 DNS 提供商是否受 Certbot 支持。

    不受支持?

    如果您的 DNS 提供商不受支持,请在此暂停:使用 我们文档中的这些步骤,使用手动插件运行 Certbot。

    支持?

    如果您的 DNS 提供商受支持,请继续执行以下剩余说明。

  2. SSH 登录服务器

    以具有 sudo 权限的用户身份 SSH 登录运行 HTTP 网站的服务器。

  3. 安装系统依赖项

    系统依赖项可能包括 Python 3.6+(包括 venv 模块)和用于 Apache 插件的 Augeas。

    如果您在安装 cryptography 时遇到问题,您可能需要安装其他依赖项。有关更多信息,请参见 cryptography 项目的网站

    用于安装系统依赖项的命令可能如下所示,在机器的命令行上运行。

    对于基于 APT 的发行版(例如 Debian、Ubuntu ...)

    1. sudo apt update
    2. sudo apt install python3 python3-venv libaugeas0

    对于基于 RPM 的发行版(例如 Fedora、CentOS ...)

    sudo dnf install python3 augeas-libs

    请注意,旧的发行版使用 yum 而不是 dnf,而基于 RHEL 的发行版使用 python3X 而不是 python3(例如 python36<)。

    这些软件包在其他发行版中可能会有略微不同的名称;使用“augeas on”之类的搜索“可能会有所帮助。”

  4. 删除 certbot-auto 和任何 Certbot 操作系统软件包

    如果您使用像 aptdnfyum 这样的操作系统包管理器安装了任何 Certbot 软件包,您应该在安装 Certbot 快照之前将其删除,以确保在运行命令 certbot 时使用快照而不是操作系统包管理器中的安装。执行此操作的确切命令取决于您的操作系统,但常见示例包括 sudo apt-get remove certbotsudo dnf remove certbotsudo yum remove certbot

  5. 设置 Python 虚拟环境

    在命令行上执行以下说明在机器上设置虚拟环境。

    1. sudo python3 -m venv /opt/certbot/
    2. sudo /opt/certbot/bin/pip install --upgrade pip
  6. 安装 Certbot

    在命令行上运行以下命令在机器上安装 Certbot。

    sudo /opt/certbot/bin/pip install certbot
  7. 准备 Certbot 命令

    在命令行上执行以下说明在机器上确保可以运行 certbot 命令。

    sudo ln -s /opt/certbot/bin/certbot /usr/bin/certbot
  8. 安装正确的 DNS 插件

    运行以下命令,将 <PLUGIN> 替换为您的 DNS 提供商的名称。

    sudo /opt/certbot/bin/pip install certbot-dns-<PLUGIN>

    例如,如果您的 DNS 提供商是 Cloudflare,您将运行以下命令

    sudo /opt/certbot/bin/pip install certbot-dns-cloudflare
  9. 获取证书

    运行 您 DNS 提供商的说明 中“示例”部分中的一个命令。

  10. 安装您的证书

    您需要在 Web 服务器的配置文件中安装新证书。

  11. 设置自动续订

    我们建议运行以下行,这将向默认的 crontab 添加一个 cron 作业。

    echo "0 0,12 * * * root /opt/certbot/bin/python -c 'import random; import time; time.sleep(random.random() * 3600)' && sudo certbot renew -q" | sudo tee -a /etc/crontab > /dev/null
  12. 确认 Certbot 是否已成功运行

    要确认您的站点是否已正确设置,请在浏览器中访问 https://yourwebsite.com/,并在 URL 栏中查找锁定图标。

  13. [每月] 升级 certbot

    定期更新 Certbot 以使其保持最新状态非常重要。为此,请在机器的命令行上运行以下命令。

    sudo /opt/certbot/bin/pip install --upgrade certbot certbot-dns-<PLUGIN>

    如上所述,将 <PLUGIN> 替换为您的 DNS 提供商的名称。

    如果此步骤导致错误,请运行 sudo rm -rf /opt/certbot 并重复所有安装说明。