SSL/TLS 证书部署完整指南:CSR 生成、Nginx/Apache/IIS/Tomcat 配置、报错排查与自动续期
一、为什么必须部署 SSL/TLS:问题背景与根因
很多文章把 SSL 证书部署描述成“买一个装上就行”的服务,但从工程角度看,它解决的是三个具体问题:传输层明文、服务端身份不可验证、以及现代浏览器与移动平台对安全上下文的强制要求。理解根因,才能解释后面所有配置项为什么必须写。
根因 1:HTTP 明文可被任意篡改。链路中间的运营商、公共 Wi-Fi 网关、透明代理都可以在响应体里插入广告或 JS,这就是常说的“广告劫持”;Cookie 未加 Secure 属性时随明文传输,会话可被直接复制。TLS 通过证书公钥协商出会话密钥,中间人无法解密,也无法伪造签名,从协议层消除这类注入。
根因 2:平台与 API 强制安全上下文。微信小程序 wx.request 只接受 https 域名;iOS 的 ATS(NSAppTransportSecurity)默认拒绝非 TLS 连接,需额外配置例外;Chrome 自 68 起对 HTTP 页面地址栏标注“不安全”;HTTP/2 在浏览器中只通过 TLS + ALPN 协商,HTTP/3 更是基于 QUIC + TLS 1.3;Service Worker、地理位置、摄像头、剪贴板等 Web API 均要求 secure context。没有证书,这些能力直接不可用。
根因 3:证书有效期规则已经变化。这里必须修正原文“默认提供有效期为一年的 SSL 证书”的说法。按 CA/Browser Forum 基线要求,2020-09-01 之后签发的公信证书单张有效期不得超过 398 天,Apple 对超过 398 天的证书在 iOS/macOS 上直接拒绝信任;Let’s Encrypt 的证书固定 90 天。所谓“一年”只是服务商的托管与续期服务期,不等于单张证书有效期。因此部署方案必须包含自动续期,否则 398 天后必然中断。
根因 4:线上故障多数不在签发环节。实际排障中占比最高的是证书链不完整(缺中间证书)、私钥与证书不匹配、多站点未启用 SNI、协议与加密套件过旧,而不是 CA 没签发成功。所以部署的重点是“链、配对、协议”三件事。
二、证书选型:DV / OV / EV 与单域名 / 多域名 / 通配符
选型要同时看两个维度:验证级别(决定审核流程和证书里的 O 字段)和覆盖范围(决定 SAN 列表怎么写)。
| 验证级别 | CA 验证内容 | 签发时长 | 浏览器表现 | 典型场景 |
|---|---|---|---|---|
| DV 域名型 | 仅域名控制权:DNS TXT、HTTP 文件、CNAME | 1-10 分钟 | 锁标识,证书详情无组织信息 | 个人站、API、内部系统、小程序后端 |
| OV 企业型 | 域名控制权 + 工商登记核验(第三方库或电话回访) | 1-5 个工作日 | 锁标识,证书详情可见 O 字段 | 企业官网、SaaS、B 端门户 |
| EV 增强型 | 域名 + 严格法人核验,部分 CA 需律师函或邓白氏编码 | 3-10 个工作日 | Chrome 77 起已取消绿色地址栏与公司名展示,Safari 同样移除 | 金融、支付合规审计场景 |
原文“EV 证书浏览器地址栏直接显示公司名称”已过时:Chrome 77(2019 年)移除 EV 视觉指示器,Safari 也不再展示。EV 现在的价值主要在合规审计、CT 日志中的品牌可见性与部分行业保险要求,而不是“地址栏变绿”。
| 覆盖类型 | 写法示例 | 覆盖范围 | 注意 |
|---|---|---|---|
| 单域名 | CN=www.example.com | 仅该主机名 | example.com 与 www.example.com 视为两个域名 |
| 多域名 SAN | SAN: a.com, b.com, api.c.com | SAN 列表内全部域名 | 部分 CA 上限 100 个,扩容需重新签发 |
| 通配符 | CN=*.example.com | 仅一级子域 | 不覆盖 a.b.example.com,也不覆盖裸域 example.com |
选型建议:个人站与中小业务直接用 DV,Let’s Encrypt、ZeroSSL 等可免费获取;需要覆盖大量子域时用通配符,但通配符只能走 DNS-01 验证,必须有 DNS API 权限;企业门户按合规要求选 OV。预算有限时优先保证“链完整 + 自动续期”,而不是追求 EV。
三、实操第一步:在服务器本地生成私钥与 CSR
私钥必须在自己控制的机器上生成,不要提交给任何服务商。原文“购买须知”里让用户提供域名管理权限和服务器版本是可以的,但如果对方要求你上传私钥,等于把身份交出去。以下命令可直接执行:
mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
# RSA 2048,兼容性最好
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
chown root:root example.com.key
# 生成 CSR 并写入 SAN(OpenSSL 1.1.1+ 支持 -addext)
openssl req -new -sha256 -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'
OpenSSL 1.0.2 不支持 -addext,需要改用配置文件:
cat > san.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = v3_req
prompt = no
[dn]
CN = example.com
[v3_req]
subjectAltName = @alt
[alt]
DNS.1 = example.com
DNS.2 = www.example.com
EOF
openssl req -new -sha256 -key example.com.key -out example.com.csr -config san.cnf
如需 ECDSA 私钥(TLS 1.3 下握手更快):openssl ecparam -genkey -name prime256v1 -out example.com.key。校验 CSR 内容是否包含 SAN:openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'。
两个常见坑:CN 字段上限 64 字节,超过会报错,长域名请把完整列表放 SAN;CSR 一旦签发就不能再改域名,改域名必须重新生成 CSR 并重新签发。
四、实操第二步:域名验证与签发
DV 证书的验证方式只有三类:HTTP-01(80 端口放文件)、DNS-01(TXT 记录)、TLS-ALPN-01(443 端口)。通配符只能走 DNS-01。先用命令确认环境是否满足:
# HTTP-01:确认 80 端口可达,且 .well-known 路径没有被强制跳转或拦截
curl -I http://example.com/.well-known/acme-challenge/test
# DNS-01:确认 TXT 已生效,换两个公共 DNS 交叉验证
dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1
# 检查 CAA 记录,若存在则必须允许签发 CA
dig +short CAA example.com
用 Certbot 申请通配符证书:
certbot certonly --manual --preferred-challenges dns
-d example.com -d '*.example.com'
--agree-tos -m ops@example.com
商业 CA 的 DV 流程通常是给你一条 _dnsauth 或 _acme-challenge 的 TXT 记录,TTL 建议设 60-600 秒。权威 DNS 多节点同步有延迟,验证前务必用两个不同的递归 DNS 查询确认。若同一域名并发签发多条记录,不要把旧 TXT 删掉再建新的,应保留多值,否则先提交的验证会失败。
常见报错 urn:ietf:params:acme:error:caa 表示 CAA 记录不允许该 CA,解决方式是添加 0 issue 'letsencrypt.org'。签发成功后得到四个文件:cert.pem(叶子证书)、chain.pem(中间证书)、fullchain.pem(叶子+中间,Nginx 用这个)、privkey.pem。顺序不能错:叶子在前,中间在后,绝对不能把根证书拼进去,否则部分客户端会报链错误。
五、配置示例:Nginx / Apache / IIS / Tomcat
Nginx 是最常见的场景,注意 http2 指令在 1.25.1 之后独立成行:
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
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/nginx/ssl/fullchain.pem;
ssl_certificate_key /etc/nginx/ssl/example.com.key;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
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;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
}
执行 nginx -t && systemctl reload nginx。Apache 配置(2.4.8+ 也可把 chain 追加进 SSLCertificateFile,但保留 ChainFile 更清晰):
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/cert.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/chain.pem
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
IIS 用 PFX 导入并绑定,务必勾选 SNI(SslFlags 为 1),中间证书要装进“中间证书颁发机构”存储,否则浏览器报链错误:
Import-PfxCertificate -FilePath C:certexample.pfx -CertStoreLocation Cert:LocalMachineMy -Password (ConvertTo-SecureString -String 'PfxPass' -AsPlainText -Force)
New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 -HostHeader example.com -SslFlags 1
Tomcat 8.5+ 直接支持 PEM,无需 JKS:
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig>
<Certificate certificateFile="/opt/tomcat/ssl/cert.pem"
certificateChainFile="/opt/tomcat/ssl/chain.pem"
certificateKeyFile="/opt/tomcat/ssl/example.com.key" type="RSA" />
</SSLHostConfig>
</Connector>
六、证书格式与部署方式对比
同一个证书在不同平台需要不同封装,搞错格式是最常见的低级故障来源。
| 格式 | 内容 | 适用平台 | 转换命令 |
|---|---|---|---|
| PEM(.pem/.crt/.cer) | Base64 文本,可含多张证书 | Nginx、Apache、Tomcat 8.5+、HAProxy | openssl x509 -in cert.der -inform DER -out cert.pem |
| DER(.der/.cer) | 二进制单证书 | Java 部分场景、嵌入式设备 | openssl x509 -in cert.pem -outform DER -out cert.der |
| PFX / PKCS#12 | 私钥 + 叶子 + 链,带密码 | IIS、Windows、Java | openssl pkcs12 -export -out example.pfx -inkey example.com.key -in fullchain.pem -certfile chain.pem |
| JKS | Java KeyStore | Tomcat 7 及更早、老版 WebLogic | keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12 -destkeystore example.jks -deststoretype JKS |
部署方式上,手工粘贴 PEM 适合单机少量站点;PFX 适合 Windows 体系;大规模环境推荐统一在入口层(Nginx/HAProxy/云 LB)终止 TLS,后端走内网 HTTP,这样证书只在一处续期。ACME 客户端 + deploy-hook 自动重载是当前主流做法,可以彻底避免“忘记续期导致全站不可访问”。
七、常见错误排查(含真实报错)
以下报错按出现频率排序,每条都给出定位命令。
- curl: (60) SSL certificate problem: unable to get local issuer certificate,浏览器对应 ERR_CERT_AUTHORITY_INVALID。原因几乎都是缺中间证书。定位:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE',正常应为 2(叶子+中间)。修复:Nginx 的 ssl_certificate 改指 fullchain.pem。 - ERR_CERT_COMMON_NAME_INVALID:证书 SAN 不含当前域名。检查
openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name',注意裸域与 www 是两条 SAN。 - nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line):文件路径错、文件为空、内容是 DER 二进制,或把私钥误写进了证书文件。
- nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不配对。比对:
openssl x509 -noout -modulus -in cert.pem | openssl md5与openssl rsa -noout -modulus -in example.com.key | openssl md5,两者必须一致。 - ERR_SSL_PROTOCOL_ERROR / SSL_ERROR_NO_CYPHER_OVERLAP:协议或套件无交集,或 443 端口被非 TLS 服务占用(Nginx 与 Apache 抢端口)。用
ss -lntp | grep 443确认监听进程。 - ERR_CERT_DATE_INVALID:服务器或客户端时间漂移,执行
timedatectl status检查 NTP 同步。 - urn:ietf:params:acme:error:unauthorized … Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404:webroot 路径配错,或 80 被强制跳转到 https。加
--webroot -w /var/www/html指定真实根目录。 - too many failed authorizations recently:触发速率限制,需等待约 1 小时。调试期先用
--dry-run或--staging环境。 - 老设备报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH:禁用 TLS 1.0/1.1 后,Android 4.x、Windows 7 未打补丁的客户端无法握手。需评估终端分布再决定兼容策略。
另外,Windows XP 与 Android 2.x 不支持 SNI,多站点共用 443 时会拿到默认证书,这是历史客户端问题,不能通过配置修复。
八、效果验证与自动续期
部署完成后必须做客观验证,而不是只看浏览器有没有锁。
# 查看服务端实际下发的证书链、有效期与签发者
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 检查 OCSP Stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -i 'OCSP Response Status'
# 到期前 30 天预警,返回 0 表示仍有效
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -checkend 2592000 -noout
# 响应头与跳转验证
curl -sI https://example.com | head -5
更全面的评级用 testssl.sh --severity HIGH https://example.com 或 SSL Labs 的 API:curl 'https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off'。目标通常是 A 及以上,关键项为 TLS 1.2/1.3 可用、无 RC4/3DES、支持前向保密、HSTS 生效。
续期必须自动化。先演练:certbot renew --dry-run。然后配置定时任务:
# /etc/cron.d/certbot
0 3 * * * root /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'
用 systemd 的系统可执行 systemctl list-timers | grep certbot 确认 timer 已启用。Nginx 的新连接会重新读取证书文件,但 reload 更稳妥;HAProxy 需通过 runtime API 更新;Tomcat 8.5+ 可调用 reloadSslHostConfigs,否则需重启 Connector。最后把“剩余天数”接入监控告警,阈值设 15 天。
常见问题
证书有效期到底是多久,还能买“一年期”吗?
不能买单张一年期公信证书。2020-09-01 起 CA/B 基线要求单张证书最长 398 天,Let’s Encrypt 固定 90 天。市面上说的“一年”是服务商的托管、续期与技术支持服务期,实际证书仍会在 398 天内到期并由服务商或 ACME 客户端重新签发。
通配符证书能覆盖多级子域和裸域吗?
不能。*.example.com 只匹配一级子域,a.example.com 可以,a.b.example.com 不行;它也不包含裸域 example.com。需要同时覆盖时,在 SAN 中额外加上 example.com。
只开放 443 端口、不开放 80 端口,能签发证书吗?
可以,但要走 DNS-01(TXT 记录)或 TLS-ALPN-01(443 端口)。HTTP-01 必须能访问 80 端口的 /.well-known/acme-challenge/ 路径,且该路径不能被强制跳转到 https 或返回 403。
EV 证书现在还会在浏览器地址栏显示公司名称吗?
不会。Chrome 77 起移除了 EV 的绿色地址栏与组织名展示,Safari 也已取消。EV 的当前价值在于更严格的法人核验、合规审计与证书透明度日志中的品牌记录,而不是视觉标识。
更换证书需要重启 Web 服务吗?
Nginx 执行 nginx -t && systemctl reload nginx 即可热加载;Apache 用 graceful 重载;Tomcat 8.5+ 可通过 JMX 调用 reloadSslHostConfigs,否则需重启 Connector 或实例。IIS 在证书更新后重新绑定即可,通常无需重启服务器。
自签证书能用于小程序或 iOS ATS 吗?
不能。小程序与 ATS 都要求受信任 CA 签发的证书,并且服务端必须下发完整证书链(叶子 + 中间证书)。自签证书只能用于内部测试,且需在客户端手动导入信任。