Debian 13 教程 / 配置Nginx HTTPS并验证证书更新与重新加载

要在 Debian 13 上使用 HTTPS,您不仅需要检查证书的签发,还需要检查名称、信任链、到期时间以及 Web 服务器实际提供的证书。一旦准备好公共域名和外部验证路径,就可以使用 Certbot 配置签发和续期;而在没有这些条件的实验室虚拟机中,您可以使用本地测试证书颁发机构(CA,Certificate Authority) 学习相同的验证流程。本课程中的执行验证使用的是后一种方法,并做出区分,以免与成功的公共证书签发混淆。

将公共签发与本地测试 CA 实验室分开

HTTPS 是一种使用 TLS(Transport Layer Security,传输层安全)保护 HTTP 通信的方法。证书包含诸如服务器公钥和要使用的名称等信息,并由证书颁发机构(CA)签名。客户端会验证是否链到受信任的 CA、连接名称是否与证书匹配,以及证书是否在有效期内。

ACME(Automatic Certificate Management Environment,自动证书管理环境)是一种用于验证域名控制权并自动化证书颁发和续期的协议。Certbot 是使用该协议的客户端。默认情况下,本地创建的 CA 并不被互联网浏览器信任,也不能替代公共站点证书。

方法 要求 本课程的验证范围
Certbot 公共证书签发 可控的真实域名,根据验证方法进行 DNS/外部访问 这是一个检查官方文件和已安装选项的条件操作程序。实际未执行公共证书签发。
本地测试 CA 具有 sudo 访问权限的独立 Debian 虚拟机,安装了 Nginx·OpenSSL·curl 我们直接验证了信任和名称验证、HTTPS 响应、证书重新签发及重新加载。

Let’s Encrypt 挑战类型指南 解释了 HTTP-01 需要通过端口 80 对域名进行外部访问以获取令牌。仅打开 VM 的端口 8443 或更改本地 hosts 文件并不能满足此条件。DNS-01 需要控制公共 DNS TXT 记录;自动续期需要适当的 DNS 插件和仔细设置的 API 权限。

检查已安装的版本和实际续期计时器

作为练习,请使用上一讲中的 VM,其中 Nginx 正常运行,并确保端口 8443 和下方的专用路径为空。在已有公共站点的服务器上,请安全备份配置、证书和密钥,并在继续操作前定义更改范围。

sudo apt update
sudo apt install nginx openssl curl certbot python3-certbot-nginx
openssl version
certbot --version
sudo nginx -t
ss -ltn
systemctl cat certbot.timer certbot.service
systemctl list-timers certbot.timer --no-pager

验证虚拟机使用了 OpenSSL 3.5.7、Certbot 4.0.0 和 Nginx 1.26.3。在 Debian 包中,certbot.timer 每天有两次基准执行时间,并配置随机延迟和 Persistent=true。certbot.service 是执行 renew 后结束的 oneshot 服务。如果安装方法不同,定时器名称和计划也可能不同,因此请检查实际设置。

timer active 表示计划已激活。这并不意味着证书存在或续期/部署成功。该虚拟机上 certbot certificates 的结果为 No certificates found,后续的本地 OpenSSL 证书不会自动注册为 Certbot 管理的目标。

创建本地 CA 并完成 HTTPS 测试站点

仅在代码开头的存在性检查确认所有专用实训路径均不存在时,才运行完整块。将 CA 密钥和服务器密钥放在仅限 root 的路径中,并且只将公共 CA 证书保存在单独的公共路径中供客户端读取。不要将其添加到系统或浏览器信任存储中。私钥生成时不设口令,但目录权限为 700,文件权限为 600;此方法仅用于本地短期练习。

明确使用 sudo bash 以管理员权限运行,并在单个 root shell 中执行内部命令。使 CA 有效期为 3 天,第一个服务器证书有效期为 1 天,包括 SAN(Subject Alternative Name,主题备用名称)中的 lab26.test。此名称仅用于本地测试。

