SSL 证书安装与 HTTPS 配置全流程实战:从 CSR 申请到 Nginx/Apache 部署、报错排查与自动续期
一、问题背景与根因:HTTPS 故障到底出在哪一层
网站从 HTTP 迁移到 HTTPS,本质上是做两件事:用 TLS 给传输层加密,用受信任的 CA 证书向客户端证明「我就是 example.com」。浏览器地址栏的小锁只是结果,真正决定成败的是四件事:证书链是否完整、域名是否匹配、有效期是否在窗口内、协议与加密套件是否协商成功。
线上 HTTPS 故障,八成以上可以归到下面几类根因:
- 证书链不完整:只部署了服务器证书,没带中间 CA。桌面 Chrome 有 AIA 补链能力,但 Android 老版本、微信内置浏览器、Java/Python/Go 客户端会直接报错。这是最高频的线上事故。
- 域名不匹配:证书 SAN 里只有 example.com,用户却用 www.example.com 访问。
- 有效期问题:证书已过期,或服务器系统时间偏差过大。注意,自 2020-09-01 起,CA/Browser Forum 规定公开信任的 TLS 证书最长有效期不得超过 398 天,Apple 与 Google 均已强制执行。因此市面上宣传的「2 年期 DV 证书」实际是以 1 年期证书加一年托管续费的形式交付,不存在 2 年有效期的公开信任证书。Let’s Encrypt 免费证书有效期 90 天,且官方推荐提前 30 天续期。
- 私钥与证书不配对,或私钥权限过宽导致 Nginx 启动失败。
- 端口未放行:云安全组、firewalld、ufw 三层中任意一层没开 443。
- 混合内容:页面里仍有 http:// 的图片、脚本、字体,锁标志变灰。
先跑三条命令确认证书现状,再动手改配置:
openssl x509 -in /etc/nginx/ssl/example.com.pem -noout -subject -issuer -dates
openssl x509 -in /etc/nginx/ssl/example.com.pem -noout -text | grep -A1 'Subject Alternative Name'
openssl rsa -noout -modulus -in /etc/nginx/ssl/example.com.key | md5sum
openssl x509 -noout -modulus -in /etc/nginx/ssl/example.com.pem | md5sum
最后两条输出的 md5 必须完全一致,否则说明私钥与证书不匹配——这是「配置写完 Nginx 起不来」最常见的原因。
二、前置检查:域名解析、端口放行与时间同步
在提交证书申请前完成五项检查,能省掉后面九成的「验证失败」。
1)解析必须指向当前服务器。
dig +short example.com A
dig +short www.example.com A
dig +short example.com AAAA
如果服务器没有配置 IPv6,务必删除 AAAA 记录,否则 HTTP-01 验证可能优先走 IPv6 而超时失败。
2)80/443 端口放行。HTTP-01 验证要求公网能访问 /.well-known/acme-challenge/,因此 80 端口在签发阶段必须可达。
# firewalld
firewall-cmd --permanent --add-service=http --add-service=https
firewall-cmd --reload
# ufw
ufw allow 80/tcp && ufw allow 443/tcp
# 本机监听检查
ss -lntp | grep -E ':80|:443'
云厂商还需在控制台安全组入方向放行 TCP 80/443。三层都查,只改一层是最典型的踩坑点。
3)时间同步。TLS 校验依赖系统时间,偏差超过几分钟就会报证书无效:
timedatectl set-ntp true
timedatectl status
chronyc tracking
4)确认是否存在 CDN / WAF / 负载均衡。若域名前置了 CDN,证书要么上传到 CDN 节点,要么在源站配置并开启回源 HTTPS。此时 HTTP-01 验证通常会被 CDN 拦截,应改用 DNS-01(添加 TXT 记录)方式签发。
5)检查 .well-known 是否被伪静态规则吃掉。ThinkPHP、WordPress、Next.js 等站点常把全部请求 rewrite 到入口文件,导致验证路径 404:
curl -I http://example.com/.well-known/acme-challenge/test.txt
若返回 404 或 301 跳到首页,需要在 Nginx 中补一条 location ^~ /.well-known/acme-challenge/ { root /var/www/html; },且该 location 必须写在 rewrite 规则之前。
三、生成 CSR 与申请证书:商业 CA 与 ACME 两条路径
商业 CA 需要 CSR(Certificate Signing Request);Let’s Encrypt 等 ACME 证书由客户端自动生成密钥对并完成验证,无需手工 CSR。两者都建议使用 2048 位 RSA 或 P-256 ECC 密钥。
路径一:手工生成私钥与 CSR(商业证书)
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj '/C=CN/ST=Beijing/L=Beijing/O=Example Co Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 example.com.key
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
关键点:CN 只能填一个域名,多域名必须靠 SAN 扩展。OpenSSL 1.1.1 以下版本不支持 -addext,需要写 openssl.cnf 并用 -config 指定。ECC 私钥的生成方式为:
openssl ecparam -genkey -name prime256v1 -out example.com.key
把 CSR 全文提交给 CA,签发后会拿到服务器证书与中间 CA 证书。部署时应合并为 fullchain,而不是把两张证书分别配到不同指令里:
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt
路径二:ACME 自动签发
# certbot,适用于已有 Web 服务的站点
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
# acme.sh,支持 DNS API 自动验证
curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
通配符证书只能走 DNS-01 验证,因为无法用单条 HTTP 路径证明对全部子域的所有权。签发完成后,certbot 产物在 /etc/letsencrypt/live/example.com/,acme.sh 产物在 ~/.acme.sh/example.com/,直接取用其中的 fullchain.pem 与 privkey.pem 即可,不要再手动拼链,否则续期后配置会失效。
四、配置示例:Nginx 与 Apache 可直接粘贴的 HTTPS 配置
下面这份 Nginx 配置包含 HTTP 跳转、ACME 放行、TLS 1.2/1.3、OCSP Stapling、HSTS 与完整证书链:
server {
listen 80;
server_name example.com www.example.com;
location ^~ /.well-known/acme-challenge/ { root /var/www/html; }
location / { 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/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305: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_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security max-age=31536000 includeSubDomains always;
add_header X-Content-Type-Options nosniff always;
root /var/www/html;
index index.php index.html;
}
应用并校验语法:
nginx -t && systemctl reload nginx
Apache 2.4.8 及以上只需两条指令,SSLCertificateChainFile 已废弃(因为 fullchain 已含中间证书):
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# 版本低于 2.4.8 时才需要:
# SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
三个易错点:一是私钥权限必须为 600、属主为 root 或运行用户,否则 reload 报 cannot load certificate key;二是 HSTS 一旦下发,浏览器会在 max-age 内强制走 HTTPS,首次上线建议先用 max-age=300 灰度,确认全站资源无 http 引用后再改成 31536000;三是 nginx 1.25.1 之后 http2 改为独立指令,仍写在 listen 行里会报 unknown parameter http2。
五、方案对比:验证等级、覆盖范围与有效期怎么选
选型时把三个维度拆开看:验证等级决定信任背书,覆盖范围决定买几张,有效期决定维护成本。
| 验证等级 | 验证内容 | 签发时长 | 适用场景 | 价格区间 |
|---|---|---|---|---|
| DV 域名验证 | 仅验证域名控制权 | 分钟级 | 个人站、测试环境、内部 API | 免费至数百元 |
| OV 组织验证 | 核验企业工商信息 | 1-3 工作日 | 企业官网、电商、SaaS | 千元级 |
| EV 扩展验证 | 严格身份核验 | 3-7 工作日 | 金融、政企 | 数千元 |
注意:2019 年之后主流浏览器已取消 EV 证书的绿色地址栏公司名展示,EV 与 DV 在浏览器 UI 上的差异基本消失,投入产出比需重新评估。
| 覆盖类型 | 示例 | 覆盖范围 | 坑点 |
|---|---|---|---|
| 单域名 | example.com | 仅一个精确域名 | www 子域需另加或使用 SAN |
| 多域名 SAN | a.com / b.com / c.com | 通常 5-100 个 | 后期加域需重签,不能直接追加 |
| 通配符 | *.example.com | 仅一级子域 | 不含 example.com 本身,也不含 a.b.example.com |
| 证书来源 | 有效期 | 续期方式 | 运维成本 |
|---|---|---|---|
| Let’s Encrypt | 90 天 | ACME 自动,剩余 30 天触发 | 首次配置后接近零 |
| 商业 DV/OV | 最长 398 天 | 手工或 API 重签 | 每年至少一次人工介入 |
| 宣传中的 2 年期 | 实际仍为 1 年期证书 | 服务商托管续费 | 依赖服务商履约 |
补充一点趋势:按 CA/Browser Forum 已通过的 SC-081 时间表,公开信任证书的最长有效期将逐步从 398 天压缩到 200 天(2026 年 3 月)、100 天(2027 年 3 月)、47 天(2029 年 3 月)。这意味着任何依赖人工换证书的方案都会在两年内失效,ACME 自动化不再是可选项而是必选项。
六、常见错误排查:真实报错与对应修法
报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate
根因是服务器只发了叶子证书,客户端找不到签发它的中间 CA。修法:改用 fullchain.pem,并在 Nginx 中只配置一次 ssl_certificate。验证命令:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
输出应大于等于 2,等于 1 说明缺中间证书。
报错 2:NET::ERR_CERT_COMMON_NAME_INVALID 或 curl: (60) no alternative certificate subject name matches target host name
证书 SAN 不包含当前访问域名。查证书里到底签了哪些名字:
openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
修法是重签包含 www 的 SAN,而不是把 www 301 到裸域了事——用户先看到的是证书错误页,跳转根本不会执行。
报错 3:curl: (35) error:0A00010B:SSL routines::wrong version number 或浏览器 ERR_SSL_PROTOCOL_ERROR
典型原因:443 端口上跑的是明文 HTTP 服务,或客户端用 https:// 访问了 80 端口;也可能是四层负载均衡没做 TCP 透传而是做了 HTTP 转发。用 curl -v http://example.com:443 与 ss -lntp | grep 443 交叉确认监听进程。
报错 4:nginx: cannot load certificate key ... PEM_read_bio_PrivateKey() failed
私钥与证书不匹配、私钥被加密带密码,或权限不足。用第三节的 modulus md5 对比法定位;若私钥带密码,需先解密:
openssl rsa -in encrypted.key -out plain.key
报错 5:ERR_CERT_DATE_INVALID 或 certificate has expired
先查系统时间 date -u,再查证书到期时间 openssl x509 -in fullchain.pem -noout -enddate。若时间正确而证书已过期,说明自动续期任务静默失败了,用 certbot renew --dry-run 复现。
报错 6:控制台输出 Mixed Content: The page at https://... was loaded over HTTPS, but requested an insecure element http://...
页面引用了 http 资源。把资源地址改为协议相对或 https,并在 Nginx 上加 add_header Content-Security-Policy upgrade-insecure-requests; 兜底。
报错 7:签发失败 Challenge failed for domain example.com ... Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404
依次排查:伪静态规则拦截、CDN 回源未放行该路径、安全组未开 80、以及根目录指向错误。把 location ^~ /.well-known/acme-challenge/ 放在所有 rewrite 之前即可解决大半。
报错 8:SSL_ERROR_NO_CYPHER_OVERLAP
客户端只支持 TLS 1.0/1.1,而服务端只开了 1.2/1.3。这是预期行为,不建议为老旧客户端回退协议;若确有需要,用 openssl s_client -connect example.com:443 -tls1_2 确认服务端支持的最低版本,再评估客户端升级。
报错 9:ERR_TOO_MANY_REDIRECTS
源站与 CDN 同时强制 HTTPS 造成死循环。判断依据是 X-Forwarded-Proto 头,源站应写成 if ($http_x_forwarded_proto = http) { return 301 https://$host$request_uri; },而不是无条件跳转。
七、续期自动化:把证书生命周期交给机器
398 天的上限意味着任何证书一年内必然过期,手工续期迟早出事。certbot 安装后会自带 systemd timer:
systemctl list-timers | grep certbot
systemctl status certbot-renew.timer
certbot renew --dry-run
dry-run 通过后,确认续期钩子能重载服务。在 /etc/letsencrypt/renewal-hooks/deploy/reload.sh 中写入 systemctl reload nginx 并加执行权限。使用 acme.sh 时,用 install-cert 一次性绑定安装路径与重载命令:
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/fullchain.pem
--reloadcmd 'systemctl reload nginx'
crontab -l | grep acme.sh
商业证书没有自动续期,必须自己做到期监控。最轻量的方案是每天跑一次剩余天数检查,少于 30 天即告警:
END=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
echo "剩余 $DAYS 天"
[ "$DAYS" -lt 30 ] && echo ALERT
规模稍大时用 Prometheus 的 blackbox_exporter,配置 ssl 探针并设置 probe_ssl_earliest_cert_expiry 告警规则,比脚本更可靠。同时建议把证书文件纳入配置管理,私钥单独加密存放,避免运维离职后无人知晓证书从哪来、续费账号是谁。
八、效果验证:上线后的验收清单
配置 reload 成功不等于 HTTPS 正确。按下面五步逐项验收,每步都有明确判据。
1)证书信息与到期时间。
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
subject 应包含目标域名,issuer 应是预期的 CA,notAfter 应与你申请的周期一致。
2)证书链完整性。
openssl s_client -connect example.com:443 -servername example.com -verify_return_error
-CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
输出中出现 Verify return code: 0 (ok) 才算链路可信;若返回 20 或 21,分别对应无法获取本地签发者证书与证书链错误。
3)协议与加密套件。确认旧协议确实被禁用:
openssl s_client -connect example.com:443 -tls1_1 </dev/null
预期握手失败并提示 no protocols available。再用 openssl s_client -connect example.com:443 -tls1_3 确认新协议可用。
4)HTTP 层行为。
curl -sI https://example.com | head -5
curl -sI http://example.com | grep -i location
curl -sI https://example.com | grep -i strict-transport-security
判据:https 返回 200 且协议为 HTTP/2;http 返回 301 且 Location 指向 https;响应头包含 Strict-Transport-Security。
5)第三方测评。用 SSL Labs(ssllabs.com/ssltest)或国内 MySSL 做一次完整扫描,目标是 A 级及以上、无证书链警告、无弱套件。扫描会暴露 OCSP Stapling 是否生效、是否支持 TLS 1.3、是否存在 BEAST/POODLE 类问题。
最后补一项业务侧验证:用手机 4G 网络、微信内置浏览器、以及一条 curl --tlsv1.2 的脚本请求各访问一次。桌面浏览器通过不代表客户端全部通过,缺中间证书恰恰是桌面正常、App 报错的经典组合。
常见问题
证书有效期到底有多长?为什么买的 2 年期证书显示 1 年?
自 2020-09-01 起,CA/Browser Forum 规定公开信任的 TLS 证书最长有效期不超过 398 天,主流浏览器强制执行,CA 无法签发 2 年有效期的证书。市面上所谓 2 年期产品,实质是 1 年期证书加一年托管续费服务,第二年由服务商重新签发并部署。Let’s Encrypt 等免费证书有效期为 90 天,需配合 ACME 自动续期。
只部署了服务器证书,为什么桌面浏览器正常、App 却报证书错误?
因为桌面 Chrome 支持 AIA 自动补链,会自己去下载中间证书;而 Android 老版本、微信内置浏览器、Java/Python/Go 等客户端不会。解决办法是把服务器证书与中间 CA 合并成 fullchain.pem 后一次性部署,并用 openssl s_client -showcerts 确认返回的证书数量大于等于 2。
通配符证书能覆盖 example.com 本身吗?能覆盖 a.b.example.com 吗?
都不能。*.example.com 只匹配一级子域,如 www.example.com、api.example.com,不包含裸域 example.com,也不匹配多级子域 a.b.example.com。实际部署时通常签发 example.com + *.example.com 的组合,或者在 SAN 中显式列出需要的主机名。
HTTP-01 验证一直失败,报 404 或超时,怎么排查?
按顺序查四点:域名 A 记录是否指向本机(注意 AAAA 记录);安全组、firewalld、ufw 是否都放行 80;伪静态规则是否拦截了 /.well-known/acme-challenge/ 路径;是否前置了 CDN 且未回源。若域名必须走 CDN,改用 DNS-01 方式,通过添加 TXT 记录完成验证,这也是签发通配符证书的唯一可行方式。
启用 HSTS 后出问题能撤回吗?
可以,但有延迟。HSTS 的 max-age 在用户访问时被浏览器缓存,撤回需要重新下发 Strict-Transport-Security: max-age=0 并等所有回访用户都收到该响应,这期间已缓存的用户仍被强制走 HTTPS。因此首次上线建议先用 max-age=300 灰度几天,确认全站资源无 http 引用、所有子域都有有效证书后,再提升到 31536000。
证书快到期了,可以在不中断服务的情况下换证书吗?
可以。Nginx 与 Apache 都支持平滑重载:先替换磁盘上的 fullchain.pem 与私钥文件,执行 nginx -t 校验语法,再 systemctl reload nginx(不要用 restart)。reload 会启动新 worker 加载新证书,旧 worker 处理完存量连接后退出,用户无感知。务必先做语法校验,否则 reload 失败后旧进程仍在用旧证书,问题会被掩盖到真正过期那天。