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

Certbot 指南

您的 HTTP 网站运行在哪?

我的 HTTP 网站运行在

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

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

HTTP 网站
HTTP

HTTP(超文本传输协议)是传统但非安全的网页浏览器向 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(Secure Shell 的缩写)是一种连接到远程服务器并访问该服务器上命令行的技术,通常用于管理服务器。服务器管理员可以授予其他人 SSH 访问权限,也可以直接使用 SSH 访问权限来远程管理服务器。SSH 通常用于访问运行类 Unix 操作系统的服务器,但你的计算机不必运行 Unix 才能使用 SSH。通常,你通过在终端中键入命令(例如 ssh username@example.com)从计算机的命令行使用 SSH,尤其是在你的计算机运行 Linux 或 macOS 时。登录后,你将可以访问服务器的命令行。如果你在计算机上使用 Windows,你也可以使用专用的 SSH 应用程序(例如 PuTTY)。大多数 Certbot 用户通过 SSH 在远程服务器上的命令提示符中运行 Certbot。

SSH(Secure Shell 的缩写)是一种连接到远程服务器并访问... 的技术。

ssh
SSH

SSH(Secure Shell 的缩写)是一种连接到远程服务器并访问该服务器上命令行的技术,通常用于管理服务器。服务器管理员可以授予其他人 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 凭据是指你的 DNS 提供商允许你用来更改 DNS 记录内容的密码或其他类型的秘密(例如 API 密钥)。它们通常由你的域名注册商(或其他 DNS 提供商,如果你的 DNS 提供商与你的注册商不同)颁发。DNS 凭据是一种敏感类型的秘密,因为它们可以用来完全接管你的网站。你永远不应该公开或与未经授权的人员分享这些凭据。将它们的副本提供给 Certbot 以便让它自动执行 DNS 验证是可以的,因为它在你的计算机上本地运行。

DNS 凭据是指你的 DNS 提供商允许你用来更改 DNS 记录内容的密码或... 的秘密。

DNS 凭据
DNS 凭据

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

没有这些要求?

