Linux服务器Nginx HTTPS配置如何检查证书链、监听端口与自动续期

发布人:A5数据发布时间:2026-10-19 11:00阅读量:125

首次部署 Nginx HTTPS,关键是让域名解析到正确的服务器、让 80/443 端口可达,并让 Nginx 使用包含中间证书的证书链文件。以下以 Debian/Ubuntu、Nginx、Certbot 和 Webroot 验证方式为例,演示从安装到检查续期的流程;命令中的 example.com、邮箱和站点目录需替换为实际值。

操作前应具备服务器管理权限,确认域名 A/AAAA 记录指向服务器,并确保域名公网可访问。若启用了 IPv6,AAAA 记录也必须指向能提供该站点的地址,否则部分访问者可能连接到错误主机。以下示例不涉及应用本身的部署。

面向需要稳定承载网站与接口服务的业务,A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器租用资源,覆盖常规建站、数据库、业务后台及多任务运行场景。不同产品可配备SSD或NVMe存储、AMD EPYC及Xeon平台,并结合CN2、国际带宽和多IP方案,为Nginx HTTPS站点的公网访问、证书部署与持续运维提供服务器基础。

准备条件

先确认发行版、Nginx 状态、域名解析结果和端口占用情况:

准备条件配图

cat /etc/os-release
nginx -v
getent ahosts example.com
sudo ss -lntp | grep -E ':(80|443)\b'

如果 Nginx 尚未安装,nginx -v 会提示命令不存在。若 80 或 443 已由其他服务占用,应先确认该服务用途,不要直接结束进程。域名解析结果应包含预期服务器地址;地址不符时先修正 DNS,再申请证书。

还要确认云平台安全组、主机防火墙和上游网络允许 TCP 80、443 入站。HTTP-01 证书验证需要外部验证方访问 80 端口;若环境不允许开放 80,应改用适合该环境的 DNS 验证方式。

安装 Nginx 并准备 HTTP 站点

安装与服务检查

Debian/Ubuntu 可通过系统软件仓库安装 Nginx 和 Certbot:

sudo apt update
sudo apt install -y nginx certbot
sudo systemctl enable --now nginx
sudo systemctl status nginx --no-pager

预期状态为 active (running)。若系统已有统一的软件源或版本管理方式,应按该环境安装,并确认 Nginx 支持当前 TLS 配置。RHEL 系发行版的软件包管理命令及防火墙工具不同,不要直接照搬 apt 或 UFW 命令。

检查本机 HTTP 服务:

sudo ss -lntp | grep ':80'
curl -I http://127.0.0.1/

正常情况下可以看到 Nginx 在 80 端口监听,并收到 HTTP 响应。若本机检查通过但公网无法访问,优先检查云安全组、主机防火墙和 DNS,而不是反复修改 Nginx。

配置 Webroot 验证路径

创建专用于 ACME HTTP 验证的目录:

sudo install -d -o www-data -g www-data -m 755 /var/www/letsencrypt

在 Debian/Ubuntu 上,可新建 Nginx 站点配置,例如 /etc/nginx/sites-available/example.com:

左侧为浏览器或外部验证方发出的HTTP请求路径,中央为无品牌Nginx 80端口server块,标注listen 80、server name example.

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    location ^~ /.well-known/acme-challenge/ {
        root /var/www/letsencrypt;
        default_type "text/plain";
        try_files $uri =404;
    }

    location / {
        return 200 "HTTP site ready\n";
        add_header Content-Type text/plain;
    }
}

这里的 root 会把请求路径追加到目录后。例如,请求 /.well-known/acme-challenge/check 对应文件 /var/www/letsencrypt/.well-known/acme-challenge/check。示例中的普通页面只用于验证配置,实际站点可以替换为应用的代理或静态文件配置,但应保留验证路径。

启用站点并检查配置:

sudo ln -s /etc/nginx/sites-available/example.com /etc/nginx/sites-enabled/example.com
sudo nginx -t
sudo systemctl reload nginx

如果符号链接已存在,不要重复创建;先查看它指向的配置。nginx -t 应显示语法检查成功、测试成功。创建测试文件后,从服务器本机验证验证路径:

sudo install -d -o www-data -g www-data -m 755 /var/www/letsencrypt/.well-known/acme-challenge
printf 'acme-check\n' | sudo tee /var/www/letsencrypt/.well-known/acme-challenge/check
curl http://example.com/.well-known/acme-challenge/check

