Linux服务器部署HTTPS证书时,如何完成证书配置与续期验证?

发布人:A5数据发布时间:2026-10-20 10:00阅读量:97

首次部署 HTTPS 时,需要同时打通三条链路:域名解析到当前 Linux 服务器、证书申请机构能够访问 HTTP 校验地址、Web 服务能够加载证书并在续期后重新读取新文件。仅把证书文件上传到服务器,并不能完成 HTTPS 配置,也无法保证后续续期生效。

下面以 Ubuntu 22.04/24.04 或 Debian 12、Nginx、Certbot 和 ACME 证书为例,演示从首次部署到续期验证的完整过程。示例中的 example.com、www.example.com 和 /var/www/html 都需要替换为实际值;如果网站使用的是 Apache,文末给出对应的配置差异。

A5数据提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器,覆盖常规建站、业务后台、数据库与接口服务等场景,并提供SSD、NVMe、不同内存及带宽线路配置。对于需要部署HTTPS、承载多地区访问或持续运行网站服务的业务,可结合访问区域、程序负载和数据规模使用相应服务器资源。

一、部署前确认环境

1. 确认操作系统、Web 服务和域名

先确认系统版本、Nginx 状态以及域名解析结果:

cat /etc/os-release

sudo nginx -v
sudo systemctl is-active nginx

getent ahostsv4 example.com
getent ahostsv4 www.example.com

sudo ss -lntp | grep -E ':(80|443)\s'

预期结果包括:

  • 系统为 Ubuntu 或 Debian;
  • Nginx 已安装并处于 active 状态;
  • 域名解析出的 IPv4 地址与当前服务器公网 IP 一致;
  • 80 端口已经由 Nginx 监听,443 端口可以在后续配置中启用。

如果服务器存在 AAAA 记录,还应检查 IPv6 是否真的指向当前服务器:

getent ahostsv6 example.com

如果域名存在错误的 AAAA 记录,证书机构可能优先访问错误的 IPv6 地址,导致 HTTP 校验失败。此时应先修正 DNS 记录,或者为服务器正确配置 IPv6,而不是只检查 IPv4。

2. 确认安全组和防火墙

证书申请和用户访问通常都需要以下入站端口:

端口用途部署要求
80/TCPHTTP 校验、HTTP 跳转首次申请和续期建议保持可访问
443/TCPHTTPS 网站访问正式提供加密访问
22/TCPSSH 管理根据管理来源限制,不属于证书要求

云服务器还需要在控制台安全组中放行 80 和 443;服务器本地防火墙也不能拦截这两个端口。调整防火墙前,应记录当前规则,避免误操作导致远程连接中断。本文不直接执行防火墙清空或覆盖命令。

3. 安装必要软件并备份配置

Ubuntu 和 Debian 可以使用系统软件包安装 Nginx、Certbot、OpenSSL 和 curl:

sudo apt update
sudo apt install -y nginx certbot openssl curl

修改现有配置前,先备份 Nginx 配置。备份文件可能包含证书路径和私钥文件信息,应限制权限:

STAMP=$(date +%F-%H%M%S)

sudo tar -C /etc -czf "/root/nginx-letsencrypt-${STAMP}.tar.gz" nginx
sudo chmod 600 "/root/nginx-letsencrypt-${STAMP}.tar.gz"

echo "备份文件:/root/nginx-letsencrypt-${STAMP}.tar.gz"

如果服务器刚安装 Nginx,备份的是初始配置;如果已经承载网站,则该备份可用于回滚站点配置。不要把包含私钥的备份文件上传到公共位置。

二、先配置 HTTP 校验路径

1. 确认站点配置文件位置

Ubuntu 和 Debian 的 Nginx 虚拟主机通常位于:

/etc/nginx/sites-available/
/etc/nginx/sites-enabled/

先检查当前加载的配置,确认是否已经存在相同域名:

sudo nginx -T 2>/dev/null | grep -nE 'server_name|listen 80|listen 443'

