Rocky Linux 10 教程 / 签发、续期与监控HTTPS证书并验证Nginx部署

要在 Rocky Linux 10 上运行 HTTPS,您不仅需要签发证书,还需要将其应用到 Web 服务器,执行自动续期,并监控实际提供的证书及其到期情况。本教程使用独立的测试证书颁发机构重现实际的 ACME签发与续期,并区分在应用于公共服务时所需的 DNS、端口和信任条件。

公共证书和本地测试证书之间的区别

HTTPS 使用 TLS(传输层安全协议)保护 HTTP 通信。证书颁发机构(CA)签署证书,将站点名称和公钥绑定,客户端会验证名称、有效期和签发链。ACME(自动证书管理环境)是一种自动化域名控制验证、颁发和续期的协议,Certbot 是执行这些操作的客户端。

如 Let’s Encrypt 挑战文档 中所解释的,公共 HTTP-01 验证会在端口 80 请求认证文件。域名使用的 A·AAAA 记录、外部防火墙和端口转发,以及实际的 Web 服务器路径都必须正确。仅仅更改您自己的 hosts 文件或将 Certbot 的监听端口改为其他数字,并不会改变公共认证机构的连接条件。DNS-01 通过 DNS TXT 记录进行验证,并且需要 DNS 提供商的自动化方法来实现自动续签。

环境 验证范围和信任
这个 Pebble 练习 在虚拟机内部,我们实际上会验证测试名称和 HTTP-01。它是一个私有测试 CA,并不是浏览器普遍信任的证书。
Let's Encrypt 测试环境 用于通过公共 DNS 和访问条件进行测试。测试证书通常不是受信任的证书。
生产认证机构 用于满足实际公共域和策略要求。客户端信任、名称、链和外部访问会单独进行验证。

Let’s Encrypt 测试环境指南 建议在生产签发之前进行测试,并介绍了 Pebble 作为开发用的本地 ACME 服务器。本练习结果不反映使用公共域的测试或生产签发验证的结果。

准备工具和本地 ACME 测试环境

在单独的 Rocky Linux 10 虚拟机上进行操作。原实验环境为 Rocky Linux 10.2、Python 3.12.15、Certbot 5.10.0、Pebble 2.10.3、Nginx 1.26.3、OpenSSL 3.5.8、SELinux 强制模式。下面的 Pebble 分发文件适用于 x86_64。如使用其他 CPU 架构,请选择相应的官方分发及校验码。不要在已有相同名称的网站、证书或练习文件的服务器上按原样运行。

在此环境中,EPEL Certbot 软件包未能安装,因为某些依赖项与 Rocky 10.2 仓库不匹配。在不强制替换系统软件包的情况下,Certbot 已安装在专用的 Python 虚拟环境中。 在 Certbot 安装文档中 可以看到,pip 方法是一种有限支持的方法,它使用虚拟环境。在生产环境中,安装方法和更新责任需共同确定,不会混合不同的 Certbot 安装。

sudo dnf install python3 tar openssl nginx policycoreutils-python-utils
sudo ss -lntp
sudo bash <<'ROOT'
set -euo pipefail
test ! -e /root/lf-course26
test ! -e /usr/local/bin/lf-course26-pebble
for path in /etc/pki/tls/lf-course26 /etc/nginx/conf.d/lf-course26.conf /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer; do
    test ! -e "$path"
done
for port in 14000 15000 5001 5002 18426; do
    listeners=$(ss -H -lnt "sport = :$port")
    test -z "$listeners"
done
if grep -Eq '(^|[[:space:]])course26[.]test([[:space:]]|$)' /etc/hosts; then
    printf 'The test hostname already exists in hosts. Stop.\n' >&2
    exit 1
