HTTPS 证书配置实战:从 CSR 申请到 Nginx/Apache 部署与自动续期
为什么“产品说明式”HTTPS配置会失效:问题背景与根因
原文只写“SSL加密、CA证书、全站HTTPS、不限平台”,这不是可执行方案。HTTPS 真正生效依赖四件事:证书域名匹配、私钥匹配、完整证书链、TLS 协议与端口正确。常见根因包括:只部署叶子证书而缺少中间证书,浏览器报 unable to get local issuer certificate;CSR 只写 CN 未写 SAN,导致 ERR_CERT_COMMON_NAME_INVALID;证书过期或服务器时间错误;云安全组未放行 80/443;CDN 回源用 HTTP 又在源站强制跳转,形成 too many redirects;页面仍加载 http:// 图片或脚本,出现混合内容告警。还要纠正过时认知:自 2020-09-01 起,公共 TLS 证书最长有效期 398 天;Let’s Encrypt 证书有效期 90 天,必须自动续期。SSL 是旧称,实际应配置 TLS 1.2/1.3,禁用 TLS 1.0/1.1。若使用负载均衡、CDN 或反向代理,证书应部署在入口,后端可再做回源 TLS;重定向只在一处完成,避免多层跳转。下面按“选型申请→部署→续期→排错→验证”给出可直接执行的流程。
证书选型与申请:从 CSR 到签发
先列出域名清单:根域、www、API 子域、是否要通配符。单域名 DV 最快;多域名用 SAN;泛域名必须 DNS-01。生成私钥与 CSR 时,CN 只作兼容,关键在 SAN:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
用 Let’s Encrypt 可让 Certbot 自动完成 HTTP-01:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --email admin@example.com --agree-tos --no-eff-email
certbot certificates
商业证书则把 CSR 提交给 CA,按提示做 DNS、文件或组织验证。私钥权限设为 600,不能上传代码仓库。签发后常见文件为 cert.pem、chain.pem、fullchain.pem、privkey.pem;Nginx 必须用 fullchain,Apache 2.4.8+ 也可用 fullchain。若 CSR 只写 CN 不写 SAN,现代浏览器会拒绝。Let’s Encrypt 为 90 天,商业 DV 常见 90-397 天,任何公共证书都不超过 398 天。申请前确认 80 或 443 可被 ACME 访问,CDN 场景要关闭强制 HTTPS 或使用 DNS-01。
Nginx与Apache配置示例:强制HTTPS与证书链
Nginx 最小可用配置如下,80 端口只做 301,443 端口加载 fullchain 与私钥:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+,旧版写 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 HIGH:!aNULL:!MD5;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
location / { root /var/www/html; index index.html; }
}
执行 nginx -t 通过后 systemctl reload nginx。Apache 关键行:
<VirtualHost *:80>
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
</VirtualHost>
执行 apachectl configtest 后 reload。HSTS 建议先用 max-age=300 测试,确认全站 HTTPS 后再改一年;有子域未上 HTTPS 时不要加 includeSubDomains。反向代理要传 X-Forwarded-Proto,否则后端判断协议错误会反复跳转。证书链只放 leaf 加 intermediate,不要放 root。
证书类型与部署方式对比表
选型不要只看价格,公共站点必须使用受信任 CA。下表按验证方式、有效期和场景对比:
| 类型 | 验证方式 | 常见有效期 | 适用场景 | 注意 |
|---|---|---|---|---|
| DV | 域名文件/DNS | 90-398 天 | 博客、API、测试 | 最快,不证明企业身份 |
| OV | 企业资料审核 | 1 年 | 企业官网、支付 | 需人工审核 |
| EV | 严格组织审核 | 1 年 | 高信任场景 | 浏览器不再显示绿色公司名 |
| 通配符 | DNS-01 | 90-398 天 | 多子域 | 只覆盖一级,*.example.com 不含 example.com |
| 多域名 SAN | 域名验证 | 90-398 天 | 多业务域 | 注意 SAN 数量与续期 |
| 自签名 | 本地生成 | 自定义 | 内网测试 | 浏览器不信任,不能替代公共 CA |
Let’s Encrypt 90 天适合自动化,商业证书最长 398 天。使用 CDN 时,可把证书上传到 CDN,源站另用一张证书做回源 TLS;不要以为 CDN 开了 HTTPS 源站就安全。内网可用私有 CA,但客户端必须导入根证书,并建立吊销与轮换流程。通配符证书不覆盖根域,根域要单独加入 SAN。多域名证书续期时 SAN 少一个都会导致部分域名告警,变更域名清单要同步更新 ACME 命令和监控。
自动化续期与证书生命周期管理
Let’s Encrypt 只有 90 天,建议到期前 30 天续期。先演练:
certbot renew --dry-run
certbot renew --deploy-hook 'systemctl reload nginx'
cron 可写:
0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'
多数系统自带 certbot.timer,用 systemctl list-timers | grep certbot 检查,避免 cron 与 timer 重复续期。商业证书在到期前 30/14/7 天设提醒,用 openssl x509 -in fullchain.pem -noout -enddate 读取到期时间。续期后必须 reload,否则进程仍加载旧证书;用 openssl x509 -in cert.pem -noout -serial -dates 核对新序列号。OCSP Stapling 可选,Nginx 可配 ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate chain.pem;,但 Let’s Encrypt 已弱化 OCSP,不能作为唯一验证手段。多节点、负载均衡和容器环境要把新证书分发到所有入口,并做健康检查;私钥轮换与证书续期要同步,旧私钥及时下线。
常见错误排查:真实报错与修复命令
排错先看浏览器和 curl 的原始报错,再定位证书、链、协议、端口。典型问题如下:
NET::ERR_CERT_COMMON_NAME_INVALID或curl: (60) SSL: no alternative certificate subject name matches target host name:SAN 缺域名。重新签发并加-d example.com -d www.example.com,不要只改 CN。unable to get local issuer certificate:缺中间证书。Nginx 改用fullchain.pem,Apache 用 fullchain 或SSLCertificateChainFile;用echo | openssl s_client -connect example.com:443 -servername example.com -showcerts检查链。SSL_CTX_use_PrivateKey: key values mismatch:证书与私钥不匹配。分别执行openssl x509 -noout -modulus -in fullchain.pem | openssl md5和openssl rsa -noout -modulus -in privkey.pem | openssl md5,两值必须一致。nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX:文件不是 PEM,可能下载成 HTML 或私钥带密码。用file fullchain.pem和head -1检查。too many redirects:CDN 的 SSL 模式设为 Flexible,回源 HTTP 又跳 HTTPS。改为 Full (strict),并让源站只在一处 301。certbot: Problem binding to port 80或 HTTP-01 返回 404:80 被占用或 webroot 路径错。改用--webroot -w /var/www/html,检查/.well-known/acme-challenge/可访问。SSL_ERROR_RX_RECORD_TOO_LONG:443 端口跑的是 HTTP。检查 Nginx 是否写了listen 443 ssl,以及防火墙是否把 443 转发到错误后端。
修改后先 nginx -t 或 apachectl configtest,再 reload;不要直接重启生产入口。
效果验证:从浏览器到命令行的闭环检查
配置完成后按以下顺序验收:1)跳转:curl -I http://example.com 应返回 301 且 Location 指向 https。2)握手与证书:echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates,确认 CN/SAN、签发者和到期时间;输出中 Verify return code: 0 (ok) 才算链可信。3)协议:openssl s_client -connect example.com:443 -servername example.com -tls1_2 应成功,-tls1_1 应失败;nmap --script ssl-enum-ciphers -p 443 example.com 检查弱套件。4)响应头:curl -sI https://example.com | grep -i strict-transport-security 应看到 HSTS。5)混合内容:打开 DevTools Console,若出现 Mixed Content,把 http:// 资源改为 https:// 或加 CSP upgrade-insecure-requests。6)证书链:openssl s_client -connect example.com:443 -servername example.com -showcerts 应看到 leaf 加 intermediate。最后用 SSL Labs 评分、移动网络和不同地区访问验证,并监控到期时间与握手失败率。
常见问题
自 2020-09-01 起,公共 TLS 证书最长有效期为 398 天;Let’s Encrypt 证书为 90 天。建议在到期前 30 天自动续期,并用 deploy-hook 重载 Web 服务,避免进程继续使用旧证书。
先查证书链是否完整。Nginx 应加载 fullchain.pem,Apache 用 fullchain 或 SSLCertificateChainFile;再执行 echo | openssl s_client -connect example.com:443 -servername example.com -showcerts,Verify return code 为 0 才可信。若为自签名证书,公共浏览器不会信任。
不能。*.example.com 只覆盖 a.example.com 等一级子域,不覆盖 example.com。根域需要单独加入 SAN 或另签一张证书。通配符证书必须用 DNS-01 验证,续期时也要保留同样的 DNS 接口权限。
多数是 Web 服务未重载。执行 nginx -t 后 systemctl reload nginx,或 apachectl configtest 后 reload;再用 openssl x509 -in cert.pem -noout -serial -dates 核对序列号和到期时间。多节点环境还要确认每台入口都分发了新证书。
常见于 CDN 回源仍用 HTTP 或反向代理未传 X-Forwarded-Proto。把 CDN 的 SSL 模式改为 Full (strict),源站只保留一处 301,并让后端识别代理头;检查 Nginx 是否同时存在 80 和 443 的重复跳转规则。