跳到主要内容
ssl证书按装

HTTPS 部署与 SSL 证书安装配置实战指南:Nginx 配置、证书链校验与错误排查

HTTPS 部署与 SSL 证书安装配置实战指南:Nginx 配置、证书链校验与错误排查 — HTTPS 部署与 SSL 证书安装配置实战指南:Nginx 配置、证书链校验与错误排查

问题背景与根因:HTTPS 部署失败通常不是证书没装

SSL/TLS 位于 TCP/IP 与应用层之间,SSL 记录协议负责数据封装、压缩与加密,握手协议负责身份认证、加密算法协商和密钥交换,最终提供身份认证、机密性和完整性三类服务。电商、支付金融、依赖搜索引擎流量和重视体验的网站都应启用 HTTPS。实际故障中,证书链不完整、私钥与证书不匹配、域名或 SAN 不覆盖、SNI 未命中、443 端口未放行、旧程序硬编码 http 资源,比证书没上传更常见。公有 CA 签发的 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,装一次管多年不可行,必须自动续期。先执行 openssl version、nginx -v、dig +short example.com 确认环境,再用 ss -lntp | grep ':443' 检查监听,用 curl -I http://example.com 看跳转。排查顺序建议为证书链、私钥匹配、域名覆盖、系统时间、SNI,而不是反复重装 Nginx。证书安装配置服务只负责 SSL 参数与证书部署,不直接提供证书;用户需自备或购买证书。若 HTTPS 页面错乱,优先检查混合内容,而不是证书本身。

部署前准备:域名、证书、私钥与证书链校验

先把域名 A/AAAA 记录解析到目标服务器,云安全组和主机防火墙放行 443/tcp。证书来源可选 Let’s Encrypt 90 天自动续期,或商业 CA 证书,注意公有 CA 最长 398 天。商业证书通常需要 CSR:openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com'。上传后必须校验私钥匹配:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in privkey.pem | openssl md5 输出应一致。再检查证书信息:openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName,确认 SAN 包含 example.com 和 www.example.com。证书链用 openssl verify -CAfile chain.pem cert.pem 验证,Nginx 应使用 fullchain.pem,私钥权限设为 chmod 600 privkey.pem 且属主为 root。Let’s Encrypt 文件通常位于 /etc/letsencrypt/live/example.com/,不要移动 fullchain.pem 和 privkey.pem 的软链接。若使用通配符证书,确认 DNS-01 验证和 *.example.com 只覆盖一级子域。部署前备份旧证书和 Nginx 配置,便于回滚。

完整实操步骤:在 Nginx 上启用 HTTPS 并强制跳转

Ubuntu/Debian 可直接执行:sudo apt update && sudo apt install -y nginx certbot python3-certbot-nginx,然后 sudo certbot --nginx -d example.com -d www.example.com --agree-tos -m admin@example.com --redirect。Certbot 会写入证书路径并添加 80 到 443 跳转。若手动配置,先确认 sudo nginx -t 通过,再 sudo systemctl reload nginx。检查监听:sudo ss -lntp | grep ':443';放行防火墙:sudo ufw allow 443/tcp,云厂商安全组同样放行 443。验证跳转:curl -I http://example.com 应返回 301 且 Location 为 https。自动续期检查:systemctl list-timers | grep certbot、sudo certbot renew --dry-run、sudo certbot certificates。Let’s Encrypt 有效期 90 天,续期后必须 reload Nginx;商业证书到期前重新签发并替换 fullchain.pem 与 privkey.pem。不要只替换 cert.pem 而忘记中间证书。若使用负载均衡或 CDN,证书应同时部署在入口层,并确认回源协议为 HTTPS 或至少受信网络。

配置示例:Nginx 与 Apache 的 TLS 参数和证书链

Nginx 最小可用配置如下,80 端口强制跳转,443 使用 fullchain.pem 与 privkey.pem,启用 TLS 1.2/1.3、会话缓存、HSTS 和 OCSP Stapling。HSTS 必须确认全站 HTTPS 后再开启,否则回退困难。Nginx 1.25.1+ 建议用 listen 443 ssl; http2 on;,旧版本可写 listen 443 ssl http2;。

server {
 listen 80;
 server_name example.com www.example.com;
 return 301 https://$host$request_uri;
}
server {
 listen 443 ssl http2;
 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;
 ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
 ssl_prefer_server_ciphers off;
 ssl_session_cache shared:SSL:10m;
 ssl_session_timeout 1d;
 ssl_stapling on;
 ssl_stapling_verify on;
 ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
 resolver 223.5.5.5 1.1.1.1 valid=300s;
 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
 root /var/www/html;
 index index.html;
}

Apache 2.4.8+ 将 fullchain.pem 写入 SSLCertificateFile,无需再单独指定中间证书;旧版本才使用 SSLCertificateChainFile。示例:SSLEngine on、SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem、SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem、SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1。修改后执行 apachectl configtest 和 systemctl reload apache2。OCSP Stapling 需要服务器能访问 CA 的 OCSP 地址,内网受限时可关闭但保留证书链。

证书类型与部署方式对比表格

选型时先看信任链和域名覆盖,再看有效期与审核成本。公有 CA 证书最长 398 天,Let’s Encrypt 90 天,自签证书不受浏览器信任。EV 证书审核更严,但现代浏览器不保证显示绿色公司名,不应把它当作唯一卖点。