fi
install -d -m 0700 /root/lf-course26
cp -a /etc/hosts /root/lf-course26/hosts.before
cp -a /etc/nginx /root/lf-course26/nginx.before
python3 -m venv /root/lf-course26/venv
/root/lf-course26/venv/bin/python -m pip install 'certbot==5.10.0'
cd /root/lf-course26
curl -fL -o pebble.tar.gz https://github.com/letsencrypt/pebble/releases/download/v2.10.3/pebble-linux-amd64.tar.gz
printf '7e33cf3e426b67e9e647c44e8cc91683caa8ab331f7a99e5e27fcee291c4c7e2  pebble.tar.gz\n' | sha256sum -c -
tar -xzf pebble.tar.gz --strip-components=3
install -m 0755 pebble /usr/local/bin/lf-course26-pebble
restorecon /usr/local/bin/lf-course26-pebble
openssl req -x509 -newkey rsa:2048 -noenc -keyout api.key -out api.pem -days 2 -subj /CN=localhost -addext 'subjectAltName=DNS:localhost,IP:127.0.0.1'
chmod 0600 api.key
printf '\n127.0.0.1 course26.test # lf-course26\n' >> /etc/hosts
ROOT

在执行之前,请确保端口14000、15000、5001、5002和18426 未被使用,并且 course26.test 不在现有的 hosts 条目中。内部的 sudo bash 以管理员权限运行,如果发生错误,后续命令将会停止。应将发行归档的预期 SHA-256 值与官方发行信息进行比较。如果哈希不同,则不要执行。

将以下内容保存为 sudoedit /root/lf-course26/pebble.json。API 访问证书 api.pem 与为后续站点颁发的证书彼此不同。两个 API 都只在本地回环地址接收连接,并且不会修改全系统的 CA 存储。

{
  "pebble": {
    "listenAddress": "127.0.0.1:14000",
    "managementListenAddress": "127.0.0.1:15000",
    "certificate": "/root/lf-course26/api.pem",
    "privateKey": "/root/lf-course26/api.key",
    "httpPort": 5002,
    "tlsPort": 5001,
    "keyAlgorithm": "ecdsa",
    "profiles": {
      "default": {
        "description": "Local course26 test",
        "validityPeriod": 7776000
      }
    }
  }
}
sudo systemd-run --unit=lf-course26-pebble --property=WorkingDirectory=/root/lf-course26 --setenv=PEBBLE_VA_NOSLEEP=1 --setenv=PEBBLE_AUTHZREUSE=0 /usr/local/bin/lf-course26-pebble -config /root/lf-course26/pebble.json
sudo curl --retry 3 --retry-connrefused --cacert /root/lf-course26/api.pem -fsS https://localhost:14000/dir
sudo curl --cacert /root/lf-course26/api.pem -fsS https://localhost:15000/roots/0 -o /root/lf-course26/issuer-root.pem

第一个查询返回一个包含 ACME 路径的 JSON,第二个查询保存测试签发链的根证书。PEBBLE_VA_NOSLEEP=1 仅移除人为延迟,而 PEBBLE_AUTHZREUSE=0 禁止重复使用之前的授权结果以观察重复验证。不要使用总是将验证视为成功的模式。Pebble 的证书颁发机构状态在执行期间存储在内存中,因此不要假设重启后会保留之前的根、账户或签发状态。如果重启,请再次检查新测试环境的签发及信任关系。有关详细设置,请参考 Pebble 2.10.3 官方自述文件 。

第一次尝试将由 systemd 运行的二进制文件放置在 /root 中失败,原因是在执行阶段权限被拒绝。在将其放置到标准执行路径 /usr/local/bin 并恢复上下文后,它可以正常运行。当 203/EXEC 出现时,请检查 journalctl -u lf-course26-pebble 以及文件路径、权限和 SELinux 上下文,不要通过禁用安全功能来解决。

通过HTTP-01验证签发测试证书

sudo env REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem /root/lf-course26/venv/bin/certbot certonly --standalone --http-01-address 127.0.0.1 --http-01-port 5002 --preferred-challenges http --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --register-unsafely-without-email --agree-tos --non-interactive -d course26.test
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial -dates -issuer -ext subjectAltName
sudo journalctl -u lf-course26-pebble -n 25 --no-pager

此命令仅在本地测试服务器上创建账户,临时独立服务器在 5002 端口提供验证文件。省略电子邮件的选项仅限于此私人测试。REQUESTS_CA_BUNDLE 仅用于该执行的 API TLS 信任,无需跳过 TLS 验证的选项。

