HTTPS 证书配置与 SSL 安装全流程实战:从 CSR 生成到握手验证
一、问题背景与根因:证书“装上了”,为什么浏览器仍报不安全
SSL/TLS 协议位于 TCP/IP 传输层与 HTTP、SMTP 等应用层协议之间,由两层构成:SSL 记录协议(Record Protocol)建立在可靠传输之上,负责数据封装、压缩与加密;SSL 握手协议(Handshake Protocol)建立在记录协议之上,在真正传输数据前完成身份认证、加密套件协商与密钥交换。它对外提供三项服务:认证服务器身份、加密数据防窃听、校验数据完整性防篡改。
在实际运维中,“HTTPS 配置失败”几乎都不是协议本身的问题,而是下面五类根因:
- 证书链不完整:只上传了域名证书,漏掉中间 CA。桌面 Chrome 会通过 AIA 自动补链所以看着正常,但 Android、微信内置浏览器、Java/Python 客户端会直接报
unable to get local issuer certificate。 - 私钥与证书不匹配:证书续签后只换了 crt 没换 key,Nginx 直接起不来。
- 域名不匹配:申请时 SAN 只写了
example.com,用户访问www.example.com即报错。 - 协议与套件过旧:仍开启 TLS 1.0/1.1,而主流浏览器自 2020 年起已全面弃用,握手直接失败。
- 混合内容(Mixed Content):页面本身是 HTTPS,但内部仍以
http://引用图片、JS、CSS。
定位第一步永远是一条命令,看三处关键输出:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
重点看 Verify return code(必须为 0,非 0 即链不完整)、subject= 与 issuer= 是否对得上、以及服务器返回了几张证书(正常应为 2 张以上:站点证书 + 中间 CA)。同时确认服务器时间准确(date -u),系统时间偏差超过证书 notBefore/notAfter 也会导致校验失败。把这三项排除后,90% 的“证书有问题”都能当场定位。
二、证书选型与 CSR 生成:把错误挡在签发之前
先明确两个硬性事实:自 2020 年 9 月起,公有 CA 签发的 TLS 证书最长有效期被限制为 398 天;CA/Browser Forum 已通过分阶段缩短方案——2026 年 3 月 15 日起降至 200 天,2027 年 3 月 15 日起 100 天,2029 年 3 月 15 日起 47 天。Let’s Encrypt 免费证书有效期固定为 90 天,必须依赖 ACME 自动续期,人工续期必然出事故。
生成私钥与 CSR(OpenSSL 1.1.1+ 支持 -addext,旧版本需写配置文件):
openssl genrsa -out example.com.key 2048
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"
对性能敏感的场景可改用 ECDSA P-256,握手更快、证书更小:
openssl ecparam -genkey -name prime256v1 -out example.com.key
提交前必须自检两件事。第一,SAN 是否写全:
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
openssl req -in example.com.csr -noout -verify
第二,拿到签发证书后校验私钥与证书是否配对,这一步能避免 80% 的部署事故:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两行输出的 MD5 必须完全一致,否则说明 key 与 crt 不是一对。另外,私钥文件权限务必收紧为 chmod 400 example.com.key,属主设为运行 Web 服务的账号(Nginx 为 root 或 www-data),切勿放在网站根目录下。
三、Nginx 完整实操:合并证书链、部署与重载
CA 通常会下发两个文件:example.com.crt(站点证书)与 intermediate.crt 或 ca_bundle.crt(中间 CA)。Nginx 的 ssl_certificate 指令要求站点证书在前、中间证书在后,顺序错了会直接报链错误。合并并验证:
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -untrusted intermediate.crt example.com.crt
# 期望输出:example.com.crt: OK
上传到固定目录并收紧权限:
sudo mkdir -p /etc/nginx/ssl
sudo cp fullchain.pem example.com.key /etc/nginx/ssl/
sudo chmod 400 /etc/nginx/ssl/example.com.key
sudo chmod 444 /etc/nginx/ssl/fullchain.pem
写入站点配置(注意 Nginx 1.25.1 起推荐用独立的 http2 on;,旧版本写作 listen 443 ssl http2;):
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_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;
root /var/www/html;
index index.html;
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
校验语法并平滑重载,reload 不会中断现有连接,不要用 restart:
sudo nginx -t
sudo systemctl reload nginx
若 nginx -t 报 SSL_CTX_use_PrivateKey_file() failed (SSL: ... key values mismatch),说明 key 与证书不配对,回到第二节用 modulus 对比排查;若报 cannot load certificate ... No such file or directory,多为 SELinux 拦截,需执行 chcon -t httpd_sys_content_t /etc/nginx/ssl/*。
四、Apache 配置、强制跳转与 HSTS/OCSP 加固
Apache 2.4.8 之后不再需要 SSLCertificateChainFile,把中间证书拼在 SSLCertificateFile 指向的 fullchain 里即可,继续使用旧指令会告警甚至不生效:
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/html
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES:!RC4
SSLHonorCipherOrder off
SSLSessionTickets off
</VirtualHost>
<VirtualHost *:80>
ServerName example.com
ServerAlias www.example.com
Redirect permanent / https://example.com/
</VirtualHost>
检查与重载:sudo apachectl configtest(或 httpd -t),然后 sudo systemctl reload httpd。
在 Nginx 侧追加 HSTS 与 OCSP Stapling,可减少一次客户端下载 CRL 的往返:
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;
resolver_timeout 5s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
两个坑要记住:其一,ssl_trusted_certificate 必须指向根 CA + 中间 CA 的完整链(不能是 fullchain),否则日志报 [warn] "ssl_stapling" ignored, issuer certificate not found for certificate;其二,HSTS 一旦下发,浏览器会在 max-age 内强制走 HTTPS,先确认全站(含子域名)已具备 HTTPS 能力,再上线 includeSubDomains 与 preload。
五、选型对比表格:证书类型、有效期与协议版本
下表用于在采购与配置阶段快速决策,避免“买了通配符却覆盖不到二级域名”这类返工。
| 类型 | 验证内容 | 签发时长 | 浏览器地址栏 | 适用场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权(DNS/HTTP 文件) | 分钟级 | 锁标志 | 博客、内部系统、API 网关 |
| OV 组织型 | 额外核验企业工商信息 | 1–3 工作日 | 锁标志 | 企业官网、电商 |
| EV 扩展型 | 最严格的主体核验 | 3–7 工作日 | 锁标志(主流浏览器已不再显示公司名) | 金融、支付 |
| Let’s Encrypt | DV,ACME 自动签发 | 秒级 | 锁标志 | 可自动化续期的所有站点 |
| 覆盖范围 | 示例 | 说明 |
|---|---|---|
| 单域名 | example.com | 不含 www,需单独加 SAN |
| 多域名 SAN | example.com + api.example.com | 通常 5–100 个域名额度 |
| 通配符 | *.example.com | 只覆盖一级子域,不含 example.com 本身,也不含 a.b.example.com |
| 协议版本 | 状态 | 建议 |
|---|---|---|
| SSLv3 / TLS 1.0 / TLS 1.1 | 已被主流浏览器弃用 | 必须关闭 |
| TLS 1.2 | 广泛兼容 | 保留,作为兼容下限 |
| TLS 1.3 | 1-RTT 握手,默认前向安全 | 优先启用 |
补充两点:证书最长有效期 398 天是公有 CA 的硬约束,私有 CA 不受此限但浏览器不信任;续期方式上,398 天证书靠人工日历提醒,90 天 Let’s Encrypt 必须配 certbot renew --dry-run 加定时任务,切勿混用两套流程。
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
六、常见错误排查:真实报错与对应处置
下面每一条都是线上高频报错,按“报错原文 → 根因 → 处置命令”组织。
1)curl: (60) SSL certificate problem: unable to get local issuer certificate
根因:服务端未下发中间证书。处置:重新合并 fullchain 后 reload,用 openssl s_client -connect host:443 -showcerts 确认返回证书条数 ≥2。
2)nginx: [emerg] SSL_CTX_use_PrivateKey_file(“/etc/nginx/ssl/example.com.key”) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
根因:私钥与证书不配对。处置:用第二节的 modulus MD5 对比,重新导出匹配的 key。
3)AH01909: www.example.com:443:0 server certificate does NOT include an ID which matches the server name
根因:Apache 的 ServerName/ServerAlias 与证书 SAN 不一致。处置:补齐 SAN 或修正 ServerAlias,二者必须严格一致。
4)浏览器 NET::ERR_CERT_AUTHORITY_INVALID / NET::ERR_CERT_COMMON_NAME_INVALID
根因:前者为链不完整或用了自签证书,后者为域名不匹配。处置:openssl s_client ... | openssl x509 -noout -subject -issuer -dates 逐项核对。
5)Firefox SSL_ERROR_BAD_CERT_DOMAIN 或 MOZILLA_PKIX_ERROR_MITM_DETECTED
根因:访问域名不在 SAN 中,或中间设备替换了证书。处置:检查是否被 CDN/WAF 回源覆盖,以及是否漏配 SNI。
6)Chrome 控制台 Mixed Content: The page at ‘https://…’ was loaded over HTTPS, but requested an insecure element ‘http://…’
根因:页面内硬编码 http 资源。这正是“配置后页面错乱”的真正原因,与证书安装无关。处置:全局替换为相对协议或 https,并加 Content-Security-Policy: upgrade-insecure-requests 作为兜底。
7)ERR_SSL_PROTOCOL_ERROR
根因:协议或端口不匹配,如把 HTTPS 配在非 443 端口、或客户端只支持 TLS 1.2 而服务端仅开 1.3。处置:openssl s_client -connect host:443 -tls1_2 逐版本测试,确保 ssl_protocols TLSv1.2 TLSv1.3; 同时开启。
七、效果验证:五条命令确认配置真正生效
配置重载不等于生效,必须做闭环验证。以下命令可直接复制执行。
① 证书信息与有效期(剩余天数低于 30 天应触发告警):
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
② 证书链完整性(Verify return code: 0 (ok) 才算通过):
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>&1 | grep -E "Verify return code|depth="
③ 强制跳转是否生效:
curl -sI http://example.com | head -3
# 期望:HTTP/1.1 301 Moved Permanently / Location: https://example.com/
④ 协议与套件扫描(确认 TLS 1.0/1.1 已被拒绝):
nmap --script ssl-enum-ciphers -p 443 example.com
openssl s_client -connect example.com:443 -tls1_1 </dev/null 2>&1 | grep -i alert
⑤ HSTS 与 OCSP 状态:
curl -sI https://example.com | grep -i strict-transport-security
openssl s_client -connect example.com:443 -status </dev/null 2>&1 | grep -A2 "OCSP Response Status"
建议再跑一次外部评级(Qualys SSL Labs 或 testssl.sh),目标为 A 及以上。同时把上述①写成定时脚本,每天检查剩余有效期并通过告警通道推送;对于 Let’s Encrypt,另加 certbot renew --dry-run 的每周演练。最后别忘了验证移动端:用手机 4G 网络而非公司 Wi-Fi 访问,才能暴露中间证书缺失这类只在部分客户端出现的问题。
常见问题
免费的 Let’s Encrypt 证书和付费证书差别大吗,能上生产吗?
技术强度上没有差别:同为 DV 证书,同样采用 RSA 2048/ECDSA P-256 与 SHA-256 签名,浏览器信任链一致。区别在于有效期(90 天 vs 最长 398 天)、是否提供 OV/EV 主体核验、以及是否有商业 SLA 与人工支持。生产环境完全可用,前提是必须配置 ACME 自动续期并加续期失败告警;纯手工续期的 90 天证书不建议用于核心业务。
证书有效期 398 天,是不是每年换一次就行?
不行。398 天是当前公有 CA 的上限,且该上限正在缩短:2026 年 3 月 15 日起降至 200 天,2027 年 3 月 15 日起 100 天,2029 年 3 月 15 日起 47 天。任何依赖“人工记日历”的续期流程都会在政策收紧后失效,正确做法是现在就接入自动化续期与到期监控,把证书当作可轮换的配置项而非一次性资产。
为什么电脑上访问正常,手机上却提示“证书不受信任”?
典型原因是服务端未下发中间证书。桌面 Chrome 支持 AIA(Authority Information Access)自动补链,会自己去下载中间 CA,所以看起来正常;而 Android、微信内置浏览器、iOS 部分场景以及 Java/Python 客户端不做这个补链动作,直接判定链不完整。处置方法是把站点证书与中间证书合并成 fullchain.pem,并用 openssl s_client -connect host:443 -showcerts 确认返回证书条数不少于 2 张。
配置 HTTPS 后网站样式错乱、图片不显示,是证书装错了吗?
不是。这是混合内容问题:页面通过 HTTPS 加载,但内部仍以 http:// 硬编码引用图片、JS、CSS,浏览器出于安全策略拦截了这些资源。打开开发者工具的 Console 会看到 Mixed Content 警告。处置方式是把模板与数据库中的 http 链接批量替换为 https 或相对协议,并临时加 Content-Security-Policy: upgrade-insecure-requests 响应头兜底。这属于程序层调整,与证书安装无关。
一张证书能给多个域名用吗?通配符证书覆盖哪些域名?
可以。多域名证书通过 SAN 扩展承载多个域名,常见额度为 5 到 100 个;通配符证书 *.example.com 只覆盖一级子域,例如 www.example.com、api.example.com,但不覆盖 example.com 主域本身,也不覆盖 a.b.example.com 这样的二级子域。因此实际部署时常采用“通配符 + 主域 SAN”的组合,或直接使用多域名证书覆盖跨域场景。
启用 TLS 1.3 和 OCSP Stapling 会让网站变慢吗?
不会,反而更快。TLS 1.3 将握手压缩到 1-RTT(会话恢复可 0-RTT),且只保留前向安全的密钥交换算法;OCSP Stapling 由服务端缓存并下发吊销状态,省掉客户端自行下载 CRL 的一次往返。需要注意的是启用 TLS 1.3 后 ssl_ciphers 不再作用于它(该指令只影响 TLS 1.2 及以下),若需限定 TLS 1.3 套件要使用 ssl_conf_command Ciphersuites ...;同时 ssl_trusted_certificate 必须指向包含根 CA 与中间 CA 的完整链,否则 OCSP Stapling 会静默失效。