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

Certbot 指南

您的 HTTP 网站运行在什么上面?

我的 HTTP 网站运行在

Linux (snap) 上的网站托管产品

默认
通配符

要使用 Certbot,您需要...

A laptop
熟悉
命令行
Close button

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

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

命令行
命令行

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

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

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

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

HTTP 网站
HTTP

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


它已经
在线
Close button

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

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

在线
已经在线的网站

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


并带有打开的
端口 80
Close button

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

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

端口 80
端口 80

不同的 Internet 服务通过使用不同的 TCP 端口号来区分。未加密的 HTTP 通常使用 TCP 端口 80,而加密的 HTTPS 通常使用 TCP 端口 443。要使用 certbot --webroot、certbot --apache 或 certbot --nginx,您应该在您要使用 Certbot 的服务器上托管一个已经在线的现有 HTTP 网站。此网站应该可以通过端口 80 向 Internet 的其他部分提供服务。要使用 certbot --standalone,您不需要现有网站,但您必须确保对服务器上端口 80 的连接没有被防火墙阻止,包括可能由您的 Internet 服务提供商或 Web 托管服务提供商运行的防火墙。如果您不确定,请咨询您的 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(全称“安全外壳”)是一种连接到远程服务器并访问该服务器上的命令行的技术,通常用于管理服务器。服务器管理员可以授予其他人 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(系统管理员)身份运行特定命令....

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 无效。

,你需要
DNS 凭据
关闭按钮

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

DNS 凭据是指你的 DNS 提供商允许你用来更改 DNS 记录内容的密码或其他类型的秘密信息(例如 API 密钥)....

DNS 凭据
DNS 凭据

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

没有这些要求吗?

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

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

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

    不支持?

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

    支持?

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

  2. 通过 SSH 登录服务器

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

  3. 安装 snapd

    你需要安装 snapd,并确保你遵循任何说明来启用经典 snap 支持。

    按照 snapcraft 网站上的这些说明 安装 snapd。

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

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

  5. 安装 Certbot

    在机器上的命令行中运行此命令以安装 Certbot。

    sudo snap install --classic certbot
  6. 准备 Certbot 命令

    在机器上的命令行中执行以下指令,以确保可以运行 certbot 命令。

    sudo ln -s /snap/bin/certbot /usr/bin/certbot
  7. 确认插件包含级别

    在机器上的命令行中运行此命令,以确认已安装的插件将与 Certbot 快照具有相同的 classic 包含级别。

    sudo snap set certbot trust-plugin-with-root=ok

    如果您在运行 Certbot 时遇到问题,您可能需要按照此步骤操作,然后再次执行“安装正确的 DNS 插件”步骤。

  8. 安装正确的 DNS 插件

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

    sudo snap install certbot-dns-<PLUGIN>

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

    sudo snap install certbot-dns-cloudflare
  9. 设置凭据

    您需要设置 DNS 凭据。

    按照 DNS 提供商的“凭据”部分中的步骤访问或创建相应的凭据配置文件。通过点击 文档列表中的 DNS 插件名称,找到您 DNS 提供商的凭据说明。

  10. 获取证书

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

  11. 安装您的证书

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

  12. 测试自动续订

    您系统上的 Certbot 软件包附带一个 cron 作业或 systemd 定时器,它会在证书到期之前自动续订证书。除非您更改配置,否则您无需再次运行 Certbot。您可以通过运行此命令来测试证书的自动续订。

    sudo certbot renew --dry-run

    续订 certbot 的命令安装在以下位置之一

    • /etc/crontab/
    • /etc/cron.*/*
    • systemctl list-timers
  13. 确认 Certbot 工作正常

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