在原日志中,记录显示使用 http://course26.test:5002/.well-known/acme-challenge/... 进行了三次验证,身份验证已完成,并已签发证书。此端口 5002 是在 Pebble 中设置的测试端口。这个自定义本地端口并不意味着公共 HTTP-01 证书颁发机构会在任意端口上进行验证。

cert.pem 是网站证书,chain.pem 是中间证书,fullchain.pem 是网站证书和中间链,privkey.pem 是私钥。live 中的文件是指向 archive 中版本文件的符号链接。私钥和账户密钥不应放置在网页文档路径或公共备份中。此设置将测试有效期设为 90 天,但不要假设生产证书具有统一的有效期;请检查实际的 notAfter。

将其应用于 Nginx 并验证名称和链

测试站点仅通过 127.0.0.1:18426 提供。证书被部署到 Nginx 将读取的专用 TLS 路径,而不会直接暴露 Certbot 存储路径。首先,检查新的路径和端口在现有配置中未被使用。

sudo install -d -m 0700 /etc/pki/tls/lf-course26
sudo install -m 0644 /root/lf-course26/config/live/course26/fullchain.pem /etc/pki/tls/lf-course26/fullchain.pem
sudo install -m 0600 /root/lf-course26/config/live/course26/privkey.pem /etc/pki/tls/lf-course26/privkey.pem
sudo restorecon -Rv /etc/pki/tls/lf-course26
sudo semanage port -a -t http_port_t -p tcp 18426

将整个服务器块保存到 sudoedit /etc/nginx/conf.d/lf-course26.conf。在端口 80 上保持默认站点配置。

server {
    listen 127.0.0.1:18426 ssl;
    server_name course26.test;
    ssl_certificate /etc/pki/tls/lf-course26/fullchain.pem;
    ssl_certificate_key /etc/pki/tls/lf-course26/privkey.pem;
    location / {
        default_type text/plain;
        return 200 "LF26 HTTPS works\n";
    }
}
sudo nginx -t && sudo systemctl start nginx
sudo curl --cacert /root/lf-course26/issuer-root.pem --resolve course26.test:18426:127.0.0.1 -sS -w 'HTTP %{http_code}\n' https://course26.test:18426/

如果 Nginx 已经在运行,请使用 sudo systemctl reload nginx 代替 start 来应用新的设置。此练习是在从停止状态启动的情况下进行检查的。LF26 HTTPS works 和 200 是预期的结果。--resolve 仅指定此请求的访问地址,同时保留 URL 名称和 TLS SNI(服务器名称指示)。--cacert 仅指定此实验的测试 CA,不会更改普通浏览器的信任设置。

在实际比较中,如果不指定测试根证书,curl 会因无法信任发行链而以退出代码 60 失败。即使指定了测试根证书,将 URL 名称更改为 wrong26.test 也会由于证书名称不匹配而导致相同的退出代码 60。不要仅通过退出代码来区分原因;还应检查错误消息。验证成功的 TLS 协商以及向客户端呈现的服务器身份。本测试不配置双向 TLS 客户端身份验证。

实际的续订和部署钩子验证

即使 Certbot 保存了新的证书文件,复制到单独路径的 Nginx 证书也不会自动更改。成功续期后执行的部署钩子负责处理复制、上下文恢复、配置检查和重载。将以下内容保存为 sudoedit /usr/local/sbin/lf-course26-deploy。此钩子仅限于本实验的测试名称和存储路径。

#!/bin/bash
set -euo pipefail
test "${RENEWED_LINEAGE:-}" = /root/lf-course26/config/live/course26
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -checkend 0
openssl verify -CAfile /root/lf-course26/issuer-root.pem -untrusted "$RENEWED_LINEAGE/chain.pem" -verify_hostname course26.test "$RENEWED_LINEAGE/cert.pem"
BACKUP=$(mktemp -d /root/lf-course26/deploy-backup.XXXXXXXX)
cp -a /etc/pki/tls/lf-course26/fullchain.pem /etc/pki/tls/lf-course26/privkey.pem "$BACKUP/"
install -m 0644 "$RENEWED_LINEAGE/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
install -m 0600 "$RENEWED_LINEAGE/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
restorecon -R /etc/pki/tls/lf-course26
if ! nginx -t || ! systemctl reload nginx; then
    install -m 0644 "$BACKUP/fullchain.pem" /etc/pki/tls/lf-course26/fullchain.pem
    install -m 0600 "$BACKUP/privkey.pem" /etc/pki/tls/lf-course26/privkey.pem
    nginx -t && systemctl reload nginx
    exit 1