如果已经有站点配置,应在原配置上修改,不要创建多个内容相同的 server_name,否则请求可能被默认站点接收。

2. 创建 ACME 校验目录

以下示例使用 /var/www/html 作为站点根目录。如果现有网站使用其他目录,应将 -w 参数、Nginx 的 root 配置和测试路径统一起来:

sudo install -d -m 0755 /var/www/html/.well-known/acme-challenge

创建一个测试文件,确认 Nginx 能够直接返回该目录中的内容:

printf 'acme-check\n' | sudo tee /var/www/html/.well-known/acme-challenge/check.txt

3. 配置仅监听 80 端口的临时站点

首次签发证书前,不能在 Nginx 中引用尚不存在的证书文件。先编辑站点配置:

sudo nano /etc/nginx/sites-available/example.com

写入以下内容:

server {
    listen 80;
    listen [::]:80;

    server_name example.com www.example.com;

    root /var/www/html;
    index index.html;

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

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

这里的 location ^~ /.well-known/acme-challenge/ 用于保证证书机构访问校验文件时不会被全站跳转规则拦截。其他普通 HTTP 请求可以跳转到 HTTPS。

如果该站点已经有应用反向代理配置,例如 proxy_pass http://127.0.0.1:8080;,不要用上面的 location / 覆盖原有业务配置,只保留或合并校验目录配置。

启用站点:

sudo ln -s /etc/nginx/sites-available/example.com \
    /etc/nginx/sites-enabled/example.com

如果该软链接已经存在,不需要重复创建。然后检查并重新加载:

sudo nginx -t
sudo systemctl reload nginx
sudo systemctl is-active nginx

预期结果如下:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

使用域名测试校验文件:

curl -i http://example.com/.well-known/acme-challenge/check.txt

预期返回状态为 200 OK,正文包含:

acme-check

如果这里返回 301、404、403 或连接超时,应先处理该问题,再申请证书。

三、申请并检查证书

1. 使用 Webroot 方式申请

确认域名已经解析、生效且 HTTP 校验路径可以访问后,使用 Certbot 申请证书:

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

参数含义如下:

  • certonly:只申请证书,不自动修改 Nginx 配置;
  • --webroot:通过指定网站目录放置 HTTP 校验文件;
  • -w /var/www/html:必须与 Nginx 实际提供校验文件的根目录一致;
  • -d:证书需要覆盖的域名,未解析到当前服务器的域名不要加入;
  • -m:用于接收证书管理通知的邮箱;
  • --agree-tos:接受申请服务条款;
  • --no-eff-email:不订阅额外的推广邮件。

如果只使用主域名,就删除 -d www.example.com。证书中的域名集合应与实际访问入口一致,否则访问未包含在证书 SAN 中的域名时仍会出现名称不匹配。

申请成功后,Certbot 通常会在以下目录中建立证书软链接:

/etc/letsencrypt/live/example.com/fullchain.pem
/etc/letsencrypt/live/example.com/privkey.pem

检查证书信息:

sudo certbot certificates

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

重点确认:

  • subjectAltName 包含实际访问的域名;
  • notBefore 和 notAfter 时间正常;
  • fullchain.pem 和 privkey.pem 文件存在;
  • 私钥没有被复制到网站公开目录。

查看文件指向和权限:

sudo ls -l /etc/letsencrypt/live/example.com/
sudo readlink -f /etc/letsencrypt/live/example.com/fullchain.pem
sudo readlink -f /etc/letsencrypt/live/example.com/privkey.pem

通常不需要把私钥改为 www-data 用户所有。Nginx 主进程会在启动阶段读取私钥,之后再以低权限用户处理请求。随意执行 chmod -R 或 chown -R 可能导致其他证书或续期任务失效。

四、配置 Nginx 加载 HTTPS 证书

1. 增加 443 配置

证书申请成功后,编辑站点配置:

sudo nano /etc/nginx/sites-available/example.com

可以将配置调整为:

server {
    listen 80;
    listen [::]:80;

    server_name example.com www.example.com;

    root /var/www/html;
    index index.html;

    location ^~ /.well-known/acme-challenge/ {
        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;

    root /var/www/html;
    index index.html;

    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;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;

    location / {
        try_files $uri $uri/ =404;
    }
}

如果网站是动态应用,应保留原有的业务处理方式。例如原配置中有以下内容,就不要替换为 try_files:

location / {
    proxy_pass http://127.0.0.1:8080;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

证书配置中应使用 fullchain.pem,而不是只使用 cert.pem。前者包含服务器证书和中间证书链,能够减少部分客户端因链不完整而产生的验证错误。

2. 检查配置并重新加载

执行配置检查:

sudo nginx -t

确认成功后再加载新配置:

sudo systemctl reload nginx
sudo systemctl is-active nginx

reload 通常不会中断已有连接;如果 nginx -t 失败,不要继续执行 reload,应根据报错修正配置。

五、验证 HTTPS 是否真正生效

1. 检查 HTTP 跳转和 HTTPS 状态码

curl -I http://example.com
curl -I https://example.com

正常情况下:

  • HTTP 请求返回 301 或 308;
  • Location 指向 https://example.com/...;
  • HTTPS 请求返回 200、204,或者由应用自身返回的其他正常业务状态;
  • 不应出现证书验证错误、502 或 Nginx 默认站点内容。

如果不希望跟随跳转,可以只查看首个响应;如果需要查看最终结果,可执行:

curl -IL https://example.com

2. 检查客户端实际收到的证书

服务器磁盘上的证书文件正确,并不代表公网 443 端口发送的就是该证书。使用 OpenSSL 检查实际握手结果:

openssl s_client \
  -connect example.com:443 \
  -servername example.com \
  </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

这里的 -servername 很重要。Nginx 可能配置了多个 HTTPS 站点,缺少 SNI 信息时可能返回默认站点的证书。

如果 DNS 还未完全切换,可以使用本机解析测试:

curl --resolve example.com:443:127.0.0.1 \
  -I https://example.com

该命令会让 curl 将指定域名临时解析到本机,同时仍使用域名进行 TLS 校验,适合验证本机 Nginx 的虚拟主机匹配情况。

3. 检查证书剩余时间

查看本地证书文件:

sudo openssl x509 \
  -in /etc/letsencrypt/live/example.com/fullchain.pem \
  -noout \
  -enddate

查看公网实际提供的证书:

echo | openssl s_client \
  -connect example.com:443 \
  -servername example.com 2>/dev/null \
  | openssl x509 -noout -enddate

两者的到期时间应当一致或相近。如果本地文件已更新,但公网证书仍然是旧版本,通常是 Nginx 没有 reload,或者请求实际经过了另一台服务器、负载均衡或 CDN。

六、配置自动续期并进行模拟验证

1. 配置续期后的 Nginx reload

Certbot 续期成功后,证书软链接会指向新的文件,但已经运行的 Nginx 进程不会自动重新读取私钥和证书。因此需要部署钩子,在证书成功更新后检查配置并 reload Nginx。

六、配置自动续期并进行模拟验证配图

创建钩子目录:

sudo install -d -m 0755 /etc/letsencrypt/renewal-hooks/deploy

创建脚本:

sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh > /dev/null <<'EOF'
#!/bin/sh
set -eu

/usr/sbin/nginx -t
/bin/systemctl reload nginx
EOF

设置执行权限:

sudo chmod 0755 /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh

如果执行 command -v nginx 显示的路径不是 /usr/sbin/nginx,应将脚本中的路径替换为实际路径:

command -v nginx
command -v systemctl

2. 检查 Certbot 定时任务

先查看系统是否已经安装 Certbot 定时器:

systemctl list-timers --all | grep -i certbot
sudo systemctl status certbot.timer --no-pager

如果系统存在 certbot.timer,启用它:

sudo systemctl enable --now certbot.timer

不要在已经有定时器的情况下再重复创建 cron 任务,否则可能在同一时间启动多个续期进程。

如果没有 certbot.timer,再检查是否存在系统 cron:

ls -l /etc/cron.d/ | grep -i certbot

确认系统既没有 timer,也没有 Certbot cron 任务时,可以创建一个简单的 cron 任务:

sudo tee /etc/cron.d/certbot-renew > /dev/null <<'EOF'
SHELL=/bin/sh
17 3,15 * * * root /usr/bin/certbot renew
EOF

sudo chmod 0644 /etc/cron.d/certbot-renew

/usr/bin/certbot 如果不存在,应使用以下命令确认实际路径:

command -v certbot

3. 使用 dry-run 验证续期链路

不要直接强制申请正式证书来测试,这可能触发申请频率限制。使用模拟续期:

sudo certbot renew --dry-run

模拟过程会使用测试环境验证域名校验、Webroot 路径和续期配置,不会替换线上正式证书。预期结果应类似:

Congratulations, all simulated renewals succeeded

如果模拟续期成功,还应再次检查部署钩子是否可以执行:

sudo /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh

预期结果是 Nginx 配置检查成功,服务 reload 后仍处于运行状态:

sudo systemctl is-active nginx

七、常见失败情况与处理顺序

1. HTTP 校验返回 404

先在服务器本地检查文件是否存在:

sudo ls -l /var/www/html/.well-known/acme-challenge/check.txt

再从域名访问:

curl -i http://example.com/.well-known/acme-challenge/check.txt

常见原因包括:

  • Certbot 的 -w 路径与 Nginx 的 root 不一致;
  • 请求命中了另一个默认站点;
  • location / 的代理或重写规则覆盖了校验路径;
  • 文件或上级目录没有读取权限;
  • DNS 仍然指向旧服务器。

使用以下命令确认实际生效的配置:

sudo nginx -T | less

重点查看域名对应的 server_name、listen 80、root 和 .well-known 配置。

2. 连接超时或拒绝连接

检查服务监听情况:

sudo ss -lntp | grep -E ':(80|443)\s'
sudo systemctl status nginx --no-pager

如果本机监听正常,但外部无法访问,应检查:

  • 云安全组是否放行 80/443;
  • 本地防火墙是否放行;
  • 域名 A 或 AAAA 记录是否指向当前服务器;
  • 服务器是否处于 NAT 后且没有端口映射;
  • IPv6 是否指向一台没有配置站点的主机。

3. Nginx 配置测试失败

先不要 reload,直接查看详细错误:

sudo nginx -t

常见错误和处理方式:

  • cannot load certificate:证书路径错误,或者证书尚未申请成功;
  • BIO_new_file() failed:私钥路径错误、软链接失效或权限不足;
  • duplicate listen options:多个配置文件重复声明相同监听参数;
  • duplicate server name:同一域名存在多个冲突站点;
  • unknown directive:配置项与当前 Nginx 版本或编译模块不兼容。

确认修改无误后再次执行:

sudo nginx -t && sudo systemctl reload nginx

4. HTTPS 返回错误域名的证书

这通常不是证书文件本身的问题,而是 Nginx 虚拟主机匹配问题。检查:

sudo nginx -T 2>/dev/null | grep -nE 'listen 443|server_name|ssl_certificate'

同时使用带 SNI 的命令验证:

openssl s_client \
  -connect example.com:443 \
  -servername example.com \
  </dev/null 2>/dev/null \
  | openssl x509 -noout -subject -ext subjectAltName

如果仍然返回默认站点证书,应检查 server_name 是否包含当前域名、443 配置是否已启用,以及是否有负载均衡或 CDN 在服务器之前终止了 TLS。

5. 续期模拟成功,但线上仍是旧证书

依次检查:

sudo certbot certificates

sudo readlink -f /etc/letsencrypt/live/example.com/fullchain.pem

sudo systemctl status nginx --no-pager

sudo openssl x509 \
  -in /etc/letsencrypt/live/example.com/fullchain.pem \
  -noout -enddate

如果证书文件已更新但公网没有变化,手动验证 reload:

sudo nginx -t
sudo systemctl reload nginx

然后重新执行公网检查。若仍未变化,应确认域名是否解析到了多台服务器,或者请求是否经过其他 HTTPS 终止设备。

八、Apache 环境的配置差异

如果 Linux 服务器运行的是 Apache,不要直接套用 Nginx 的 server、listen 和 ssl_certificate 配置。证书文件仍可使用相同的 Certbot 目录,但虚拟主机配置需要使用 Apache 语法:

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com

    DocumentRoot /var/www/html

    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem

    <Directory /var/www/html>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Ubuntu/Debian 常见检查命令为:

sudo apache2ctl configtest
sudo systemctl reload apache2
sudo systemctl is-active apache2

RHEL、Rocky Linux 或 AlmaLinux 常见服务名为 httpd:

sudo apachectl configtest
sudo systemctl reload httpd
sudo systemctl is-active httpd

续期部署钩子中的 reload 命令也应改为对应服务,例如:

/bin/systemctl reload apache2

或:

/bin/systemctl reload httpd

同一台服务器上如果 Nginx 和 Apache 同时运行,还要确认 80/443 分别由哪个服务监听,避免只修改了未对外提供服务的配置。

九、回滚方法与最终验收

1. 配置失败时回滚

如果只是修改了站点文件,可以先停用新配置软链接:

sudo rm /etc/nginx/sites-enabled/example.com
sudo nginx -t
sudo systemctl reload nginx

执行删除前应确认该软链接确实只对应本次新增站点,避免误删其他业务配置。

如果需要恢复完整的 Nginx 配置,使用前面创建的备份文件。以下路径需要替换为实际备份文件:

sudo tar -C /etc -xzf /root/nginx-letsencrypt-YYYY-MM-DD-HHMMSS.tar.gz
sudo nginx -t
sudo systemctl reload nginx

回滚的目标是恢复原有可用配置,不需要立即删除 /etc/letsencrypt。如果服务器上还有其他域名,不能直接执行:

sudo rm -rf /etc/letsencrypt

这会破坏其他证书的续期配置。只有在确认没有其他证书依赖该目录,并且已经完成必要备份时,才考虑清理无用的证书目录。

2. HTTPS 部署验收清单

部署完成后,逐项确认:

  • [ ] A 记录和 AAAA 记录指向实际服务器;
  • [ ] 80 和 443 端口在安全组、本地防火墙和服务端均可达;
  • [ ] nginx -t 或 apachectl configtest 检查成功;
  • [ ] HTTP 请求能够按预期跳转到 HTTPS;
  • [ ] HTTPS 请求返回正常业务状态码;
  • [ ] 公网实际返回的证书包含正确域名;
  • [ ] 证书链使用 fullchain.pem;
  • [ ] 私钥未放在网站公开目录,权限未被随意放宽;
  • [ ] certbot renew --dry-run 模拟续期成功;
  • [ ] 续期部署钩子能够在证书更新后 reload Web 服务;
  • [ ] 已确认 Certbot timer 或 cron 中至少有一个自动续期任务;
  • [ ] 已保留配置备份,并记录了回滚文件路径。

3. 回滚验收清单

如果需要恢复部署前状态,应确认:

  • [ ] 原有 HTTP 站点能够正常访问;
  • [ ] Nginx 或 Apache 配置检查成功;
  • [ ] 服务 reload 后仍保持 active;
  • [ ] 未误删除其他域名的证书和续期配置;
  • [ ] 新增的定时任务或部署钩子已按需要保留或移除;
  • [ ] 如果曾修改防火墙,已恢复到变更前记录的规则;
  • [ ] 备份文件仍以受限权限保存,没有暴露私钥内容。

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

相关推荐