SSL 证书申请、配置与部署全流程实战:从 CSR 生成到 Nginx/Apache 上线、TLS 加固与自动续期
问题背景与根因:HTTP 站点正在被浏览器、平台和搜索引擎同时淘汰
很多站点在“证书装上、浏览器能打开”之后就认为万事大吉,但线上最常见的故障是证书链不完整、域名不匹配、协议版本过低这三类问题。它们在桌面 Chrome 上可能毫无症状,却会让微信小程序、iOS App、Java 后端、curl 脚本批量报错。要彻底解决,必须先看清根因。
- 明文传输可被任意篡改。HTTP 下运营商、公共 Wi-Fi、代理设备都能注入广告或替换下载包;HTTPS 通过 TLS 握手协商会话密钥,并用 AEAD 算法做完整性校验,篡改的数据包会被直接丢弃。
- 平台强制要求。微信小程序要求 request 域名必须为 HTTPS、TLS ≥ 1.2、证书由受信任 CA 签发;iOS 的 ATS 默认拒绝非 TLS 1.2 连接;Android 7 起不再信任用户手动安装的 CA 证书。
- 浏览器 UI 惩罚。Chrome 对 HTTP 页面地址栏标记“不安全”;HTTPS 页面中加载 http:// 资源的混合内容默认被阻止,控制台报
Mixed Content。 - 搜索与转化。百度、Google 均把 HTTPS 作为排序的正向信号,且 HTTP 页面在部分场景无法调用地理位置、摄像头等 API。
必须记住的现行规则(过时资料常写错):
- CA/Browser Forum 规定,公有信任 SSL/TLS 证书单张有效期上限 398 天,所谓“三年期证书”实际是三年合同 + 每年重新签发。
- Let’s Encrypt 证书有效期 90 天,官方建议到期前 30 天自动续期,不要手工续。
- TLS 1.0/1.1 已被 RFC 8996 正式弃用,PCI DSS 与主流云厂商均要求 TLS 1.2 起步,推荐直接开 TLS 1.3。
因此正确路径是:选型 → 生成 CSR → 签发 → 部署完整证书链 → 协议加固 → 自动续期 → 验证。每一步都必须可复核,而不是“能打开就行”。
证书选型与有效期规则:DV/OV/EV、通配符与 398 天上限
选型错了,后面所有配置都是白费。先看验证等级:
| 类型 | 验证内容 | 签发时长 | 浏览器展示 | 典型场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权(DNS TXT / HTTP 文件 / 管理员邮箱) | 分钟级 | 锁标志 | 博客、API、内部系统、测试环境 |
| OV 组织型 | 额外核验营业执照、组织电话回访 | 1–3 个工作日 | 锁标志,证书详情可见组织名 | 企业官网、电商、SaaS |
| EV 扩展型 | 最严格的主体与法律存在性核验 | 3–7 个工作日 | 现代浏览器已取消绿色地址栏,仅证书详情体现 | 金融、政企合规场景 |
再看覆盖范围,这是最容易踩坑的地方:
| 类型 | 示例 | 覆盖范围 | 注意事项 |
|---|---|---|---|
| 单域名 | example.com | 仅该主机名 | www.example.com 需另加 SAN |
| 多域名 SAN | example.com + api.example.com | 一张证书挂多个域名,常见 5–100 个 | 后期新增域名要重签 |
| 通配符 | *.example.com | 所有一级子域 | 不覆盖裸域 example.com,也不覆盖 a.b.example.com |
| 通配符多域名 | *.example.com + *.example.net | 多主域 + 子域 | 价格最高,适合多品牌矩阵 |
算法与有效期决策:RSA 2048 兼容性最好,是默认选择;ECDSA P-256 握手更小、性能更好,但 Android 7 以下与 Windows XP 不支持,面向老旧终端建议用 RSA 或做双证书。私钥文件权限必须是 600,绝不进 Git、不复用、不发群。选型一句话总结:能自动续期就选 DV + ACME;需要展示企业身份或过合规审计选 OV/EV;子域多而杂用通配符,但记得把裸域一起写进 SAN。
实操第一步:生成私钥与 CSR(可直接执行的 openssl 命令)
CSR(证书签名请求)包含公钥和主体信息,私钥必须自己保管,永远不要上传给任何人(包括服务商)。先在服务器上建立目录并生成 2048 位 RSA 私钥:
mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
openssl req -new -key example.com.key -out example.com.csr -sha256
-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 及以上。如果服务器是 CentOS 7 自带的 OpenSSL 1.0.2,改用配置文件方式:
cat > csr.cnf <<'EOF'
[req]
default_bits = 2048
prompt = no
default_md = sha256
distinguished_name = dn
req_extensions = req_ext
[dn]
C = CN
O = Example Tech
CN = example.com
[req_ext]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
EOF
openssl req -new -key example.com.key -out example.com.csr -config csr.cnf
生成后必须做两项自检,否则后面签发必然返工:
# 1) 确认 SAN 已写入(没有 SAN 的证书现代浏览器直接判无效)
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
# 2) 确认 CSR 与私钥配对:两条命令输出的哈希必须完全一致
openssl pkey -in example.com.key -pubout -outform der | sha256sum
openssl req -in example.com.csr -pubkey -noout | openssl pkey -pubin -outform der | sha256sum
如果需要 ECDSA 证书,用 openssl ecparam -genkey -name prime256v1 -out example.com.key 生成密钥,其余步骤相同。通配符证书的 SAN 写 DNS:*.example.com,并务必再追加一条 DNS:example.com,否则用户直接访问裸域会报域名不匹配。CSR 生成后即可提交给 CA,私钥全程留在本机。
实操第二步:签发证书(ACME 自动签发与商业 CA 流程)
路径 A:ACME 自动化(推荐,Let’s Encrypt / ZeroSSL 等)。以 acme.sh 为例,先安装并配置邮箱:
curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
acme.sh --set-default-ca --server letsencrypt
HTTP-01 验证要求 80 端口公网可达,webroot 方式不会中断现有服务:
acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
# 或者由 acme.sh 自动改 Nginx 配置
acme.sh --issue -d example.com -d www.example.com --nginx /etc/nginx/conf.d/example.conf
通配符证书只能走 DNS-01,以阿里云 DNS 为例,用 RAM 子账号的 AccessKey(只授予 DNS 解析权限):
export Ali_Key='LTAIxxxxxxxx'; export Ali_Secret='xxxxxxxxxxxx'
acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
签发成功后不要把文件从 ~/.acme.sh/ 手工 cp 出去,要用 --install-cert 建立续期后的自动同步:
acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd 'nginx -t && systemctl reload nginx'
路径 B:商业 CA(OV/EV)。提交上一步生成的 CSR → 域名验证(DNS TXT 记录 / 指定路径文件 / 管理员邮箱)→ 组织验证(营业执照、电话回访)→ 下载证书包。压缩包里通常有三类文件:example.com.crt(服务器证书)、ca_bundle.crt 或 intermediate.crt(中间证书)、root.crt(根证书,一般不用部署)。线上必须部署“服务器证书 + 中间证书”拼接成的 fullchain,顺序不能反。用 cat 拼接并校验:
cat example.com.crt ca_bundle.crt > example.com.fullchain.pem
openssl verify -CAfile root.crt -untrusted ca_bundle.crt example.com.crt
certbot 用户可用 certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --deploy-hook 'systemctl reload nginx',签发与续期逻辑同源。
实操第三步:Nginx、Apache、云负载均衡部署配置示例
Nginx(1.25.1+ 写法):80 端口强制跳转,443 加载 fullchain 与私钥。
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # 1.25.1 之前写作 listen 443 ssl http2;
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-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;
add_header Strict-Transport-Security 'max-age=31536000' always;
root /var/www/html;
}
Apache 2.4:注意 2.4.8 起 SSLCertificateChainFile 已废弃,中间证书直接拼进 SSLCertificateFile。
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
云负载均衡 / CDN(阿里云 CLB、腾讯云 CLB、AWS ALB):在证书管理页上传时,平台通常分“证书内容”和“私钥”两个输入框,证书内容必须按“服务器证书在前、中间证书在后”的顺序粘贴整段 fullchain,只贴服务器证书会重现 unable to get local issuer certificate。后端监听 80 或 443 时,业务代码要读 X-Forwarded-Proto 判断真实协议,否则会陷入重定向死循环。
Kubernetes Ingress:
kubectl create secret tls example-tls --cert=example.com.fullchain.pem --key=example.com.key
然后在 Ingress 的 spec.tls[].secretName 引用该 Secret,并加注解 nginx.ingress.kubernetes.io/ssl-redirect: 'true'。改完配置务必先 nginx -t 或 apachectl configtest,再 reload,不要 restart。
证书链、TLS 加固与自动续期:一张表定标准
证书链的信任路径是:服务器证书 → 中间证书 → 根证书。根证书内置在操作系统和浏览器中,所以只需部署到中间证书。缺中间证书时桌面 Chrome 可能通过 AIA 自动补全而“看起来正常”,但 curl、Java、Android、微信小程序不会补全,直接报错。
| 加固项 | 推荐值 | 说明 |
|---|---|---|
| 协议版本 | TLSv1.2 + TLSv1.3 | TLS 1.0/1.1 已被 RFC 8996 弃用,PCI DSS 禁止 |
| 加密套件 | 仅 ECDHE + AEAD(GCM / CHACHA20) | ssl_ciphers 只影响 TLS 1.2,TLS 1.3 套件由 OpenSSL 管理 |
| 会话复用 | shared:SSL:10m,关闭 session tickets | tickets 关闭可提升前向保密性 |
| HSTS | max-age 从 300 起步,稳定后升到 31536000 | 加 includeSubDomains 前先确认所有子域都有证书 |
| OCSP Stapling | 开启并配置 ssl_trusted_certificate | Let’s Encrypt 已于 2025 年停止 OCSP 服务,此时 stapling 无响应但不影响握手,不必回滚 |
| 混合内容 | CSP: upgrade-insecure-requests | 把页面内 http:// 资源自动升级为 https |
OCSP Stapling 的 Nginx 配置要点:ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate /etc/nginx/ssl/example.com.fullchain.pem; resolver 223.5.5.5 119.29.29.29 valid=300s;,缺少 resolver 会静默失败。
自动续期方面,acme.sh 安装时已写入 crontab,用 crontab -l | grep acme 确认;certbot 使用 systemd timer,用 systemctl list-timers | grep certbot 确认。续期前先演练:acme.sh --renew -d example.com --force 或 certbot renew --dry-run。再加一个到期巡检脚本兜底:
#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ($(date -d "$END" +%s) - $(date +%s)) / 86400 ))
[ $DAYS -lt 15 ] && echo "WARN: $DOMAIN cert expires in $DAYS days" | mail -s 'cert alert' ops@example.com
常见错误排查:真实报错、根因与修复命令
| 真实报错 | 根因 | 修复动作 |
|---|---|---|
curl: (60) SSL certificate problem: unable to get local issuer certificate |
只部署了服务器证书,缺中间证书;或客户端 CA 库过旧 | 改为部署 fullchain;curl --cacert fullchain.pem 验证;yum install -y ca-certificates 更新 |
NET::ERR_CERT_AUTHORITY_INVALID |
自签名证书、根证书不受信任、证书链断裂 | openssl s_client -connect example.com:443 -showcerts 查看链是否完整 |
NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN |
SAN 不含访问的域名;通配符不匹配二级域 | 重新签发并把裸域、www、子域全部写入 SAN |
NET::ERR_CERT_DATE_INVALID |
证书过期,或服务器系统时间漂移 | timedatectl status 校对时间,systemctl restart chronyd |
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed ... key values mismatch |
证书与私钥不配对,常见于多套证书混用 | 用前面的 sha256 公钥指纹比对法确认配对关系 |
Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxx |
80 端口未放行、301 跳到无效 HTTPS、CDN 回源异常、webroot 路径不对 | 临时放行 80;改用 --dns 方式签发;检查 webroot 是否指向站点真实根目录 |
Problem binding to port 80: Could not bind to IPv4 or IPv6 |
Nginx/Apache 已占用 80 端口,standalone 模式冲突 | 改用 --nginx / --webroot 模式,或先停服务 |
ERR_SSL_PROTOCOL_ERROR |
https 流量打到了纯 HTTP 端口,或协议版本被裁到只剩 TLS 1.3 而客户端不支持 | 核对监听端口与 ssl_protocols,至少保留 TLS 1.2 |
还有两类“不报错但影响业务”的问题:一是混合内容,控制台提示 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource,需把资源地址改为 https 或加 CSP;二是 HSTS 误开 includeSubDomains 导致无证书的旧子域彻底打不开,此时只能在浏览器清除 HSTS 缓存或用 max-age=0 覆盖,恢复成本很高,上线前务必确认子域清单。
效果验证:从 openssl 到 SSL Labs 的验收清单
配置完成后按顺序跑完以下命令,全部通过才算交付:
# 1) 协议与套件(TLS 1.2 与 1.3 各测一次,1.3 应成功)
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>&1 | grep -E 'Protocol|Cipher'
# 2) 有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -subject -ext subjectAltName
# 3) 证书链完整性,必须看到 Verify return code: 0 (ok)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 | grep 'Verify return code'
# 4) HTTP 是否 301 到 HTTPS
curl -I http://example.com
# 5) HSTS 头是否下发
curl -sI https://example.com | grep -i strict-transport-security
# 6) OCSP Stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>&1 | grep -A1 'OCSP Response Status'
在线验收:SSL Labs 跑一次完整测试,目标 A 及以上(要 A+ 需开 HSTS 且 max-age ≥ 15552000),重点看 Certificate 的“Chain issues”是否为 None、Protocols 是否已无 TLS 1.0/1.1;国内站点可再用 MySSL 交叉验证。
业务侧验收同样不能省:微信公众平台“开发设置 → 服务器域名”处填写后会有校验提示;小程序开发者工具“详情 → 域名信息”可看实际握手结果;iOS 端确认 ATS 未被临时关闭;用 curl -sI https://example.com 确认响应头里没有 X-Cache: HIT 的旧证书缓存(CDN 需手动刷新证书)。灰度建议:先在测试域名完整走一遍全流程,生产切换时保留旧证书至少 7 天,reload 而非 restart,观察 error.log 中是否出现 SSL_do_handshake() failed 后再清理。
常见问题
按 CA/Browser Forum 规定,公有信任证书单张有效期上限为 398 天;Let’s Encrypt 为 90 天。市面上“三年期”产品实际是三年服务合同,CA 仍会每年重新签发一张新证书,到期必须更换,因此自动续期是必选项。
不能。通配符只匹配一级子域,如 www.example.com、api.example.com,既不覆盖裸域 example.com,也不覆盖 a.b.example.com。正确做法是签发时在 SAN 中同时写入 DNS:*.example.com 和 DNS:example.com。
多数是证书链不完整,只部署了服务器证书而漏掉中间证书。桌面 Chrome 会通过 AIA 自动补全,curl、Java、Android、小程序不会。把服务器证书与中间证书拼成 fullchain 后重新加载即可解决。
不需要重启,reload 即可平滑加载新证书且不中断连接。标准流程是先执行 nginx -t 校验配置,通过后再 systemctl reload nginx。只有修改了监听端口等无法热加载的配置才需要 restart。
加密强度没有区别,两者使用相同的 TLS 协议与算法,浏览器锁标志也一致。差异在于身份验证等级、有效期长短、赔付条款、技术支持,以及通配符和多域名能力,合规审计场景通常要求 OV 及以上。