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 路径和配置目录,不要将测试账户或测试证书与运行中的证书混用。
- 验证你的域的 A 和 AAAA 记录是否指向实际服务器,并且可以从外部访问。同时,检查未使用的 IPv6 记录是否没有指向错误的服务器。
- 在 Nginx 中,从外部验证
/.well-known/acme-challenge/测试文件是否在正确的文档路径下提供服务。隐藏路径阻塞、身份验证要求或不正确的重定向都可能干扰验证。 - 首先,从正在运行的 Certbot 对
certonly --webroot -w /srv/example-webroot -d www.example.com --dry-run执行公共暂存验证。将示例的 webroot 和域名替换为实际值,输入可访问的账号邮箱并查看 CA 条款。 - 在测试成功后,执行正式颁发,并将完整链和私钥路径应用到 Nginx。操作续期钩子必须根据实际路径、名称和信任链编写,本教程中的私有 CA 钩子不应直接重复使用。
- 检查端口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 权限的专用日志文件夹。