sudo bash <<'ROOT'
set -euo pipefail
for p in /var/lib/lf-tls26 /etc/nginx/lf-tls26 /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26 /usr/local/sbin/lf-tls26-deploy; do
  if test -e "$p" || test -L "$p"; then echo "Existing: $p" >&2; exit 1; fi
done
install -d -m 755 /var/lib/lf-tls26 /var/lib/lf-tls26/public
install -d -m 700 /var/lib/lf-tls26/private /etc/nginx/lf-tls26
umask 077
openssl req -x509 -newkey rsa:2048 -noenc -sha256 -days 3 -subj '/CN=LF Lab 26 Test CA' -addext 'basicConstraints=critical,CA:TRUE' -addext 'keyUsage=critical,keyCertSign,cRLSign' -keyout /var/lib/lf-tls26/private/ca.key -out /var/lib/lf-tls26/public/ca.crt
chmod 644 /var/lib/lf-tls26/public/ca.crt
openssl req -new -newkey rsa:2048 -noenc -subj '/CN=lab26.test' -keyout /etc/nginx/lf-tls26/server.key -out /var/lib/lf-tls26/private/server.csr
cat > /var/lib/lf-tls26/private/leaf.ext <<'EXT'
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
subjectAltName=DNS:lab26.test
EXT
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x26 -days 1 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.crt
cat > /etc/nginx/sites-available/lf-tls26 <<'CONF'
server {
    listen 127.0.0.1:8443 ssl;
    server_name lab26.test;
    ssl_certificate /etc/nginx/lf-tls26/server.crt;
    ssl_certificate_key /etc/nginx/lf-tls26/server.key;
    default_type text/plain;
    return 200 "TLS LAB 26\n";
}
CONF
ln -s /etc/nginx/sites-available/lf-tls26 /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
ROOT

在生成的文件中,ca.key 和 server.key 是私钥,而 ca.crt 和 server.crt 是公钥证书。不要认为仅设置通用名(CN,Common Name) 就足以进行名称验证;还需检查 SAN。服务器证书的扩展指定它不是 CA,并且其用途是用于服务器身份验证。访问私钥的配置和条件也在 Nginx HTTPS 设置文档 中进行了说明。

在检查配置并重新加载后,以普通用户身份在 Debian 虚拟机上发起请求。如果在重新加载后连接立即失败,请稍后再尝试,并检查 ss 和服务日志。--resolve 选项仅将名称映射到地址用于此请求而不更改 DNS,而 --cacert 仅使测试 CA 在此请求中被信任。

curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/

预期响应是 TLS LAB 26。此成功基于在回环、指定 CA 和指定名称条件下的验证,并不反映来自公共 DNS 或普通浏览器信任检查的结果。

区分信任错误和名称不匹配

对于下面的第一个请求,不要指定测试 CA;对于第二个请求,请指定 CA,但连接到证书中未包含的 IP 地址。预计这两个命令都会失败。在一个普通的全新 shell 中运行此比较,不要启用 set -e,并在每个请求后立即读取退出代码;因为启用 errexit 的 shell 可能在 echo 运行前就退出。

curl --noproxy '*' -sS --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/
echo "curl exit: $?"
curl --noproxy '*' -sS --cacert /var/lib/lf-tls26/public/ca.crt https://127.0.0.1:8443/
echo "curl exit: $?"

在验证中,两种情况都返回了 curl 退出代码 60,但第一个是由不受信任的颁发者引起的,第二个是由名称不匹配引起的。不要仅仅根据数字将它们归为一类,也要阅读错误信息。通过使用 -k 关闭验证而成功的结果不能用于证书信任检查。

检查文件本身的链、名称和过期情况如下。服务器证书路径位于仅允许 root 访问的目录内,因此使用了 sudo。

sudo openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.crt
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -serial -dates -ext subjectAltName
sudo openssl x509 -in /etc/nginx/lf-tls26/server.crt -noout -checkend 3600