fi
openssl x509 -in "$RENEWED_LINEAGE/cert.pem" -noout -serial >> /root/lf-course26/deploy-serials.log

在应用之前,请检查链、名称和到期日期,并将现有的部署文件存放在受保护的位置。如果配置检查或重载失败,请恢复之前的部署文件并以错误退出。如果恢复也失败,您必须检查服务日志和实际响应,这将不会被视为成功的自动恢复。这次,执行了用于验证的正常证书部署路径,并未刻意重现此故障恢复分支。

将以下内容保存为 sudoedit /usr/local/sbin/lf-course26-renew。使用虚拟环境中的 Python 执行 Certbot 控制台脚本。

#!/bin/bash
set -euo pipefail
export REQUESTS_CA_BUNDLE=/root/lf-course26/api.pem
exec /root/lf-course26/venv/bin/python /root/lf-course26/venv/bin/certbot renew --server https://localhost:14000/dir --config-dir /root/lf-course26/config --work-dir /root/lf-course26/work --logs-dir /root/lf-course26/logs --cert-name course26 --non-interactive --no-random-sleep-on-renew --deploy-hook /usr/local/sbin/lf-course26-deploy "$@"
sudo chmod 0750 /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo restorecon /usr/local/sbin/lf-course26-deploy /usr/local/sbin/lf-course26-renew
sudo /usr/local/sbin/lf-course26-renew --force-renewal
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -serial
sudo bash -o pipefail <<'BASH'
openssl s_client -connect 127.0.0.1:18426 -servername course26.test -verify_hostname course26.test -CAfile /root/lf-course26/issuer-root.pem -verify_return_error </dev/null | openssl x509 -noout -serial
BASH

--force-renewal 是在本地测试中观察续订的一个选项。强制续订不适用于生产计时器。初始序列号是 4DFCA979CEB14834,而实际续订后保存并提供的编号是 4E9CBB509103CA00。在重载命令后的第一次连接中,之前的证书短暂出现,在重新连接后,确认了保存编号与提供编号的一致性。不要仅通过检查命令的完成来判断服务应用已完成。

sudo bash <<'ROOT'
set -euo pipefail
sha256sum /root/lf-course26/config/live/course26/cert.pem > /root/lf-course26/dryrun-before.sha256
/usr/local/sbin/lf-course26-renew --dry-run --run-deploy-hooks
sha256sum -c /root/lf-course26/dryrun-before.sha256
ROOT

实际的模拟续订已成功执行 HTTP-01 和钩子,并且当前证书哈希保持不变。--run-deploy-hooks 中为演练运行指定的钩子使用的是当前活动的证书,而不是临时测试证书。操作和选项也可以在 Certbot 用户指南 中确认。成功的演练运行并不意味着当前文件已被新证书替换。

请单独验证计时器执行和到期监控。

将以下服务保存在 sudoedit /etc/systemd/system/lf-course26-renew.service 中。

[Unit]
Description=Local course26 certificate renewal test
[Service]
Type=oneshot
ExecStart=/usr/local/sbin/lf-course26-renew

将以下计时器保存到 sudoedit /etc/systemd/system/lf-course26-renew.timer 中。OnActiveSec=3s 是用于观察实际中立即调度执行的行。在实际运行周期中,除了这条测试行之外,应根据服务负载和管理策略设置执行时间和分布延迟。

[Unit]
Description=Local course26 renewal timer test
[Timer]
OnActiveSec=3s
OnCalendar=*-*-* 03,15:00:00
Persistent=true
Unit=lf-course26-renew.service
[Install]
WantedBy=timers.target
sudo systemctl daemon-reload
sudo systemctl start lf-course26-renew.timer
systemctl list-timers lf-course26-renew.timer --no-pager
systemctl show lf-course26-renew.service -p Result -p ExecMainStatus -p ActiveState
sudo journalctl -u lf-course26-renew.service -n 25 --no-pager