类型/方式 有效期与信任 适用场景 部署要点
DV 证书 商业 DV 最长 398 天;浏览器信任 官网、博客、API 入口 校验域名/SAN,使用 fullchain.pem
OV 证书 最长 398 天;展示组织审核 企业门户、B2B 系统 组织信息变更需重签
EV 证书 最长 398 天;审核最严 金融、品牌站点 不保证绿色地址栏,仍需完整链
Let’s Encrypt 90 天;浏览器信任 自动化站点、测试转生产 certbot renew –dry-run,续期后 reload
自签证书 自定义;默认不受信 内网测试、开发环境 需手动导入根证书,不适合公网
单域名/SAN/通配符 按证书覆盖范围 单站、多域名、同级子域 通配符只覆盖一级;多证书用 SNI

部署方式上,单域名证书只保护一个 FQDN;SAN 多域名证书可把 example.com、www.example.com、api.example.com 放入同一张证书;通配符 *.example.com 不覆盖 a.b.example.com。多张证书共存依赖 SNI,现代浏览器和 curl 均支持,但极旧客户端可能命中默认证书。证书链必须包含中间证书,Nginx 用 fullchain.pem,Apache 2.4.8+ 同样使用 fullchain。更换证书时保留旧文件并记录指纹,便于快速回滚。

常见错误排查:真实报错与修复命令

先看 Nginx 错误日志 tail -n 50 /var/log/nginx/error.log,再用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看链。常见问题如下:

  • nginx: [emerg] PEM_read_bio_X509_AUX(/etc/nginx/ssl/fullchain.pem) failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE):文件不是 PEM 或路径错误。用 openssl x509 -in fullchain.pem -noout -text 验证,重新上传 fullchain.pem。
  • SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不匹配。用 modulus 比对,重新配对 cert 与 key。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书。Nginx 改用 fullchain.pem,Apache 2.4.8+ 用 fullchain 写入 SSLCertificateFile。
  • NET::ERR_CERT_COMMON_NAME_INVALID:域名不在 SAN 中。重新签发包含 example.com 和 www.example.com 的证书,不要只看 CN。
  • Mixed Content: The page at https://example.com/ was loaded over HTTPS, but requested an insecure resource http://example.com/app.js:页面硬编码 http。改程序模板为 https 或相对协议;临时可在 Nginx 加 add_header Content-Security-Policy 'upgrade-insecure-requests' always;,最终仍需程序商修正。
  • nginx: [warn] the listen ... http2 directive is deprecated, use the http2 directive instead:Nginx 新版改用 listen 443 ssl; http2 on;。

若浏览器提示证书过期,检查系统时间:timedatectl;若只有部分客户端失败,检查 SNI 和证书链顺序。不要用关闭证书校验的方式上线。

效果验证与监控:从握手到浏览器全链路检查

部署后先做本机与公网双重验证。命令 curl -I https://example.com 期望返回 HTTP/2 200 或 HTTP/1.1 200;curl -I http://example.com 期望 301 且 Location 为 https。握手检查:openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null,输出末尾应为 Verify return code: 0 (ok);用 openssl s_client -connect example.com:443 -servername example.com -status </dev/null 查看 OCSP Stapling。证书有效期检查:openssl x509 -checkend 2592000 -noout -in fullchain.pem,返回 0 表示 30 天内不会过期。加密套件检查:nmap --script ssl-enum-ciphers -p 443 example.com,确认未启用 TLS 1.0/1.1 和弱套件。浏览器 F12 的 Security 面板应显示证书有效、TLS 1.2/1.3、无混合内容。监控侧建议每天执行 certbot renew --dry-run 并采集证书到期天数;续期后自动 reload Nginx。若使用 CDN,分别验证边缘证书和回源证书,避免只修好源站而边缘仍过期。

常见问题

公有 CA 签发的 TLS 证书最长有效期为 398 天,Let’s Encrypt 免费证书为 90 天。到期前必须续期或重签,不能依赖一次安装长期使用;建议用 certbot renew –dry-run 验证自动续期,并在续期后 reload Nginx 或 Apache。


订单通常不包含证书本身,需要您自行购买或下载证书,并提供 fullchain.pem、privkey.pem 或商业 CA 证书包。安装服务负责校验私钥、配置证书链、启用 HTTPS 跳转和排查 Nginx/Apache 报错,不负责域名注册和程序代码改造。


不一定是证书问题。多数是混合内容:页面仍引用 http:// 的 JS、CSS、图片。用浏览器 F12 Console 搜索 Mixed Content,改模板为 https:// 或相对协议;临时可加 CSP upgrade-insecure-requests,最终需程序商修改硬编码链接。


用 openssl verify -CAfile chain.pem cert.pem 验证,或 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看返回链。Nginx 使用 fullchain.pem,Apache 2.4.8+ 将 fullchain 写入 SSLCertificateFile,确保中间证书顺序正确。


通配符证书 *.example.com 只覆盖一级子域,例如 www.example.com、api.example.com,不覆盖 a.b.example.com。若需要多级子域,需分别签发或使用多张证书配合 SNI。通配符通常用 DNS-01 验证,私钥泄露影响范围大,需严格权限控制。


执行 sudo certbot renew –dry-run 做模拟续期,再查看 systemctl list-timers | grep certbot 确认定时任务。真实续期后必须 reload Nginx 或 Apache;可用 openssl x509 -checkend 2592000 -noout -in fullchain.pem 检查 30 天内是否过期。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。