-checkend 3600 检查它是否将在接下来的 3,600 秒内过期,如果接近过期则返回非零状态。仅此并不能验证链或名称。根据 OpenSSL x509 选项说明 ,区分日期、SAN 和链检查的用途。

将证书文件与 Nginx 提供的证书进行比较

即使您更换了服务器证书,也不能保证正在运行的 Nginx 会提供新的证书。首先,检查新连接中提供的证书的序列号。-servername 通过 TLS 的 SNI(Server Name Indication,服务器名称指示)传递所需的服务器名称。此命令用于观察证书,实际的信任和名称验证由之前的 curl 和 openssl verify 执行。

openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256

在全新的实验环境中运行此替换比较一次。保留第一次的 server-before.crt,而不是在重复尝试时覆盖它。这些证书故意在几天后过期;请使用正确的系统时钟,并在必要时重新生成专用实验环境。

初始序列号为十六进制的26。接下来,使用相同的测试CA和证书签名请求(CSR,Certificate Signing Request),创建一个有效期为2天、序列号为27的新证书,并在验证完成后,替换同一目录中的文件名。此比较是本地重新签发,其中部署步骤单独观察,而不是ACME续订。

sudo bash <<'ROOT'
set -euo pipefail
umask 077
cp -a /etc/nginx/lf-tls26/server.crt /var/lib/lf-tls26/private/server-before.crt
openssl x509 -req -in /var/lib/lf-tls26/private/server.csr -CA /var/lib/lf-tls26/public/ca.crt -CAkey /var/lib/lf-tls26/private/ca.key -set_serial 0x27 -days 2 -sha256 -extfile /var/lib/lf-tls26/private/leaf.ext -out /etc/nginx/lf-tls26/server.next.crt
openssl verify -CAfile /var/lib/lf-tls26/public/ca.crt -verify_hostname lab26.test /etc/nginx/lf-tls26/server.next.crt
mv /etc/nginx/lf-tls26/server.next.crt /etc/nginx/lf-tls26/server.crt
ROOT

在完成上述区块后,文件的序列号为27,但在新连接中收到的证书仍然是26。这表明文件保存成功和部署成功是不同的。在此步骤中已保留已知良好的server-before.crt。

下面的专用部署脚本仅在 Nginx 配置检查成功后才会重新加载 Nginx。在此操作中,在准备阶段确认尚不存在同名文件。它不会用于覆盖生产服务器上已有的脚本。

sudo tee /usr/local/sbin/lf-tls26-deploy > /dev/null <<'HOOK'
#!/bin/sh
set -eu
/usr/sbin/nginx -t
/usr/bin/systemctl reload nginx
HOOK
sudo chmod 700 /usr/local/sbin/lf-tls26-deploy
sudo /usr/local/sbin/lf-tls26-deploy
openssl s_client -connect 127.0.0.1:8443 -servername lab26.test < /dev/null 2>/dev/null | openssl x509 -noout -serial -fingerprint -sha256
curl --noproxy '*' -fsS --cacert /var/lib/lf-tls26/public/ca.crt --resolve lab26.test:8443:127.0.0.1 https://lab26.test:8443/

在验证过程中,重新加载后,新的连接序列号变为27,并且HTTP响应正常。旧 worker 的退出可能需要一些时间;请稍候,再用新的连接检查。如果配置检查失败,则不执行重新加载,并调查文件/密钥的对应关系以及路径/权限。在恢复此操作证书时,将保存的server-before.crt复制到server.crt,并按相同顺序执行验证、重新加载和证书提供检查。

仅在准备好公共域名后使用 Certbot

此步骤仅适用于操作实际域名的情况。与本地站点 127.0.0.1:8443 分开,域名的 IPv4 A 记录及任何已发布的 IPv6 AAAA 记录必须指向正确的服务器,并且端口 80 上的 HTTP-01 访问必须在所有使用的路径上可用。此外,检查是否有错误的 IPv6 地址、代理、CDN、防火墙和 NAT 设置。从其他网络验证域名访问,并调整 Nginx 站点中的 server_name 以匹配实际域名。

