HTTPS/SSL 安装配置实战:CSR、Nginx、证书链与自动续期全流程
问题背景与根因:HTTPS 不是“上传证书”就结束
HTTP 明文传输会让登录态、Cookie、表单数据在链路中被监听、篡改或劫持;启用 TLS 后,浏览器与服务器协商加密套件,通过证书校验身份,才具备防窃听、防篡改和防钓鱼的基础。搜索引擎和浏览器也会把 HTTPS 作为可信度信号,但“装了证书”不等于“配置正确”。
实际故障通常来自四类根因:一是证书链不完整,只部署了 leaf 证书,没有带中间证书;二是私钥与证书不匹配;三是 SAN 未覆盖实际访问域名,例如只签 example.com 却用 www.example.com 访问;四是 80/443、跳转、ACME 验证路径或续期任务配置错误。另一个常见根因是有效期管理:公开信任 TLS 证书最长有效期为 398 天,Let’s Encrypt 证书有效期为 90 天,建议在剩余 30 天前完成续期,不能按“两年一换”的旧经验管理。
openssl x509 -in fullchain.pem -noout -subject -issuer -datesnopenssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
如果 issuer 与 subject 相同,通常是自签证书;如果 SAN 中没有业务域名,后续必然报域名不匹配。DV SSL 只验证域名控制权,OV SSL 还要验证企业真实性,EV SSL 审核更严格;但主流浏览器已弱化绿色地址栏展示,EV 不应只作为 UI 卖点。安装前先确认 DNS A/AAAA 已指向目标服务器、安全组放行 80/443、Web 根目录可写 ACME 挑战文件,否则 certbot 会直接报 unauthorized。
完整实操步骤:申请证书、生成 CSR 与部署前检查
免费证书优先用 Let’s Encrypt,通过 certbot 的 webroot 模式申请,适合已有 Nginx/Apache 的站点。先安装并执行申请命令,注意把 example.com、www.example.com、邮箱和 Web 根目录替换为真实值。命令可直接在服务器执行:
sudo apt update && sudo apt install -y certbotnsudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email admin@example.com --agree-tos --no-eff-email
成功后证书位于 /etc/letsencrypt/live/example.com/,其中 fullchain.pem 是 leaf 证书加中间证书,privkey.pem 是私钥。若购买商业 DV/OV/EV 证书,需要先生成 CSR 和私钥,再提交给 CA。生成命令如下,CN 写主域名,SAN 由 CA 平台补充:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com'
部署前必须做两项硬检查。第一,私钥与证书必须匹配,两个 modulus 的 MD5 应完全一致:
openssl x509 -noout -modulus -in cert.pem | openssl md5nopenssl rsa -noout -modulus -in example.com.key | openssl md5
第二,检查 SAN 是否覆盖所有访问域名,并确认证书未过期:
openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name'nopenssl x509 -in cert.pem -noout -datesncertbot certificates
Let’s Encrypt 证书 90 天有效,部署后立即执行 certbot renew –dry-run 验证续期链路;商业证书最长 398 天,也应在到期前 30 天更新。不要把 cert.pem 单独用于 Nginx,完整链应使用 fullchain.pem,否则 curl、Java、Android 等客户端可能报 unable to get local issuer certificate。
Nginx 配置示例:TLS 1.2/1.3、证书链、HSTS 与跳转
以下配置把 80 端口保留给 ACME 挑战并 301 跳转到 HTTPS,443 端口启用 TLS 1.2/1.3、OCSP Stapling 和 HSTS。Nginx 1.25.1 及以上使用 http2 on;旧版本把 listen 443 ssl 改为 listen 443 ssl http2,并删除 http2 on。证书路径按实际域名替换。
server {n listen 80;n server_name example.com www.example.com;n location /.well-known/acme-challenge/ { root /var/www/html; }n location / { return 301 https://$host$request_uri; }n}nserver {n listen 443 ssl;n http2 on;n server_name example.com www.example.com;n ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;n ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;n ssl_protocols TLSv1.2 TLSv1.3;n ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';n ssl_prefer_server_ciphers off;n ssl_session_cache shared:SSL:10m;n ssl_session_timeout 1d;n ssl_stapling on;n ssl_stapling_verify on;n resolver 8.8.8.8 1.1.1.1 valid=300s;n add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;n root /var/www/html;n index index.html;n}
关键参数说明:ssl_certificate 必须指向 fullchain.pem,不能只指 leaf 证书;ssl_protocols 关闭 TLS 1.0/1.1;ssl_ciphers 只保留 AEAD 套件;ssl_stapling 依赖 resolver 和证书链中的 OCSP 地址,内网无 DNS 时先不要开启。HSTS 首次上线建议先用 max-age=300 观察,确认所有子域都支持 HTTPS 后再加 includeSubDomains 和长 max-age,否则可能把自己锁在 HTTPS 之外。
保存后先测试再重载,避免配置错误导致全站 502 或 443 无法启动:
sudo nginx -tnsudo systemctl reload nginxncurl -sSI http://example.com | grep -i '^location:'ncurl -sSI https://example.com | grep -i 'strict-transport-security'
如果使用 Apache,对应指令是 SSLCertificateFile 指向 fullchain.pem、SSLCertificateKeyFile 指向 privkey.pem,并启用 ssl 模块与 80 跳转。无论 Nginx 还是 Apache,改完必须用 nginx -t 或 apachectl configtest 验证语法。
对比表格:DV/OV/EV 与 Let’s Encrypt、商业证书怎么选
证书类型不是越贵越好,而是按验证强度、合规要求和运维能力选择。公开信任 TLS 证书最长有效期为 398 天;Let’s Encrypt 是 DV 证书,有效期 90 天,依赖自动化续期。下表用于快速对比:
| 类型 | 验证内容 | 信任等级 | 典型签发 | 有效期 | 适用场景 |
|---|---|---|---|---|---|
| DV SSL | 域名控制权 | 普通 | 分钟到小时 | 90 天或最长 398 天 | 个人博客、API、测试环境 |
| OV SSL | 域名加企业实名 | 强 | 1 到 5 个工作日 | 最长 398 天 | 企业官网、政务、SaaS |
| EV SSL | 严格企业审核 | 最高 | 3 到 10 个工作日 | 最长 398 天 | 金融、支付、高信任品牌 |
| Let’s Encrypt | 域名控制权,ACME 自动 | 普通 | 分钟级 | 90 天 | 自动化站点、容器、CDN 回源 |
| 商业 DV | 域名控制权 | 普通 | 分钟到小时 | 最长 398 天 | 需要商业支持与保险 |
选择建议:个人站、内部工具、API 网关优先 Let’s Encrypt 或商业 DV,把精力放在自动续期和监控上;企业官网、需要展示企业实名信息的业务选 OV;金融支付、合规要求高的业务可选 EV,但要接受审核周期。注意,主流浏览器已不再以绿色地址栏作为 EV 的显著标识,EV 的价值更多在 CA 审核和合规材料,而不是 UI 差异。
运维上要区分“证书有效期”和“续期窗口”:Let’s Encrypt 90 天证书建议剩余 30 天前续期,certbot 的 systemd timer 或 cron 每天运行两次即可;商业证书最长 398 天,也应在到期前 30 天更新。可用 certbot certificates 查看所有证书的到期时间,用 openssl x509 -noout -dates 复核实际文件。不要等到浏览器报 NET::ERR_CERT_DATE_INVALID 才处理。
常见错误排查:证书链、域名不匹配、ACME 404 与私钥不匹配
报错一:NET::ERR_CERT_AUTHORITY_INVALID 或 curl: (60) SSL certificate problem: unable to get local issuer certificate。根因是服务器只发送了 leaf 证书,缺少中间证书。解决:Nginx 的 ssl_certificate 改为 fullchain.pem;用 openssl s_client -connect example.com:443 -servername example.com -showcerts 查看返回链,正常应看到 leaf 和中间 CA。不要手工把根证书拼进 fullchain,根证书应由客户端信任库提供。
报错二:NET::ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN。根因是 SAN 不覆盖当前域名,例如证书只有 example.com,却用 www.example.com 或 api.example.com 访问。解决:重新签发时把主域名和所有别名加入 -d 参数,检查命令为 openssl x509 -in fullchain.pem -noout -text | grep -A1 ‘Subject Alternative Name’。通配符证书只覆盖一级子域,*.example.com 不覆盖 a.b.example.com。
报错三:nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed。根因是路径错误、文件不是 PEM 格式、权限不足或文件被截断。解决:ls -l 检查路径,openssl x509 -in fullchain.pem -noout -subject 验证可解析,确认 Nginx 用户可读 privkey.pem。若私钥权限为 600,需保证运行用户或组可读,不能简单 chmod 777。
报错四:SSL_CTX_use_PrivateKey: key values mismatch。根因是证书与私钥不配对,常见于覆盖文件或从不同服务器拷贝。解决:分别计算 modulus 的 MD5,两个值必须一致:
openssl x509 -noout -modulus -in fullchain.pem | openssl md5nopenssl rsa -noout -modulus -in privkey.pem | openssl md5
报错五:urn:ietf:params:acme:error:unauthorized 或 Invalid response … 404。根因是 ACME 挑战文件不可访问,常见于 webroot 路径错误、Nginx 把 /.well-known 跳转到 HTTPS、CDN 回源未放行或防火墙拦截。解决:先创建测试文件,确保 http://example.com/.well-known/acme-challenge/test 返回 200;检查 80 端口 location 未强制跳转,certbot renew –dry-run -v 查看详细路径。若是 DNS 验证,检查 TXT 记录是否生效。
效果验证:openssl、curl、浏览器与 SSL Labs 检查
部署完成后不要只看浏览器锁图标,要同时验证证书链、域名、有效期、协议版本和跳转。第一条命令查看服务端实际返回的证书主题、签发者和有效期:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
第二条检查 HTTP 是否 301 到 HTTPS,以及 HSTS 是否生效:
curl -sSI http://example.com | grep -i '^location:'ncurl -sSI https://example.com | grep -i 'strict-transport-security'ncurl -sSI https://example.com | head -n 1
第三条确认 TLS 1.0/1.1 已关闭、TLS 1.2/1.3 可用。TLS 1.1 握手应失败;如果仍成功,回到 ssl_protocols 配置并重载 Nginx:
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/nullnopenssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/nullnopenssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null
第四条验证自动续期,不要等 90 天后再试:
sudo certbot renew --dry-runnsudo systemctl list-timers | grep certbot
浏览器侧打开开发者工具 Security 面板,确认证书有效、无混合内容;页面中所有 http:// 资源改为 https:// 或协议相对地址。最后用 SSL Labs 或 nmap –script ssl-enum-ciphers -p 443 example.com 做外部评分,目标至少 A,检查是否支持 TLS 1.3、是否启用 HSTS、证书链是否完整。若评分低,优先修证书链和协议版本,再调 cipher。监控上建议对证书剩余天数做告警,阈值 30 天;Let’s Encrypt 90 天证书和商业证书最长 398 天都适用。
常见问题
Let’s Encrypt 证书有效期为 90 天,建议在剩余 30 天前自动续期;公开信任 TLS 证书最长有效期为 398 天,不能按两年一换的旧经验管理。用 certbot renew –dry-run 验证续期。
先查证书链和 SAN:Nginx 应使用 fullchain.pem 而不是 cert.pem;再用 openssl s_client -showcerts 看是否缺中间证书,并确认 SAN 覆盖当前域名。
DV 只验证域名控制权,适合个人站、API 和测试;OV 验证企业实名,适合企业官网;EV 审核最严,适合金融支付等高合规场景。主流浏览器已弱化 EV 绿色地址栏,不要只按 UI 选择。
在 80 端口 server 中加 return 301 https://$host$request_uri,但保留 /.well-known/acme-challenge/ 的 location 给证书续期;执行 nginx -t 后 reload,再用 curl -sSI http://域名 检查 Location 头。
先看 certbot renew –dry-run -v 的报错:unauthorized 或 404 多为 80 端口、webroot 路径、ACME 挑战被跳转或 CDN 拦截;DNS 验证则检查 TXT 记录。确保 http://域名/.well-known/acme-challenge/ 可返回 200。