跳到主要内容
ssl证书按装

HTTPS 配置实战:SSL 证书选型、CSR 生成、Nginx 部署、证书链修复与报错排查

HTTPS 配置实战:SSL 证书选型、CSR 生成、Nginx 部署、证书链修复与报错排查 — HTTPS 配置实战:SSL 证书选型、CSR 生成、Nginx 部署、证书链修复与报错排查

一、为什么现在必须上 HTTPS:问题背景与根因

很多站点在 HTTP 下跑得好好的,直到用户反馈浏览器提示「不安全」,或者搜索结果里 HTTPS 站点排到了前面。根因不在证书本身,而在 HTTP 协议的设计:明文传输、无完整性校验、无身份认证。任何处于传输链路的节点——运营商缓存、公共 WiFi 网关、透明代理——都可以往页面里插广告、替换下载包、窃取 Cookie。HTTPS 用 TLS 在 TCP 之上建立加密通道,同时用 CA 签发的证书证明「你访问的确实是这个域名」,才把这三个问题一起补上。

今天推动 HTTPS 的已经不只是安全,而是能力门槛:

  • HTTP/2 在浏览器中只通过 TLS + ALPN 协商(h2),HTTP/3 基于 QUIC 本身强制加密,纯 HTTP 站点拿不到多路复用与 0-RTT。
  • 一批 Web API 只在安全上下文(Secure Context)可用:Service Worker/PWA、Geolocation、getUserMedia(摄像头麦克风)、Clipboard、Web Crypto、Notification。
  • 搜索引擎优先抓取与展示 HTTPS 结果;Chrome、Edge 对含表单的 HTTP 页面直接标注「不安全」。
  • iOS 的 ATS 默认拒绝明文请求;微信小程序、支付宝、银联的支付回调强制 HTTPS。

需要纠正一个常见说法:HTTPS 不能阻止别人复制你的页面做镜像站,它能保证的是传输过程不被篡改、不被劫持。镜像与山寨属于内容与品牌层面,要靠商标、CAA 记录、投诉下架等组合手段处理。另外,HTTPS 只保护「客户端到 TLS 终结节点」这一段,终结在 CDN 或负载均衡时,回源链路是另一段需要单独评估的信任域。

二、上线前的三项前置准备:备案、证书形态与有效期

在敲 openssl 之前先确认三件事,否则后面一定返工。

1)域名备案。服务器放在中国大陆(阿里云、腾讯云、华为云等)时,域名必须先完成 ICP 备案。未备案域名解析到大陆节点后,80/443 访问会被运营商侧拦截,表现为连接超时或跳转提示页——此时你很容易误判成证书问题。备案周期通常 7–20 个工作日,需要主体证件、域名证书、App 核验或幕布拍照。香港及境外节点无需备案,但跨境延迟通常增加 30–150 ms,是否值得要按业务权衡。

2)确定证书形态。一张证书覆盖哪些名字,直接决定采购数量:单域名证书只写一个 FQDN(example.com 与 www.example.com 算两个名字,除非购买多域名 SAN);通配符 *.example.com 只覆盖一级子域,api.example.com 可以,a.b.example.com 不行,example.com 本身也不行,需要额外追加 SAN。

3)有效期与自动化。公共 CA 签发的 TLS 证书单张最长有效期为 398 天(2020 年 9 月起生效);Let’s Encrypt 为 90 天。CA/B 论坛 SC-081 已确定继续缩短:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天。结论只有一个:必须做自动续期与到期监控,不要再靠人工记日历。

另外提前确认:安全组与防火墙放行 443 入方向;服务器时间用 chrony/ntp 同步(时间偏差会导致证书被判无效);私钥目录规划为 /etc/nginx/ssl,目录权限 700、私钥文件 400。

三、生成 CSR 与私钥:可直接执行的 OpenSSL 命令

CSR(Certificate Signing Request)包含公钥与主体信息,私钥必须留在自己服务器上,任何情况下都不要把 .key 发给 CA 或服务商。

# RSA 2048(兼容性最好,默认选择)
openssl req -new -newkey rsa:2048 -sha256 -nodes 
  -keyout /etc/nginx/ssl/example.com.key 
  -out /etc/nginx/ssl/example.com.csr 
  -subj '/C=CN/ST=Beijing/L=Beijing/O=Example Tech/CN=example.com'

# ECDSA P-256(握手更快、包更小,但不支持 XP、Android 4.x 等老客户端)
openssl ecparam -genkey -name prime256v1 -out /etc/nginx/ssl/example.com.ec.key
openssl req -new -sha256 -key /etc/nginx/ssl/example.com.ec.key 
  -out /etc/nginx/ssl/example.com.ec.csr -subj '/CN=example.com'

注意 CN 只能填一个域名,多域名靠 SAN。现在主流 CA 以 SAN 为准,CN 仅作兼容。生成后自检:

openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'

拿到签发证书后,务必验证私钥与证书是否配对,这是线上最高频的事故之一:

openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5   # 两行输出必须完全一致
chmod 400 /etc/nginx/ssl/example.com.key
chown root:root /etc/nginx/ssl/example.com.key

如果是通配符证书,签发时 Common Name 写 *.example.com,同时把 example.com 加入 SAN,否则主域名访问会报名称不匹配。

四、Nginx 完整配置示例:跳转、TLS 1.2/1.3、OCSP 与 HSTS

下面是一份可直接落地的配置,覆盖 80 跳转、现代协议套件、会话复用与 HSTS。

# /etc/nginx/conf.d/example.com.conf
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    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_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;    # TLS 1.3 由客户端选择更优
    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/chain.pem;
    resolver 223.5.5.5 119.29.29.29 valid=300s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;

    root  /var/www/example.com;
    index index.html;
}

执行 nginx -t 通过后 systemctl reload nginx。两点提醒:其一,HSTS 的 preload 参数不要轻易加,一旦提交预加载列表,回退到 HTTP 需要数月,首次上线建议先用 max-age=300 观察一天;其二,Let’s Encrypt 自 2025 年起已停止提供 OCSP 响应、改用 CRL,此时 ssl_stapling 配置无害但无收益,商业 CA 证书仍然有效。需要 RSA + ECDSA 双算法时,重复写两行 ssl_certificate / ssl_certificate_key 即可,Nginx 会按客户端能力自动选择。

五、证书链拼接与 Apache、Tomcat 配置要点

浏览器报「证书不受信任」,八成是证书链不完整——服务器只发了叶子证书,没发中间 CA。拼接顺序是:站点证书 → 中间 CA →(根证书,可省略,客户端本地已有)。

cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt

Apache 2.4.8 及以上:

SSLEngine on
SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# 2.4.8+ 无需 SSLCertificateChainFile;更低版本需单独指向 intermediate.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES

Tomcat 只认 JKS/PKCS12,需要转换:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -name tomcat -out keystore.p12 -passout pass:Changeit123
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true">
  <SSLHostConfig protocols="TLSv1.2,TLSv1.3">
    <Certificate certificateKeystoreFile="conf/keystore.p12"
                 certificateKeystorePassword="Changeit123"
                 certificateKeystoreType="PKCS12" />
  </SSLHostConfig>
</Connector>

JDK 8 早期版本默认不支持 TLS 1.3,建议使用 8u261 以上版本或 JDK 11/17 LTS。另外别忘了 PKCS12 密码不要用 changeit 这类默认值,keystore 文件权限同样要收紧到 400。

六、DV、OV、EV 与单域名、通配符、多域名证书对比

选证书本质是选验证等级与覆盖范围,与加密强度无关——DV 与 EV 用的是同一套 TLS 算法,差别只在身份背书与人工审核成本。

证书类型 验证内容 典型签发时长 有效期 浏览器展示 适用场景
DV 域名型 域名控制权(DNS TXT 或 HTTP 文件) 10 分钟 398 天;Let’s Encrypt 90 天 锁图标 博客、个人站、API、内网测试
OV 组织型 营业执照与组织信息人工核验 1–2 工作日 398 天 锁图标,证书详情显示企业名 企业官网、SaaS、B 端系统
EV 扩展型 企业信息 + 电话回访 + DUNS 或律师函 3–7 工作日 398 天 Chrome 77 起不再显示绿色地址栏,仅详情可见企业全称 金融、支付、大型电商
通配符 同 DV/OV 级别 同级别 同级别 只覆盖一级子域,主域名需另加 SAN 子域数量多且命名固定的业务
多域名 SAN 同 DV/OV 级别 同级别 同级别 单张最多 100 个名字(视 CA 而定) 多品牌、多域名合并管理

成本敏感场景可用免费 DV 证书,配合 acme.sh 全自动签发续期:

curl https://get.acme.sh | sh -s email=ops@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com 
  --webroot /var/www/example.com --keylength ec-256
~/.acme.sh/acme.sh --install-cert -d example.com --ecc 
  --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd 'systemctl reload nginx'

acme.sh 默认会写入 cron 任务,到期前 30 天自动续期;务必用 –install-cert 把证书落到固定路径,否则每次续期目录变化会导致 Nginx 仍加载旧文件。

七、常见错误排查:从报错原文定位问题