不用担心!一些托管提供商会自动执行 HTTPS 过程。 查看托管提供商的完整列表 ,或 详细了解如何设置你的系统

    Windows 安装步骤

    自 2024 年 2 月起,Certbot 已停止对 Windows 的支持。你可以在我们的社区公告 此处 找到替代方案。

  1. 重要提示

    此步骤遵循当前 Certbot 在 Windows 上的实现,特别是它作为系统组件安装的事实,并且需要管理员权限。当 Certbot 的未来版本 切换到不同的安装方法 时,这些说明将更新。目前不支持 HTTP 服务器的安装程序(Certbot for Windows 目前可以从 Let's Encrypt 获取你的证书,但不能将其安装到你的 Web 服务器应用程序中)。

  2. 特定的 Windows 系统要求和用户知识要求
    • 用户需要熟悉命令行界面 (CLI),因为 Certbot 是一个纯 CLI 程序。
    • 用户必须使用具有管理员权限的帐户来安装和运行 Certbot。
    • 支持 PowerShell 和 CMD.EXE;在调用 Certbot 之前,两者都需要以提升的权限启动。
    • 当前用户必须能够写入路径 C:\Certbot
  3. 安装说明
    1. 连接到服务器。
    2. 使用具有此机器管理员权限的帐户,本地或远程(使用远程桌面)连接到服务器。
    3. 安装 Certbot。
    4. https://github.com/certbot/certbot/releases/latest/download/certbot-beta-installer-win_amd64_signed.exe 下载最新版本的 Certbot 安装程序。
    5. 运行安装程序并按照向导操作。安装程序将建议一个默认安装目录,C:\Program Files(x86),可以自定义。
    6. 要启动 Certbot 的 shell,选择“开始”菜单,输入 cmd(运行 CMD.EXE)或 powershell(运行 PowerShell),然后单击显示在上面的上下文菜单中的“以管理员身份运行”。
    7. 以 shell 命令运行 Certbot。

    要在 Certbot 上运行命令,在 shell 中输入名称 certbot,后跟命令及其参数。例如,要显示内联帮助,请运行

    C:\WINDOWS\system32> certbot --help
  4. 选择您希望如何运行 Certbot

    您是否同意暂时停止您的网站?

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

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

    C:\WINDOWS\system32> certbot certonly --standalone

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

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

    C:\WINDOWS\system32> certbot certonly --webroot
  5. 测试自动续订

    系统上的 Certbot 安装附带一个预安装的计划任务,该任务将在证书过期之前自动续订您的证书。您无需再次运行 Certbot,除非您更改了配置。您可以通过运行以下命令来测试证书的自动续订

    C:\WINDOWS\system32> certbot renew --dry-run

    如果您需要停止 Web 服务器来运行 Certbot(例如,如果您在端口 80 通常在使用的机器上使用独立身份验证器),您需要编辑内置命令以添加 --pre-hook--post-hook 标志以自动停止和启动您的 Web 服务器。例如,如果您的 Web 服务器是 Apache 2.4,请将以下内容添加到 certbot renew 命令中

    --pre-hook “net.exe stop Apache2.4” --post-hook “net.exe start Apache2.4”
  6. 确认 Certbot 工作正常

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

  7. 针对 Windows Apache 或 Nginx 用户的说明

    如上文第 5 节所述,Certbot for Windows 目前无法在 Apache 或 Nginx 中为您安装证书。截至最新版本,您需要在 Certbot 获取证书后,自己编辑 Web 服务器应用程序的配置来安装证书。如果您认为此限制是可以接受的,请从本文档的开头开始,详细了解如何在 Windows 上安装和使用 Certbot。

    Windows 安装步骤

    自 2024 年 2 月起,Certbot 已停止对 Windows 的支持。你可以在我们的社区公告 此处 找到替代方案。

  1. 重要提示

    此步骤遵循当前 Certbot 在 Windows 上的实现,特别是它作为系统组件安装的事实,并且需要管理员权限。当 Certbot 的未来版本 切换到不同的安装方法 时,这些说明将更新。目前不支持 HTTP 服务器的安装程序(Certbot for Windows 目前可以从 Let's Encrypt 获取你的证书,但不能将其安装到你的 Web 服务器应用程序中)。

  2. 特定的 Windows 系统要求和用户知识要求
    • 用户需要熟悉命令行界面 (CLI),因为 Certbot 是一个纯 CLI 程序。
    • 用户必须使用具有管理员权限的帐户来安装和运行 Certbot。
    • 支持 PowerShell 和 CMD.EXE;在调用 Certbot 之前,两者都需要以提升的权限启动。
    • 当前用户必须能够写入路径 C:\Certbot
  3. 安装说明
    1. 连接到服务器。
    2. 使用具有此机器管理员权限的帐户,本地或远程(使用远程桌面)连接到服务器。
    3. 安装 Certbot。
    4. https://github.com/certbot/certbot/releases/latest/download/certbot-beta-installer-win_amd64_signed.exe 下载最新版本的 Certbot 安装程序。
    5. 运行安装程序并按照向导操作。安装程序将建议一个默认安装目录,C:\Program Files(x86),可以自定义。
    6. 要启动 Certbot 的 shell,选择“开始”菜单,输入 cmd(运行 CMD.EXE)或 powershell(运行 PowerShell),然后单击显示在上面的上下文菜单中的“以管理员身份运行”。
    7. 以 shell 命令运行 Certbot。

    要在 Certbot 上运行命令,在 shell 中输入名称 certbot,后跟命令及其参数。例如,要显示内联帮助,请运行

    C:\WINDOWS\system32> certbot --help
  4. 测试自动续订

    系统上的 Certbot 安装附带一个预安装的计划任务,该任务将在证书过期之前自动续订您的证书。您无需再次运行 Certbot,除非您更改了配置。您可以通过运行以下命令来测试证书的自动续订

    C:\WINDOWS\system32> certbot renew --dry-run

    如果您需要停止 Web 服务器来运行 Certbot(例如,如果您在端口 80 通常在使用的机器上使用独立身份验证器),您需要编辑内置命令以添加 --pre-hook--post-hook 标志以自动停止和启动您的 Web 服务器。例如,如果您的 Web 服务器是 Apache 2.4,请将以下内容添加到 certbot renew 命令中

    --pre-hook “net.exe stop Apache2.4” --post-hook “net.exe start Apache2.4”
  5. 确认 Certbot 工作正常

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

  6. 针对 Windows Apache 或 Nginx 用户的说明

    如上文第 5 节所述,Certbot for Windows 目前无法在 Apache 或 Nginx 中为您安装证书。截至最新版本,您需要在 Certbot 获取证书后,自己编辑 Web 服务器应用程序的配置来安装证书。如果您认为此限制是可以接受的,请从本文档的开头开始,详细了解如何在 Windows 上安装和使用 Certbot。