SSL 证书安装配置完整指南:从 CSR 申请到 Nginx/Apache/Tomcat 部署与报错排查
为什么现在必须上 HTTPS:背景与根因
HTTP 是明文协议,请求头、Cookie、表单内容在公网上裸奔,任何经过的节点(公共 Wi-Fi、运营商链路、反向代理)都能读取甚至篡改。常见后果是页面被插入广告脚本、登录态 Cookie 被窃取、下载的安装包被替换。TLS 通过非对称密钥交换协商出会话密钥,再用对称加密(AES-GCM 或 ChaCha20-Poly1305)保护数据,并用证书证明服务端身份,一次性解决机密性、完整性与身份认证三个问题。
从浏览器侧看,Chrome 68 起对所有 HTTP 页面在地址栏标注“不安全”;小程序、Service Worker、地理位置、剪贴板、HTTP/2 与 HTTP/3 都要求在安全上下文(Secure Context)中运行。也就是说 HTTPS 已不是“加分项”,而是大量 Web 能力的前置条件。
证书装了却仍报错,根因几乎都落在 TLS 握手的三条硬性校验上,任一条不满足即失败:①证书链能回溯到一个受信任的根 CA;②证书 SAN 字段覆盖当前访问的域名;③证书在有效期内且未被吊销。生产环境最高频的问题是第①条——服务器只发送了站点证书,没有一并发送中间证书,桌面浏览器有时靠缓存能蒙混过关,而 Java、curl、Android 客户端会直接握手失败。
两个必须更新的时效性事实:公共 CA 签发的证书最长有效期已被限制为 398 天(2020 年 9 月起由 Apple 与 Chrome 强制实施),不要再相信“买一年送一年”的旧说法;Let’s Encrypt 免费证书有效期固定 90 天,必须做自动化续期。另外 Chrome 77 起已移除 EV 证书在地址栏显示公司名称的 UI,EV 的价值只剩品牌背书与更高的保险额度,不再是“地址栏变绿显示公司名”。
证书选型:DV / OV / EV 与单域名 / 多域名 / 通配符对比
选型先看验证等级,再看覆盖范围。验证等级决定签发时长和信任背书,覆盖范围决定你要买几张证书。
| 类型 | 验证内容 | 签发时长 | 浏览器表现 | 适用场景 |
|---|---|---|---|---|
| DV(域名型) | 仅验证域名控制权(DNS TXT / 文件 / 邮箱) | 几分钟到 1 小时 | 锁标识,无组织信息 | 个人站、博客、API、内部系统、小程序后端 |
| OV(企业型) | 核验营业执照、电话、组织真实性 | 1–5 个工作日 | 锁标识,证书详情含组织名 | 企业官网、SaaS 平台、对外门户 |
| EV(增强型) | 最严格的线下/电话核验 | 3–7 个工作日 | 与 DV 相同的锁标识(地址栏不再显示公司名) | 金融、支付、对合规有硬性要求的场景 |
| 覆盖范围 | 示例 | 注意点 |
|---|---|---|
| 单域名 | t.example.com | 默认不含 www 与裸域,需确认是否赠送 |
| 多域名(SAN / UCC) | a.example.com、b.example.net、c.example.org | 通常 5–100 个 SAN 位,加域名按位收费 |
| 通配符 | *.example.com | 只覆盖一级子域,不含 example.com 本身,也不含 a.b.example.com |
实践建议:个人站与中小业务直接上 DV,DV 已能提供与 OV/EV 相同的加密强度;多子域业务优先“裸域 + 通配符”组合;只有需要向第三方证明组织身份或满足合规审计时才上 OV/EV。无论选哪种,都要确认 CA 是否在主流信任库(Mozilla、Apple、Android、Chrome Root Store)中,否则部分安卓机与旧客户端会报 NET::ERR_CERT_AUTHORITY_INVALID。
申请前准备:私钥、CSR 与 DNS 验证的完整命令
证书签发只需要 CSR(含公钥与域名信息),私钥必须自己生成并保管,绝不要上传给任何服务商。推荐 ECDSA P-256,握手更快、密钥更短;兼容老旧客户端(如 Windows Server 2008、部分 Android 4.x)时改用 RSA 2048。
# 1) 生成 ECDSA P-256 私钥并收紧权限
openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key
# 兼容性优先时改用 RSA 2048
# openssl genrsa -out example.com.key 2048
# 2) 生成带 SAN 的 CSR(SAN 必须写全,CN 已不被浏览器采信)
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 3) 提交前自检 CSR
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
域名验证分三种方式,DV 证书最常用 DNS TXT 与 HTTP 文件。DNS 方式需要你在域名解析里新增记录,验证生效可用 dig 直接查权威 NS,避免本地缓存误导:
# 查询 CA 要求添加的 TXT 记录(以实际下发的 host 名为准)
dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _dnsauth.example.com @ns1.your-dns-provider.com
# HTTP 文件验证时确认外网可访问且无跳转
curl -I http://example.com/.well-known/pki-validation/xxxx.txt
签发完成后先核对私钥与证书是否配对、证书链是否完整,再动服务器配置:
# 私钥与证书公钥指纹必须一致
openssl pkey -in example.com.key -pubout -outform der | openssl md5
openssl x509 -in fullchain.pem -pubkey -noout | openssl pkey -pubin -outform der | openssl md5
# 校验证书链:站点证书 + 中间证书能验通
openssl verify -untrusted chain.pem example.com.crt
# 期望输出:example.com.crt: OK
Nginx 部署实操:证书链、跳转、HSTS 与 OCSP Stapling
Nginx 的 ssl_certificate 必须指向“站点证书 + 中间证书”的完整链文件(fullchain.pem),只填站点证书会导致 Android、Java、curl 报 unable to get local issuer certificate。CA 通常打包提供 fullchain,若只给了两个文件,可手动拼接(顺序不能反):
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -untrusted intermediate.crt fullchain.pem
完整 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/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: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;
resolver 223.5.5.5 1.1.1.1 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
location / {
root /var/www/html;
try_files $uri $uri/ /index.html;
}
}
上线顺序很重要:先 nginx -t 语法检查,再 nginx -s reload 平滑重载,不要直接 restart 造成连接中断。HSTS 首次上线建议先用 max-age=300 灰度,确认全站子域都支持 HTTPS 后再提到 31536000,否则一旦某个子域只有 HTTP,用户会被锁在打不开的页面上。OCSP Stapling 需要服务器能出网访问 CA 的 OCSP 地址,内网隔离环境可先关闭,否则握手会因等待超时而变慢。
Apache、Tomcat 与 IIS 的配置示例
Apache 2.4.8 之后不再需要 SSLCertificateChainFile,把 SSLCertificateFile 指向 fullchain.pem 即可;老版本则必须单独指定链文件,否则同样出现链不完整问题。
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache < 2.4.8 才需要下面这行
# SSLCertificateChainFile /etc/httpd/ssl/chain.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Tomcat 不接受 PEM,需要转成 PKCS12 再在 server.xml 中引用。转换时务必用 -CAfile 把中间证书一起打包,否则 Java 客户端会抛 PKIX path building failed:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out example.com.p12 -name tomcat -CAfile chain.pem -caname root
# server.xml
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true'>
<SSLHostConfig>
<Certificate certificateKeystoreFile='/opt/tomcat/conf/example.com.p12'
certificateKeystorePassword='你的密码'
certificateKeystoreType='PKCS12' type='RSA'/>
</SSLHostConfig>
</Connector>
IIS 走图形化:导入含私钥的 .pfx → 站点“绑定”新增 https/443 → 勾选“需要服务器名称指示(SNI)”。多站点共用 443 时 SNI 必勾,否则只有第一个绑定生效。命令行核对绑定是否成功:
netsh http show sslcert
# 关注 IP:port、Certificate Hash 与 Application ID 是否与目标站点一致
三类服务端的共同点是“链文件要全、私钥权限要严、协议版本要关掉 TLS 1.0/1.1”。Windows 上私钥由证书存储管理,Linux 上建议 chmod 600 并 chown 给运行用户(如 www-data),避免权限过宽被安全扫描扣分。
常见错误排查:从真实报错定位问题
下面这些报错在部署现场出现频率最高,按“报错原文 → 根因 → 处置”对照即可。
| 报错信息 | 根因 | 处置 |
|---|---|---|
nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) |
文件不是 PEM(是 DER/.cer 二进制),或路径写错、文件为空 | openssl x509 -in fullchain.pem -noout -subject 能读出内容才算合格;DER 用 openssl x509 -inform der -in a.cer -out a.pem 转换 |
nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
私钥与证书不配对(重新签发后没换 key,或复制错文件) | 比对两边公钥 md5,必须一致 |
浏览器 NET::ERR_CERT_AUTHORITY_INVALID |
缺中间证书,或用了自签名/私有 CA | 改用 fullchain,用 openssl s_client -showcerts 确认服务端发出 2 张以上证书 |
浏览器 NET::ERR_CERT_COMMON_NAME_INVALID |
SAN 未包含当前域名(常见于漏配 www 或泛域名不覆盖二级子域) | 重新签发并补齐 SAN |
curl: (60) SSL certificate problem: unable to get local issuer certificate |
服务端未发送中间证书 | 同第 3 条,拼接 fullchain 后 reload |
NET::ERR_CERT_DATE_INVALID |
证书过期、服务器时间偏差,或有效期超过 398 天被浏览器拒绝 | timedatectl 校时;更换符合 398 天规则的新证书 |
Java 客户端 sun.security.validator.ValidatorException: PKIX path building failed |
服务端链不完整,或客户端信任库缺根 CA | 补全链;必要时用 keytool 导入根证书 |
定位链问题的第一把工具永远是 s_client,它模拟真实握手并打印服务端实际发送的证书列表:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 输出中应看到至少两张证书:站点证书 + 中间证书;verify return code: 0 (ok)
# 查看有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -dates -subject -ext subjectAltName
另一个高频问题是“证书没问题但页面仍提示不安全”,那是混合内容(Mixed Content):HTTPS 页面里引用了 http 的图片、JS 或接口。控制台会明确打印 Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure element 'http://example.com/logo.png',把所有资源改成相对协议或 https,并加 Content-Security-Policy: upgrade-insecure-requests 兜底。
效果验证与证书自动续期
配置完成后不要只看浏览器绿锁,按下面四条命令逐项验收,覆盖协议版本、跳转、HSTS 与到期时间。
# 1) 80 端口应 301 到 https
curl -I http://example.com
# 2) HTTPS 正常返回 200,且证书校验通过(不加 -k)
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com
# 3) 确认 TLS 1.0/1.1 已被拒绝(应握手失败)
openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null
# 4) 确认 HSTS 头已下发
curl -sI https://example.com | grep -i strict-transport-security
到期时间是运维最容易忽略的一环。公共 CA 证书最长 398 天,Let’s Encrypt 只有 90 天,靠人肉记忆必然出事,务必用 systemd timer 或 cron 自动续期,并配置 reload 钩子让服务真正加载新证书:
# 手动演练一次,确认续期链路通畅
certbot renew --dry-run
# 查看系统自带的续期定时器
systemctl list-timers | grep certbot
# 或使用 cron:每天凌晨 3 点检查,仅在续期成功时 reload
0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'
# 监控脚本:剩余天数少于 21 天即告警
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -checkend 1814400 || echo '证书即将到期' | mail -s 'SSL 告警' ops@example.com
最后用 Qualys SSL Labs 或 testssl.sh 做一次外部扫描,目标等级 A 及以上。常见扣分项:仍开启 TLS 1.0/1.1、使用 RC4/3DES、未开启 OCSP Stapling、证书链冗余。证书更换后记得同步更新 CDN、负载均衡、WAF 上的证书,否则回源正常但边缘节点仍是旧证书。
常见问题
SSL 证书现在还能买一年有效期吗?
不能。2020 年 9 月起,Apple 与 Chrome 强制要求公共 CA 签发的证书有效期不超过 398 天,主流 CA 已全部按此执行。所谓“买多年”只是把多年的签发次数打包计费,实际仍是分段签发、分段到期。Let’s Encrypt 等免费 CA 固定 90 天,更必须做自动化续期。
一张证书能同时保护多个域名吗?
可以。多域名证书(SAN/UCC)可在一个证书里放多个域名,通常 5–100 个位置,加域名按位收费。通配符证书 *.example.com 只覆盖一级子域,不包含裸域 example.com,也不覆盖 a.b.example.com,实践中一般用“裸域 + 通配符”两张证书或一张含两个 SAN 的证书解决。
服务器迁移或重装后证书怎么搬?
需要搬的是三个文件:私钥 example.com.key、站点证书、中间证书(或合并好的 fullchain.pem)。复制后立刻 chmod 600 并把属主改为 Web 运行用户,再用 openssl 比对公钥 md5 确认配对,最后重新配置 server 块并 reload。不要在新机器上重新生成私钥去配旧证书,那必然触发 key values mismatch。
部署完证书,浏览器仍提示“不安全”是怎么回事?
按概率排序:一是混合内容,页面里还有 http 资源,看控制台 Mixed Content 提示;二是跳转没覆盖全,部分页面仍走 http;三是 CDN 或负载均衡上的证书没同步更新,回源正常但边缘节点是旧证书;四是访问的域名不在 SAN 里(比如只签了 www 却访问裸域)。用 openssl s_client -showcerts 看服务端实际发出的证书可快速排除后两种。
免费 DV 证书和付费 DV 证书差别在哪?
加密强度完全一致,都是同等位数的密钥与相同的 TLS 协议。差别在有效期长度(免费通常 90 天)、保险赔付额度、是否提供人工技术支持、是否支持多域名与通配符、以及 OCSP/CRL 的稳定性。生产环境若追求省心可选付费 DV,若已有自动化运维能力,Let’s Encrypt 完全够用。
EV 证书还能让地址栏显示公司名称吗?
不能。Chrome 77 起已移除 EV 证书在地址栏的差异化 UI,所有 HTTPS 站点统一显示锁标识,公司名称只能在证书详情里查看。EV 现在的价值是更严格的线下核验、品牌背书和更高的保险额度,适合金融、支付等有合规要求的场景,不要为“地址栏变绿”买单。