单域名 SSL 证书部署全流程:CSR 生成、Nginx/Apache 配置与 HTTPS 故障排查
一、买了“单域名 HTTPS 授权”为什么还是提示不安全
最常见的售后场景是:用户按“单域名 https 证书”下了单,也购买了安装调试服务,部署完成后浏览器依旧弹出“您的连接不是私密连接”,或者 PC 端正常、手机 App 报错,又或者 curl 直接返回 curl: (60) SSL certificate problem。这类问题九成不是证书“没生效”,而是下面五个根因之一。
根因一:单域名只保护一个精确主机名。现代证书的域名写在 SAN(subjectAltName)扩展里,CN 字段自 2017 年起被 Chrome、Safari、Edge 全面忽略。证书是 example.com,访问 www.example.com 必然报 NET::ERR_CERT_COMMON_NAME_INVALID。下单前必须确认“单域名”是否赠送 www 的 SAN,这一条能省掉一半售后工单。
根因二:证书链不完整。服务器只下发了叶子证书,没有附带中间证书。Chrome 会通过 AIA 扩展自动补链,所以看起来“我这儿好好的”,而 Android 老版本、Java 客户端、Go、curl 直接失败,报 unable to get local issuer certificate。
根因三:私钥与证书不匹配,或者私钥权限过大被 Nginx 拒绝加载。
根因四:协议层错误。443 端口上跑的是明文 HTTP,或 SNI 未生效导致一台机器多站点时返回了默认站点的证书。
根因五:有效期规则已经变了。过去教程里写的“最长 825 天”“398 天”均已过时:CA/Browser Forum 第 SC-081 号决议规定,2026-03-15 起新签发证书最长有效期 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。所以“一次买三年”实际是按多张 200 天证书连续签发,交付方式和报价都要按这个来算。免费证书方面,Let’s Encrypt 仍是 90 天,并已公布向 45 天乃至 6 天短周期证书过渡的计划,自动续期从“可选”变成“必须”。
排查第一步永远是看服务端到底发了什么:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
输出里 SAN 不含当前域名 → 换证书;只看到一张证书 → 补链;notAfter 已过 → 续签;subject 与 issuer 相同 → 装的是自签证书。
二、签发前准备:域名核对、CSR 与私钥生成
动手前先做四项核对,任何一项没通过都会导致后续签发或验证失败:
- 解析:
dig +short A example.com与dig +short A www.example.com都要指向即将部署的服务器。 - 端口:80 与 443 在安全组和系统防火墙中放行,
telnet example.com 443可通。 - CAA:
dig +short CAA example.com,若已有 CAA 记录且只允许某家 CA,换 CA 签发会直接失败并报 CAA_ERROR。 - 时间:
timedatectl确认 NTP 已同步,系统时间偏差会导致证书“尚未生效”。
生成私钥与 CSR(建议在目标服务器上生成,私钥不出本机):
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
chmod 600 example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
-addext 需要 OpenSSL 1.1.1 及以上;版本较低时改用配置文件增加 [v3_req] 段并配合 -reqexts v3_req。CSR 里的 SAN 就是最终证书的域名集合,提交后再改只能重签。
校验 CSR 与私钥是否配对:
openssl req -in example.com.csr -noout -verify -text | grep -A2 "Subject Alternative Name"
openssl req -in example.com.csr -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
两条 md5 一致即配对成功,不一致说明私钥文件被覆盖过,必须重新生成并重新提交 CSR。
验证方式选型:HTTP-01 要求公网能访问 http://example.com/.well-known/acme-challenge/,适合有公网 80 端口的站点;DNS-01 通过 TXT 记录验证,适合内网服务器、通配符证书和 80 端口被封的场景。OV/EV 证书还要额外提交营业执照、组织信息,审核 1–3 个工作日,期间可先用 DV 证书顶上。
三、证书文件处理:fullchain 拼接顺序与格式转换
CA 下发的压缩包里通常有四类文件:example.com.crt(叶子证书)、ca-bundle.crt 或 intermediate.crt(中间证书)、example.com.csr、example.com.key。Nginx 的 ssl_certificate 必须指向“叶子 + 中间”的合并文件,顺序不能反:
cat example.com.crt intermediate.crt > example.com.fullchain.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted intermediate.crt example.com.crt
# example.com.crt: OK
注意不要把根证书拼进去。根证书在客户端信任库里已有,多带一张只会让握手包变大(多 1–2 KB),个别老客户端还会因为链里出现自签根而判定异常。
检查链里每张证书的 subject/issuer 是否首尾相接:
awk 'BEGIN{c=0} /BEGIN CERT/{c++} {print > "cert"c".pem"}' example.com.fullchain.pem
for f in cert*.pem; do openssl x509 -in $f -noout -subject -issuer; done
理想输出是 cert1 的 issuer 等于 cert2 的 subject,逐级向上直到受信根。
格式转换(CA 给的文件后缀不可信,一律用 file 命令确认):
file example.com.crt
openssl x509 -inform DER -in example.com.der -out example.com.crt
openssl pkcs7 -print_certs -in chain.p7b -out chain.pem
openssl pkcs12 -export -in example.com.fullchain.pem -inkey example.com.key -name tomcat -out example.com.p12 -passout pass:YourStrongPass
最常见的低级错误是用记事本另存,文件头带上 UTF-8 BOM 或 CRLF 换行,Nginx 直接报 PEM_read_bio_X509_AUX() failed ... no start line。处理办法:sed -i '1s/^xEFxBBxBF//' file.pem 去掉 BOM,dos2unix file.pem 转换行符,再用 openssl x509 -in file.pem -noout -subject 确认能正常解析。
四、Nginx 部署单域名 HTTPS:完整配置与上线命令
下面这份 server 块可直接粘贴(Nginx 1.25.1 及以上用 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 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/example.com.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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
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/intermediate.crt;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security "max-age=31536000" always;
root /var/www/example.com;
index index.html;
}
几个参数必须解释清楚:ssl_trusted_certificate 指向中间证书(不是 fullchain),OCSP stapling 靠它校验;resolver 是 stapling 解析 OCSP 地址用的,不配会报 no resolver defined to resolve ocsp...。国内服务器访问境外 CA 的 OCSP 服务器经常超时,表现为首次握手慢 1–3 秒,此时把 ssl_stapling 关掉反而更快,代价是客户端要自己查 OCSP。
HSTS 的 includeSubDomains 与 preload 不要一上来就加:一旦下发,所有子域在 max-age 内只能用 HTTPS,回退不了。
上线与生效:
nginx -t
# nginx: configuration file /etc/nginx/nginx.conf test is successful
systemctl reload nginx
curl -I http://example.com
# HTTP/1.1 301 Moved Permanently
# Location: https://example.com/
reload 是热加载,老 worker 处理完存量连接后退出,不会断开在线业务;restart 才会。生产环境优先 reload,且 reload 前必须 nginx -t 通过,否则新配置不生效而老进程仍在跑,容易出现“改了没反应”的假象。
五、Apache 与 Tomcat 的配置示例
Apache 2.4 的虚拟主机写法:
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# 2.4.8 之前需单独指定中间证书;之后把链拼进 SSLCertificateFile 即可
# SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
DocumentRoot /var/www/html
</VirtualHost>
apachectl configtest
# Syntax OK
systemctl reload httpd
Tomcat 不能直接读 PEM,需要转成 PKCS12。JDK 9 之后 PKCS12 是默认类型,推荐使用:
openssl pkcs12 -export -in example.com.fullchain.pem -inkey example.com.key -name tomcat -out /opt/tomcat/conf/example.com.p12 -passout pass:YourStrongPass
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" maxThreads="200" SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.com.p12" certificateKeystorePassword="YourStrongPass" certificateKeystoreType="PKCS12" type="RSA" />
</SSLHostConfig>
</Connector>
Tomcat 8.5/9 中旧的 keystoreFile、keystorePass 属性写在 Connector 上仍可用但已标记为 legacy,新配置建议用 SSLHostConfig。改完必须 systemctl restart tomcat,Tomcat 不支持热加载证书。Java 客户端报 unable to find valid certification path to requested target,多数是 JDK 版本不认新根证书(如 ISRG Root X1 在 JDK 8u141 之前不存在),升级 JDK 或在 cacerts 中导入根证书。
如果前面还有 SLB 或 CDN,证书应装在负载均衡上,后端 Nginx 保持 HTTP 即可;此时后端若仍强制 301 到 https 且未处理 X-Forwarded-Proto,会出现重定向死循环。
六、证书类型与有效期对比:怎么选、怎么续
先看证书形态,单域名不是唯一选择,选错形态的代价是后续每加一个域名都要重签:
| 类型 | 覆盖范围 | 参考价格 | 适用场景 | 注意点 |
|---|---|---|---|---|
| 单域名 DV | example.com(www 需 CA 赠送 SAN) | 免费–300 元/年 | 单站点、测试环境 | 不含子域,www 与裸域要分别确认 |
| 通配符 DV | *.example.com 一级子域 | 800–2000 元/年 | 子域多、SaaS 多租户 | 不覆盖 example.com 本身,也不覆盖 a.b.example.com |
| 多域名 SAN | 一张证书 3–100 个域名 | 按域名数计价 | 多品牌、多主域站点 | 后期加域名要重签 |
| IP 证书 | 公网 IP 地址 | 较高 | 无域名的内网 API | 需客户端信任库支持,兼容性需实测 |
| OV / EV | 单域名或通配符 | 1500–6000 元/年 | 金融、政企、招投标 | 需营业执照审核 1–3 天 |
再看有效期。这条时间线决定了运维方式,老教程里的数字基本都过期了:
| 时间节点 | 单张证书最长有效期 | 对运维的影响 |
|---|---|---|
| 2018-03-01 起 | 825 天 | 一年多一续 |
| 2020-09-01 起 | 398 天 | 一年多一续,需留意 |
| 2026-03-15 起 | 200 天 | 一年至少续 2 次 |
| 2027-03-15 起 | 100 天 | 必须自动化续期 |
| 2029-03-15 起 | 47 天 | 全自动 + 到期告警 |
Let’s Encrypt 免费证书有效期 90 天,官方已公布后续缩短至 45 天并提供更短周期证书选项;无论付费还是免费,certbot renew、ACME 客户端或云厂商托管续签都必须配好,靠日历提醒已经跟不上 200 天以下的节奏。
选型结论:只有裸域一个入口选单域名 DV;有 www、m、api 多个子域选通配符;域名分散在不同主域选多域名 SAN;需要展示企业身份、走招投标或等保材料选 OV。海外业务注意 OCSP/CRL 在境内的可达性,国内业务优先选国内 OCSP 节点齐全的 CA。
七、常见报错逐条排查
下面这些报错信息在工单里出现频率最高,对照根因处理即可:
| 报错信息 | 根因 | 处理方式 |
|---|---|---|
| curl: (60) SSL certificate problem: unable to get local issuer certificate | 缺中间证书或 fullchain 顺序错误 | 重拼 fullchain,用 openssl verify -untrusted 验证 |
| NET::ERR_CERT_COMMON_NAME_INVALID / x509: certificate is valid for a.example.com, not example.com | SAN 不含当前访问域名 | 重签含 www 的 SAN,或 301 统一到证书覆盖的域名 |
| nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) | 证书与私钥不配对 | 用 pubkey md5 比对,换回匹配的私钥 |
| nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) | 文件是 DER/PKCS7,或带 BOM、CRLF | file 确认格式后转 PEM,去 BOM、dos2unix |
| SSL_ERROR_NO_CYPHER_OVERLAP | 客户端只支持 TLS1.0/1.1,服务端已禁用 | 确认客户端构成,必要时仅保留 TLSv1.2(不建议重开 1.0/1.1) |
| ERR_SSL_PROTOCOL_ERROR | 443 被 HTTP 服务占用,或 CDN 回源协议配错 | ss -lntp 查端口占用,检查回源协议 |
| certificate has expired or is not yet valid | 系统时间偏差或证书已过期 | timedatectl 校时,openssl x509 -enddate 查到期 |
| x509: certificate signed by unknown authority | 自签证书或客户端信任库过旧 | 换受信 CA,或在客户端导入根证书 |
配套的定位命令:
ss -lntp | grep -E ':443|:80'
openssl x509 -in example.com.fullchain.pem -noout -dates -subject -ext subjectAltName
openssl x509 -in example.com.fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
openssl s_client -connect 127.0.0.1:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null
最后一条命令输出末尾出现 Verify return code: 0 (ok) 才算本地链路完全正确;出现 21 (unable to verify the first certificate) 就是缺中间证书;出现 10 (certificate has expired) 是到期或时间不对。
八、效果验证与长期运维
上线后按协议、证书、链路、业务四层依次验证,每条命令都能直接执行:
# 1. 协议与套件
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep -E "Protocol|Cipher"
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 期望:TLS1.1 握手失败,说明旧协议已关闭
# 2. 证书信息
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 3. 跳转与响应头
curl -sSI https://example.com | head -n 8
curl -sSI http://example.com | grep -i location
# 4. OCSP stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -i "OCSP Response Status"
到期监控脚本,放进 crontab 每天跑一次,比任何人工台账都可靠:
END=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
if [ "$DAYS" -lt 21 ]; then
echo "example.com 证书剩余 ${DAYS} 天" | mail -s "[SSL] 证书即将到期" ops@example.com
fi
自动续期方面:Let’s Encrypt 用 certbot renew --dry-run 先演练,确认 /etc/letsencrypt/renewal-hooks/deploy/ 下有 reload 脚本,再交给 certbot.timer。付费证书到期前 30 天联系 CA 重签,把新 fullchain 覆盖旧文件后 reload 即可,无需改动配置文件。
最后用外部视角复核:SSL Labs 看是否 A 及以上,重点看 Certificate is not trusted 与 Chain issues 两项;国内可用 myssl.com 检测,对国内 OCSP 与国密支持更友好。App 端还要用真机(尤其 Android 7 以下)跑一次,验证中间证书与根证书兼容性,这是内部测试最容易漏掉的一环。
常见问题
单域名证书能同时用于 example.com 和 www.example.com 吗?
不能自动覆盖。证书只对 SAN 列表里的主机名生效,下单时要确认 CA 是否免费附带 www 的 SAN;多数 DV 单域名证书允许在 CSR 中同时提交裸域和 www,但这属于 CA 政策而非技术必然。若已签发且不含 www,两种处理:重签带 www 的证书,或在 Nginx 里把 www 301 跳到裸域,让用户始终访问证书覆盖的域名。
证书最长有效期到底是 398 天还是 200 天?
398 天是 2020-09-01 至 2026-03-15 之间的规则,已经过时。按 CA/Browser Forum SC-081 决议,2026-03-15 起新签发证书最长 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。所以“买三年”实际上是三年内分多次签发,续期必须自动化。Let’s Encrypt 免费证书为 90 天,并计划进一步缩短。
为什么 Chrome 访问正常,App 和 Java 客户端却报证书错误?
因为 Chrome 会通过证书里的 AIA 地址自动下载中间证书补链,而 Android 老版本、Java、Go、curl 不会。服务端只发了叶子证书时,就出现“浏览器正常、客户端报 unable to get local issuer certificate”的典型现象。解决办法是把中间证书拼进 fullchain,并用 openssl verify -untrusted 验证通过。
更换证书需要重启 Nginx 吗?会中断业务吗?
不需要重启,nginx -t && systemctl reload nginx 即可。reload 会启动新 worker 加载新证书,老 worker 处理完存量连接后优雅退出,在线请求不受影响。注意 reload 前必须让 nginx -t 通过,否则新配置不生效但老进程仍在跑。Tomcat 不支持热加载证书,只能 restart。
免费证书和付费证书的差别在哪里?
技术上加密度和浏览器信任完全一样。差别在有效期(免费 90 天 vs 付费最长 200 天)、验证类型(免费只有 DV,付费有 OV/EV 可展示组织信息)、保障赔付、OCSP 节点分布、是否支持通配符与多域名、以及出问题时的工单支持。对外运营站点用免费证书加自动续期完全够用;招投标、等保、金融合规场景才需要 OV/EV。
证书装在 SLB 或 CDN 上,后端服务器还要装吗?
不需要。TLS 在 SLB/CDN 处终结,后端走内网 HTTP 即可。但要注意三点:后端应用若根据 X-Forwarded-Proto 生成绝对 URL,需正确传递该头,否则出现重定向循环;后端若仍强制 301 到 https,会与前端形成死循环;SLB 到后端的健康检查要指向 HTTP 端口。若采用全链路加密(回源也走 HTTPS),则后端需要配置证书,且回源域名必须与证书 SAN 一致。