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

Certbot 指南

您的 HTTP 网站运行在哪?

我的 HTTP 网站运行在

FreeBSD 上的 HAProxy

默认
通配符

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

HTTP(超文本传输协议)是传统但并不安全的 Web 浏览器请求...

HTTP 网站
HTTP

HTTP(超文本传输协议)是传统但并不安全的 Web 浏览器请求 Web 页面和其他在线资源内容的方式。它是互联网标准,通常与 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(以及之后...

在线
已经在线的网站

Certbot 通常用于将现有的 HTTP 网站切换到 HTTPS(以及之后在需要时继续更新网站的 HTTPS 证书)。一些 Certbot 文档假设或建议您拥有一个可以使用 HTTP 访问端口 80 的工作网站。这意味着,例如,如果您使用 Web 浏览器在 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 的连接没有被防火墙阻止,包括可能由您的互联网服务提供商或 Web 主机提供商运行的防火墙。如果您不确定,请咨询您的 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 的连接没有被防火墙阻止,包括可能由您的互联网服务提供商或 Web 主机提供商运行的防火墙。如果您不确定,请咨询您的 ISP 或主机提供商。(使用 DNS 验证不需要 Let’s Encrypt 对您的服务器进行任何入站连接,因此,特别是使用这种方法,没有必要拥有现有的 HTTP 网站或在端口 80 上接收连接的能力。)

A server
...它托管在
服务器
关闭按钮

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

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

服务器
服务器

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


你可以通过
ssh
关闭按钮
SSH

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

SSH(代表“安全外壳”)是一种连接到远程服务器并在...上访问命令行的技术。

ssh
SSH

SSH(代表“安全外壳”)是一种连接到远程服务器并在该服务器上访问命令行的技术,通常用于管理它。服务器管理员可以授予其他人 SSH 访问权限,也可以直接使用 SSH 访问来远程管理服务器。SSH 通常用于访问运行类 Unix 操作系统的服务器,但您的计算机不需要运行 Unix 才能使用 SSH。您通常通过在终端中输入命令(例如 ssh username@example.com)从计算机的命令行使用 SSH,尤其是在您的计算机运行 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 凭据是密码或其他类型的秘密(例如 API 密钥),您的 DNS 提供商允许您使用它来更改 DNS 记录的内容。它们通常由您的域名注册商(或另一个 DNS 提供商,如果您的 DNS 提供商与您的注册商不同)颁发。DNS 凭据是一种敏感的秘密,因为它们可以用来完全接管您的网站。您永远不应该公开或与未经授权的人员共享这些凭据。将它们复制到 Certbot 允许它自动执行 DNS 验证,因为它们在您的机器上本地运行,是可以的。

DNS 凭据是密码或其他类型的秘密(例如 API 密钥),您的 DNS 提供商允许您使用它来...

DNS 凭据
DNS 凭据

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

没有这些要求?

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

  1. 通过 SSH 连接到服务器

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

  2. 安装 Certbot

    安装 Certbot 包...

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

    pkg install security/py-certbot

    或者,如果您愿意,可以从端口安装 Certbot

    在机器的命令行上运行此命令以从端口安装 Certbot。

    cd /usr/ports/security/py-certbot && make install clean
  3. 选择您希望运行 Certbot 的方式

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

    是的,我的 Web 服务器目前没有在这台机器上运行。

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

    sudo certbot certonly --standalone

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

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

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

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

  5. 测试自动续期

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

    sudo certbot renew --dry-run

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

    • /etc/crontab/
    • /etc/cron.*/*
    • systemctl list-timers
  6. 确认 Certbot 已生效

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

  7. 需要更多 HAProxy 特定的信息?

    使用 HAProxy 安装证书很复杂。您可以在以下指南中找到更多信息

    或者您可能对使用 Greenhost 的实验性 第三方 HAProxy 插件 感兴趣。

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

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

    不支持?

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

    支持?

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

  2. 通过 SSH 连接到服务器

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

  3. 安装 Certbot

    安装 Certbot 包...

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

    pkg install security/py-certbot

    或者,如果您愿意,可以从端口安装 Certbot

    在机器的命令行上运行此命令以从端口安装 Certbot。

    cd /usr/ports/security/py-certbot && make install clean
  4. 安装正确的 DNS 插件

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

    pkg install security/py-certbot-dns-<PLUGIN>

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

    pkg install security/py-certbot-dns-cloudflare
  5. 获取证书

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

  6. 安装您的证书

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

  7. 测试自动续期

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

    sudo certbot renew --dry-run

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

    • /etc/crontab/
    • /etc/cron.*/*
    • systemctl list-timers
  8. 确认 Certbot 已生效

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

  9. 需要更多 HAProxy 特定的信息?

    使用 HAProxy 安装证书很复杂。您可以在以下指南中找到更多信息

    或者您可能对使用 Greenhost 的实验性 第三方 HAProxy 插件 感兴趣。