Linux服务器部署HTTPS证书时,如何完成证书配置与续期验证?
首次部署 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/TCP | HTTP 校验、HTTP 跳转 | 首次申请和续期建议保持可访问 |
| 443/TCP | HTTPS 网站访问 | 正式提供加密访问 |
| 22/TCP | SSH 管理 | 根据管理来源限制,不属于证书要求 |
云服务器还需要在控制台安全组中放行 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



