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

Certbot 指南

你的 HTTP 网站运行在什么环境上?

我的 HTTP 网站运行在

OpenBSD 上的 Nginx

默认
通配符

要使用 Certbot,你需要…

A laptop
熟悉
命令行
Close button

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

命令行是通过键入文本命令并接收文本回复来与计算机交互的一种方式。Certbot 通常在类 Unix 服务器...

命令行
命令行

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

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

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

HTTP(超文本传输协议)是传统的但并不安全的网页浏览器向 Web 服务器请求网页和其他在线资源内容的方...

HTTP 网站
HTTP

HTTP(超文本传输协议)是传统的但并不安全的网页浏览器向 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 证书)。一些 Cert...

在线
已在线网站

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,你应该拥有一个现有的 HTTP 网站,该网站已在线托管在你要使用 Certbot 的服务器上。此站点应在端口 80 上对 Internet 的其余部分可用。要使用 certbot --standalone,你不需要现有的站点,但必须确保你的服务器上的端口 80 连接不被防火墙阻止,包括你的 Internet 服务提供商或 Web 主机提供商可能运行的防火墙。如果你不确定,请咨询你的 ISP 或主机提供商。(使用 DNS 验证不需要 Let’s Encrypt 建立到你的服务器的任何入站连接,因此,使用这种特定方法,不需要拥有现有的 HTTP 网站或接收端口 80 连接的能力。)

不同的 Internet 服务通过使用不同的 TCP 端口号来区分。未加密的 HTTP 通常使用 TCP 端口 80,而加密的 H...

端口 80
端口 80

不同的 Internet 服务通过使用不同的 TCP 端口号来区分。未加密的 HTTP 通常使用 TCP 端口 80,而加密的 HTTPS 通常使用 TCP 端口 443。要使用 certbot --webroot、certbot --apache 或 certbot --nginx,你应该拥有一个现有的 HTTP 网站,该网站已在线托管在你要使用 Certbot 的服务器上。此站点应在端口 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. 通过 SSH 进入服务器

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

  2. 安装 Certbot

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

    pkg_add certbot
  3. 安装正确的 DNS 插件

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

    pkg_add -<PLUGIN>

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

    pkg_add -cloudflare
  4. 获取证书

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

  5. 安装你的证书

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

  6. 设置自动续订

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

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

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