原实验计时器调用发生在3秒后,最终状态为 Result=success、ExecMainStatus=0 和 ActiveState=inactive。证书尚未进入需要续期的时间窗口,因此日志记录了跳过重新签发和部署钩子。因此,“计时器已运行”、“检查是否需要续期”和“已签发/分发新证书”是不同的确认项。对于一次性服务在正常完成后处于不活动状态,这是正常的。“启动”是指此次启动执行,若需开机后自动调度,还需单独配置启用并验证。

sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -enddate
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 604800
sudo openssl x509 -in /root/lf-course26/config/live/course26/cert.pem -noout -checkend 8640000

此测试证书在7天内不会过期,在604,800秒检查中结果为退出码0,并且在100天内会过期,在8,640,000秒检查中结果为1。后者并不意味着“已过期”。-checkend 检查在指定秒数内是否过期。 请查阅OpenSSL x509文档中选项的含义 。操作监控不仅检查本地文件,还检查实际提供的外部证书,如出现故障,应测试通知路径,以便管理员可以收到通知。

应用于公开服务时必须调整的条件

在实际的域上,不使用私有测试 CA、主机条目、端口 5002 验证和回环 API。首先,检查公共 DNS 和外部端口 80 连接,如果你想维护现有的 Web 服务器,可以使用 webroot 方法提供认证文件。为操作准备单独的 Certbot 路径和配置目录,不要将测试账户或测试证书与运行中的证书混用。

  1. 验证你的域的 A 和 AAAA 记录是否指向实际服务器,并且可以从外部访问。同时,检查未使用的 IPv6 记录是否没有指向错误的服务器。
  2. 在 Nginx 中,从外部验证 /.well-known/acme-challenge/ 测试文件是否在正确的文档路径下提供服务。隐藏路径阻塞、身份验证要求或不正确的重定向都可能干扰验证。
  3. 首先,从正在运行的 Certbot 对 certonly --webroot -w /srv/example-webroot -d www.example.com --dry-run 执行公共暂存验证。将示例的 webroot 和域名替换为实际值,输入可访问的账号邮箱并查看 CA 条款。
  4. 在测试成功后,执行正式颁发,并将完整链和私钥路径应用到 Nginx。操作续期钩子必须根据实际路径、名称和信任链编写,本教程中的私有 CA 钩子不应直接重复使用。
  5. 检查端口443上的外部响应、名称、链、过期、续期演练和部署钩子,以及计时器的下次执行和最近结果。同时,遵循公共CA要求的颁发和续订策略及限制。

本节用于切换到公共服务的条件。本次本地验证不能被视为确认您实际拥有的域名的DNS、互联网防火墙或由公共证书颁发机构颁发。

停止测试环境并恢复现有设置

测试完成后,先停止计时器和Pebble。将您创建的Nginx文件移动到备份位置,检查并重新加载后,只保留现有默认站点。

sudo systemctl stop lf-course26-renew.timer lf-course26-renew.service lf-course26-pebble.service
sudo mv /etc/nginx/conf.d/lf-course26.conf /root/lf-course26/lf-course26.conf.saved
sudo nginx -t && sudo systemctl reload nginx
sudo semanage port -d -p tcp 18426
sudo rm -- /etc/systemd/system/lf-course26-renew.service /etc/systemd/system/lf-course26-renew.timer
sudo systemctl daemon-reload

在 hosts 文件中,仅删除此次添加的精确行。如果没有其他修改,可以通过与受保护的原始文件比较来恢复。此外,在检查所有权后,删除未使用的测试可执行文件、专用部署证书和定时器状态文件,并保留其他站点使用的文件或规则。如果存储了密钥和账户信息,请像以前一样用仅根用户权限保护它们。

在原实验的清理之后,Nginx、防火墙设置、hosts 文件和 SELinux 本地策略与演习前相同,现有默认站点的内容也保持不变。SSH 和 firewalld 仍然处于活动状态,SELinux保持Enforcing(强制模式)。测试 API、HTTPS 监听器和计划任务已被移除,仅保留了具有 0700 权限的专用日志文件夹。