响应正文应为 acme-check。若返回 404,检查文件路径、站点是否匹配 server_name,以及请求是否落入预期的 Nginx 配置。

申请证书并配置 HTTPS

通过 Webroot 申请证书

HTTP 验证路径可从公网访问后,执行:

sudo certbot certonly --webroot \
  -w /var/www/letsencrypt \
  -d example.com \
  -d www.example.com \
  --email admin@example.com \
  --agree-tos \
  --no-eff-email

证书申请成功后,Certbot 通常会在 /etc/letsencrypt/live/example.com/ 提供指向证书文件的路径。配置时使用 fullchain.pem 作为证书链文件,使用 privkey.pem 作为私钥文件。fullchain.pem 通常包含站点证书和所需中间证书;客户端会依赖它们构建信任链。不要把 cert.pem 单独当作完整证书链使用,也不要把根证书随意拼接进发送链。

若申请失败,先看 Certbot 输出中的域名和验证路径,再核对公网 DNS、80 端口和站点路由。证书文件不应通过邮件、工单或公开仓库传递;私钥应仅由受信任的管理员和 Nginx 读取。

配置 443 监听和 HTTP 跳转

编辑站点配置,保留 80 端口的 ACME 验证路径,并增加 HTTPS 服务块:

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    location ^~ /.well-known/acme-challenge/ {
        root /var/www/letsencrypt;
        default_type "text/plain";
        try_files $uri =404;
    }

    location / {
        return 301 https://$host$request_uri;
    }
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name example.com www.example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    location / {
        return 200 "HTTPS site ready\n";
        add_header Content-Type text/plain;
    }
}

实际业务站点应将 location / 中的示例响应替换为正确的静态站点或应用配置。证书路径中的目录名通常与申请证书时的主证书域名有关;如果 Certbot 输出了不同路径,应以实际生成结果为准。

先测试再重载,避免语法错误导致配置无法生效:

sudo nginx -t
sudo systemctl reload nginx

nginx -t 成功只说明配置可解析,不代表公网端口已经开放或证书链正确。检查 Nginx 是否监听 443:

sudo ss -lntp | grep ':443'

应能看到 Nginx 在 443 端口监听。如果没有监听,查看 nginx -t 输出和服务日志:

sudo journalctl -u nginx -n 50 --no-pager

检查证书链、端口与外部访问

检查服务端发送的证书链

从服务器或另一台可访问该站点的机器执行:

检查证书链、端口与外部访问 / 检查服务端发送的证书链配图

openssl s_client -connect example.com:443 \
  -servername example.com \
  -showcerts </dev/null

重点核对证书主体和 SAN 是否包含访问域名、证书有效期,以及输出末尾的验证结果。常见成功结果为:

Verify return code: 0 (ok)

-servername 用于发送 SNI;同一 IP 上托管多个 HTTPS 域名时,不带正确 SNI 可能拿到其他站点的证书。若返回证书名称不匹配,检查 server_name、访问域名和对应证书。若出现 unable to get local issuer certificate 等链验证错误,应确认 ssl_certificate 指向 fullchain.pem,而不是仅包含站点证书的文件。

也可以检查本地证书信息:

sudo openssl x509 \
  -in /etc/letsencrypt/live/example.com/fullchain.pem \
  -noout -subject -issuer -dates -ext subjectAltName

证书有效期应覆盖当前时间,SAN 列表应包括实际访问的域名。若需确认证书与私钥匹配,可比较两者导出的公钥摘要:

sudo openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -pubkey -noout \
  | openssl pkey -pubin -outform DER \
  | sha256sum

sudo openssl pkey -in /etc/letsencrypt/live/example.com/privkey.pem -pubout -outform DER \
  | sha256sum

两行摘要应一致。若私钥命令提示权限不足,用有权限的管理员身份执行;不要通过放宽私钥权限来规避问题。

检查监听与公网连通性

确认本机监听、Nginx 配置和 HTTP 跳转:

sudo ss -lntp | grep -E ':(80|443)\b'
curl -I http://example.com/
curl -I https://example.com/

HTTP 请求应跳转到 HTTPS,HTTPS 请求应返回站点实际状态码。若本机 ss 显示 443 监听而外网连接超时,检查主机防火墙、云安全组和上游网络。若连接可达但返回其他站点证书,检查 DNS、SNI 和 Nginx 虚拟主机匹配情况。

