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

Certbot 指南

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

我的 HTTP 网站运行在

FreeBSD 上的 Nginx

默认
通配符

要使用 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 服务器请求 Web 页面和其他在线资源的内容。它是互联网标准,通常与 TCP 端口 80 配合使用。世界上几乎所有网站都支持 HTTP,但配置了 Certbot 或其他 HTTPS 设置方法的网站可能会自动将用户从 HTTP 版本的网站重定向到 HTTPS 版本。

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

HTTP 网站
HTTP

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


它已
上线
Close button

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

Certbot 通常用于将现有的 HTTP 网站切换到 HTTPS 协议(并在之后,在需要时继续续订网站的 HTTPS 证书)...

上线
已上线的网站

Certbot 通常用于将现有的 HTTP 网站切换到 HTTPS 协议(并在之后,在需要时继续续订网站的 HTTPS 证书)。一些 Certbot 文档假设或建议您拥有一个可以在端口 80 上通过 HTTP 访问的正常工作的网站。这意味着,例如,如果您使用 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 通常使用 TCP 端口 80,而加密的 HTTPS 通常使用 TCP 端口 443...

端口 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,方法是键入类似 ssh username@example.com 的命令,尤其是在你的计算机运行 Linux 或 macOS 的情况下。登录后,你将可以访问服务器的命令行。如果你在计算机上使用 Windows,你还可以使用 PuTTY 等专用 SSH 应用程序。大多数 Certbot 用户通过 SSH 从远程服务器上的命令提示符运行 Certbot。

SSH(代表“安全外壳”)是一种连接到远程服务器并访问……

ssh
SSH

SSH(代表“安全外壳”)是一种连接到远程服务器并在该服务器上访问命令行的技术,通常用于管理它。服务器管理员可以授予其他人 SSH 访问权限,也可以直接使用 SSH 访问权限来远程管理服务器。SSH 通常用于访问运行类 Unix 操作系统的服务器,但你的计算机不必运行 Unix 才能使用 SSH。通常,你可以在终端的计算机命令行中使用 SSH,方法是键入类似 ssh username@example.com 的命令,尤其是在你的计算机运行 Linux 或 macOS 的情况下。登录后,你将可以访问服务器的命令行。如果你在计算机上使用 Windows,你还可以使用 PuTTY 等专用 SSH 应用程序。大多数 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 权限的用户身份登录到运行你的 HTTP 网站的服务器。

  2. 安装 Certbot

    安装 Certbot 软件包...

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

    pkg install security/py-certbot-nginx

    或者,如果你愿意,可以从 ports 安装 Certbot

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

    cd /usr/ports/security/py-certbot-nginx && make install clean
  3. 选择你希望如何运行 Certbot

    获取并安装你的证书...

    运行此命令获取证书,并让 Certbot 自动编辑你的 nginx 配置以提供服务,从而在一步骤中启用 HTTPS 访问。

    sudo certbot --nginx

    或者,只获取证书

    如果你更保守,并且想手动更改你的 nginx 配置,请运行此命令。

    sudo certbot certonly --nginx
  4. 测试自动续订

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

    sudo certbot renew --dry-run

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

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

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

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

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

    不支持?

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

    支持?

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

  2. 通过 SSH 登录到服务器

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

  3. 安装 Certbot

    安装 Certbot 软件包...

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

    pkg install security/py-certbot-nginx

    或者,如果你愿意,可以从 ports 安装 Certbot

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

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

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

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

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

    pkg install security/py-certbot-dns-cloudflare
  5. 选择你希望如何运行 Certbot

    获取并安装你的证书...

    您的 DNS 提供商的说明的“示例”部分中,运行其中一个命令,以及标志-i nginx

    或者,只获取证书

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

  6. 测试自动续订

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

    sudo certbot renew --dry-run

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

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

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