以下报错按线上出现频率排序,基本覆盖九成问题。

  • curl: (60) SSL certificate problem: unable to get local issuer certificate:服务器没发中间证书。用 openssl s_client -connect example.com:443 -servername example.com -showcerts 看返回几条证书,只有一条就是缺链,改用 fullchain.pem。
  • NET::ERR_CERT_COMMON_NAME_INVALID:证书 SAN 里没有当前访问域名。常见于拿 www.example.com 的证书跑 example.com,或用通配符证书访问三级域名 a.b.example.com。重新签发并补 SAN。
  • NET::ERR_CERT_DATE_INVALID:证书过期或服务器时间错乱。date -u 与 openssl x509 -noout -dates -in fullchain.pem 对比;容器环境常见宿主机时间不同步。
  • SSL_ERROR_RX_RECORD_TOO_LONG:443 端口上跑的不是 TLS,通常是 Nginx 里漏写 ssl 参数,或 HTTP 服务监听在 443;也可能是企业代理做了 SSL 拦截。
  • nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不匹配,多为续期时只替换了其中一个文件,用第三节的 modulus 比对法确认。
  • Mixed Content:页面能开但地址栏显示不安全:HTML 里仍有 http:// 的图片、JS、CSS。用 grep -rn 'http://' /var/www/example.com 批量排查,并在 CSP 中加 upgrade-insecure-requests。
  • bind() to 0.0.0.0:443 failed (98: Address already in use):端口被占用,ss -lntp | grep :443 定位进程,常见是 httpd 与 nginx 同时启动。
  • ERR_SSL_PROTOCOL_ERROR:协议版本或套件不匹配,多见于只开 TLS 1.3 却遇到老客户端,或 OpenSSL 低于 1.1.1 不支持 TLS 1.3。

八、效果验证:命令行、在线评分与到期监控

改完配置别只看浏览器锁图标,用命令行逐项验证。

# 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_3 </dev/null | grep -E 'Protocol|Cipher'

# 2. 证书链与有效期
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null | openssl x509 -noout -subject -issuer -dates

# 3. 跳转与 HSTS 头
curl -sI http://example.com | head -n 3      # 期望 301 + Location: https://...
curl -sI https://example.com | grep -i strict-transport-security

# 4. 枚举协议与套件
nmap --script ssl-enum-ciphers -p 443 example.com

在线侧用 SSL Labs 跑一次完整评估,目标 A 及以上;评分为 B 通常是仍支持 TLS 1.0/1.1 或启用了 3DES、RC4。再用 HSTS Preload 站点确认响应头格式正确。

监控层面写一个到期巡检脚本挂 cron,提前 21 天告警:

#!/bin/bash
END=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ "$LEFT" -lt 21 ] && echo "证书剩余 ${LEFT} 天" | mail -s '[告警] 证书即将到期' ops@example.com

最后确认全站资源无 http 残留,并检查 CDN、负载均衡、WAF 各层的证书是否同步更新——TLS 在代理层终结时,源站证书过期同样会触发 502 或 526 错误。

常见问题

证书装好后浏览器仍提示不安全,最可能是什么原因?

按概率依次是:证书链不完整(只发了叶子证书)、页面存在混合内容(http:// 资源)、访问的域名不在 SAN 列表中、服务器时间偏差过大。先用 openssl s_client -showcerts 确认链是否完整,再在 DevTools Console 里过滤 mixed content。

通配符证书能覆盖主域名和三级域名吗?

不能。*.example.com 只匹配一级子域,api.example.com 可以,example.com 本身和 a.b.example.com 都不覆盖。要让主域名也生效,签发时把 example.com 作为额外 SAN 加入;三级子域需要单独签发 *.b.example.com 或改用多域名证书。

域名必须完成备案才能申请 SSL 证书吗?

不需要。备案与证书是两件独立的事:CA 只验证域名控制权或组织信息,与备案无关。但服务器放在中国大陆时,未备案域名会被运营商拦截 80/443 访问,导致证书装好了也打不开,所以实际项目里通常先备案、再上线。

免费 Let’s Encrypt 证书和付费 OV 证书差别大吗?

加密强度完全一致,都是 90 天或 398 天的 DV/OV 证书、同样的 TLS 算法。差别在身份背书(OV 会在证书详情显示企业名,利于 B 端信任)、有效期长度、赔付条款与技术支持。个人站和 API 用免费证书完全够用,金融、政企对外站点通常选 OV 或 EV。

证书续期后能不重启 Nginx 就生效吗?

可以,用 systemctl reload nginx 或 nginx -s reload 即可热加载,不中断连接。关键是新证书必须覆盖到配置里引用的同一个路径,reload 只重新读取文件;若续期脚本写到带时间戳的新目录而配置没同步,reload 后加载的仍是旧证书。

用了 CDN 之后证书应该装在哪?

两段都要装。用户到 CDN 边缘节点这一段,使用在 CDN 控制台上传的证书;CDN 回源到源站这一段,源站仍需配置有效证书(或使用 CDN 提供的回源专用证书)。只配其中一段时,常见现象是浏览器正常但回源报 526,或源站正常而边缘节点证书过期。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。