若使用 UFW,先确认其状态,再按需放行 Web 流量:

sudo ufw status
sudo ufw allow 'Nginx Full'

此规则通常同时放行 TCP 80 和 443。防火墙操作会改变服务器入站范围,只在确认需要且符合管理策略时执行;操作前记录现有规则,回滚时删除本次新增规则:

sudo ufw delete allow 'Nginx Full'

云平台安全组需在控制台单独核对,主机上的放行规则不会自动修改云端规则。

配置并验证自动续期

Certbot 在许多 Debian/Ubuntu 安装方式中会创建 systemd 定时器,但应以本机实际情况为准。先查看定时器和续期任务:

systemctl list-timers --all | grep -i certbot
sudo certbot certificates

如果显示 certbot.timer,可进一步确认其状态:

sudo systemctl status certbot.timer --no-pager

要确保续期成功后 Nginx 重新读取证书,可创建 deploy hook。该脚本只在证书成功续期后执行重载:

sudo install -d -m 755 /etc/letsencrypt/renewal-hooks/deploy
sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload-nginx >/dev/null <<'EOF'
#!/bin/sh
systemctl reload nginx
EOF
sudo chmod 755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx

在支持 Certbot deploy hook 的安装中,先用演练模式检查续期流程:

sudo certbot renew --dry-run

演练成功表示验证流程具备续期条件,但不等于已经更新了正式证书。不同系统的 Certbot 安装渠道可能使用 systemd 定时器或其他调度方式;若没有 certbot.timer,应检查该软件包提供的定时任务,不要重复创建多个自动续期任务。

如果演练失败,按错误类型排查:HTTP 验证失败通常与 DNS、80 端口或验证路径有关;Nginx 重载失败通常与配置语法或权限有关;证书名称错误则需检查申请时的域名列表和实际访问域名。修复后重新执行 certbot renew --dry-run,并再次检查 HTTPS 证书链。

配置并验证自动续期 / 常见失败与处理顺序配图

常见失败与处理顺序

  • 申请证书时连接超时:从外部检查域名是否解析到目标服务器,以及 TCP 80 是否经云安全组和主机防火墙放行。
  • 验证路径返回 404:检查 /var/www/letsencrypt/.well-known/acme-challenge/ 下文件是否存在、Nginx 是否加载了正确站点,以及 root 映射是否一致。
  • Nginx 报证书文件不存在:检查 Certbot 实际生成的证书目录和配置路径;不要创建空证书文件来绕过启动错误。
  • 443 未监听或配置测试失败:查看 nginx -t 的具体文件行号。修正后再测试并重载,不要在测试失败时继续重载。
  • 浏览器提示证书链不完整:确认 ssl_certificate 指向 fullchain.pem,并使用 openssl s_client -showcerts 检查服务器实际发送的证书。
  • 证书正确但公网不可访问:分别核对 Nginx 监听、主机防火墙、云安全组和 DNS。端口已监听不代表外部网络已放行。

回滚与验收检查项

修改现有站点前,先备份配置文件和站点链接,便于恢复:

sudo cp -a /etc/nginx/sites-available/example.com \
  /etc/nginx/sites-available/example.com.bak

若新配置导致 nginx -t 失败,恢复备份后再次测试;若已启用新站点,可先移除新建的符号链接,再恢复原配置并重载。只处理本次新增或修改的站点文件,不要直接清空整个 Nginx 配置目录。证书文件也不要在回滚时随意删除,以免影响其他站点或后续续期。

sudo cp -a /etc/nginx/sites-available/example.com.bak \
  /etc/nginx/sites-available/example.com
sudo nginx -t
sudo systemctl reload nginx

部署验收时逐项确认:

  • DNS 解析指向预期服务器,80 和 443 的外部访问路径已放通。
  • nginx -t 成功,Nginx 服务运行正常,ss 显示预期端口监听。
  • HTTP 请求按配置跳转到 HTTPS,HTTPS 请求返回预期站点内容。
  • 证书 SAN 覆盖访问域名,fullchain.pem 和私钥匹配,链验证结果为 Verify return code: 0 (ok)。
  • Certbot 自动续期任务存在,certbot renew --dry-run 成功,续期后有 Nginx 重载机制。
  • 回滚备份可用;恢复配置后能再次通过 nginx -t 并正常重载。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/4581.html

相关推荐