Certbot 的dry-run 测试仍会联系 staging 测试服务,并可能暂时调整和重新加载 Web 服务器。请先备份相关网站配置。如果 nginx -t 或staging 测试验证失败,请停止并修正后再尝试正式颁发;以下命令不是出现错误后一次性批量执行的。

下面是一个应用于已准备好 Nginx 站点的条件命令。输入您控制的域名和联系电子邮件,并先在实际服务器上备份设置。--dry-run 尝试staging 测试验证,因此无需在没有外部条件的虚拟机上执行。

read -r -p "Real domain you control: " domain
read -r -p "Certificate contact email: " email
sudo nginx -t
sudo certbot certonly --nginx --dry-run -d "$domain" --email "$email" --agree-tos

临时(测试)证书不被普通客户端信任。按照 Let’s Encrypt 测试环境说明 ,首先解决验证错误,然后再进行正式颁发。即使dry-run 测试成功,正式证书也不会被保存。在正常情况下,以下命令会颁发正式证书并修改 Nginx 配置,因此应先审核更改。

sudo certbot --nginx -d "$domain" --email "$email" --agree-tos --redirect
sudo certbot certificates
sudo nginx -t
curl -I "https://$domain/"

根据 certbot certificates 输出核实证书名称以及 live 目录中的实际路径。Nginx 必须链接包含服务器证书和所需中间证书的 fullchain.pem,以及相应的 privkey.pem。不要仅通过确认文件存在来结束验证;请检查外部 HTTPS 响应,并验证提供的证书的名称、颁发者和到期时间。

使用 sudo certbot renew --dry-run 验证实际管理证书的续期流程。已安装的 4.0.0 版本的帮助提示在默认的 dry-run 中不会执行部署钩子,必须添加 --run-deploy-hooks。如果除了 Nginx 插件处理的重新应用外,您还配置了自己的部署钩子,请检查目标和重复的重载,并且包括钩子的测试应在维护范围内进行。

certbot --help all | less
sudo certbot renew --dry-run
systemctl list-timers certbot.timer --no-pager
sudo journalctl -u certbot.service -n 50 --no-pager

因为没有可续期的内容而结束而没有任何操作的结果,并不能证明续期成功。首先,检查是否实际上有任何证书正在被管理,并在必要的时候分别记录续期结果、部署结果以及新连接的证书。有关插件和钩子的含义,请参阅 Certbot 官方使用指南,但优先检查已安装版本的帮助和实际配置。

仅移除本地 TLS 实验室

已经配置了公共 Certbot 设置的读者不得将此清理部分应用于公共站点。下面的块会先删除先前为 lf-tls26 创建的链接,然后进行检查和重新加载,并且只有在 8443 监听器消失的情况下才会删除专用密钥、证书和文件夹。由于信任存储未被更改,因此也不需要删除系统 CA。

sudo bash <<'ROOT'
set -euo pipefail
rm -- /etc/nginx/sites-enabled/lf-tls26
nginx -t
systemctl reload nginx
sleep 1
if ss -ltnH | grep -q '127.0.0.1:8443'; then echo 'TLS listener remains' >&2; exit 1; fi
rm -- /etc/nginx/sites-available/lf-tls26 /usr/local/sbin/lf-tls26-deploy /etc/nginx/lf-tls26/server.crt /etc/nginx/lf-tls26/server.key
rm -- /var/lib/lf-tls26/private/ca.key /var/lib/lf-tls26/private/server.csr /var/lib/lf-tls26/private/leaf.ext /var/lib/lf-tls26/private/server-before.crt /var/lib/lf-tls26/public/ca.crt
rmdir /etc/nginx/lf-tls26 /var/lib/lf-tls26/private /var/lib/lf-tls26/public /var/lib/lf-tls26
ROOT

在验证虚拟机上,专用 HTTPS 站点、密钥、CA 和部署脚本已被删除,并且保留了原始 Nginx 默认配置哈希。Certbot 包和活动定时器仍然存在,但没有受管理的证书。此状态不被视为公共证书的自动续订操作。