跳到主要内容
ssl证书按装

SSL/TLS 证书配置与 HTTPS 部署实战指南:从 CSR 生成到排错验证

SSL/TLS 证书配置与 HTTPS 部署实战指南:从 CSR 生成到排错验证 — SSL/TLS 证书配置与 HTTPS 部署实战指南:从 CSR 生成到排错验证

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

HTTP 协议以明文传输,从浏览器到源站之间的任意节点(公共 WiFi、运营商链路、代理服务器)都能读取甚至篡改内容。这正是页面被插入广告、登录表单被劫持、下载包被替换的根本原因。HTTPS 在 TCP 之上叠加 TLS 层,提供三项能力:身份认证(确认访问的是真实服务器而非镜像站)、数据加密(防止链路窃听)、完整性校验(防止传输中被改写)。

推动 HTTPS 成为标配的还有几条硬性约束:Chrome、Edge、Safari 已将 HTTP 页面标记为「不安全」;搜索引擎对 HTTPS 站点优先抓取与收录;苹果 ATS 要求 iOS 应用网络请求默认走 HTTPS;微信小程序、支付宝及各大开放平台的回调地址均强制 HTTPS。没有 HTTPS 的网站在可用性、SEO、用户信任三个维度同时失分。

但「买了证书装上去」并不等于完成部署。实际排障中,绝大多数 HTTPS 故障集中在四类根因:证书链不完整(只部署站点证书、缺中间证书,导致 Android、Java 客户端报错)、域名不匹配(只签了裸域,未覆盖 www 或子域)、协议与套件过旧(仍启用 TLS 1.0/1.1、RC4、3DES,被现代浏览器拒绝握手)、混合内容(页面里仍写死 http:// 的图片、JS、CSS)。下文按「选型 → 生成 CSR → 部署 → 排错 → 验证」给出可直接执行的完整方案。

二、证书选型与有效期新规(398 天 / 90 天)

先纠正两个高频过时认知。第一,公网信任的 SSL/TLS 证书最长有效期自 2020 年 9 月 1 日起被 CA/Browser Forum 限制为 398 天,所谓「买三年一次装好」的方案已不存在——三年期产品通常是一次签发加两次免费重签,仍需按 398 天周期更换。第二,Let’s Encrypt 签发的免费证书有效期固定为 90 天,必须依赖 ACME 自动续期,不能人工一年一换。

按验证强度分为三档:DV(域名验证)只校验域名控制权,通常 10 分钟内自动签发;OV(组织验证)需核验营业执照等工商信息,一般 1–3 个工作日;EV(扩展验证)审核最严,需电话回拨核验企业真实性(座机、114、DUNS、百度信用登记的企业电话均可),浏览器地址栏的绿色公司名展示已在 Chrome 77 之后取消,EV 现在的价值主要体现在金融、支付、医疗类合规要求上。

域名覆盖方式上:单域名证书只保护一个 FQDN;多域名 SAN 证书可在一张证书里写多个不同域名;通配符证书(*.example.com)覆盖同一级所有子域,但不覆盖 example.com 本身,也不覆盖 a.b.example.com。因此「example.com + *.example.com」的 SAN 组合是最常见的企业配置。

三、第一步:生成私钥与 CSR(命令可直接执行)

CSR(证书签名请求)包含公钥与主体信息,私钥必须留在自己服务器上,绝不能发给任何人。下面命令生成 2048 位 RSA 私钥和带 SAN 的 CSR:

mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj "/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
chmod 600 example.com.key

若使用 ECDSA(握手更快、证书包更小,TLS 1.3 下推荐):

openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj "/CN=example.com" -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

提交前务必自检三件事。其一,确认 SAN 正确(现代浏览器只看 SAN,不看 CN):openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"。其二,CSR 与私钥必须配对:openssl req -in example.com.csr -noout -verify -key example.com.key,返回 verify OK 才算通过。其三,CSR 一旦签发就不可修改域名,写错只能重新签发。

拿到证书后通常有 example.com.crt(站点证书)、chain.crt(中间证书)、example.com.key。部署应使用合并后的 fullchain:

cat example.com.crt chain.crt > fullchain.pem
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5   # 两行 md5 必须一致

四、Nginx 完整配置示例(含 HSTS 与 OCSP Stapling)

把证书放到 /etc/nginx/ssl/ 后,用以下配置替换站点文件。listen 80 的 server 块负责 301 跳转,listen 443 的 server 块承载 TLS:

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_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;
    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;
    add_header X-Content-Type-Options nosniff always;

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

几个易踩的坑:ssl_certificate 必须指向 fullchain(站点证书在前、中间证书在后),只写站点证书会导致 Java、Android 客户端报证书链不完整;ssl_trusted_certificate 供 OCSP Stapling 校验用,指向 chain 即可,不要指向 fullchain;HSTS 一旦下发,浏览器会在 max-age 秒数内强制走 HTTPS,上线初期建议先用 max-age=300 验证,确认全站无 HTTP 资源后再放大到 31536000。改完执行 nginx -t && nginx -s reload。

五、Apache 与 Tomcat 配置示例

Apache(httpd)需要 mod_ssl 模块,配置写在 /etc/httpd/conf.d/ssl.conf:

<VirtualHost *:80>
    ServerName example.com
    Redirect permanent / https://example.com/
</VirtualHost>

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.crt
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLCertificateChainFile /etc/httpd/ssl/chain.crt
    SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
    SSLHonorCipherOrder     off
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

改完用 httpd -t 检查语法,再 systemctl reload httpd。注意 Apache 2.4.8 之后 SSLCertificateChainFile 已废弃,可把链证书直接追加到 SSLCertificateFile 指向的文件末尾。

Tomcat 使用 PKCS12 密钥库,先转换:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -name tomcat -out example.p12

再修改 conf/server.xml:

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           maxThreads="200" SSLEnabled="true" scheme="https" secure="true">
  <SSLHostConfig protocols="TLSv1.2,TLSv1.3">
    <Certificate certificateKeystoreFile="/opt/tomcat/conf/example.p12"
                 certificateKeystorePassword="changeit"
                 certificateKeystoreType="PKCS12" />
  </SSLHostConfig>
</Connector>

若使用云负载均衡或 CDN,则无需在服务器上装证书,直接在控制台上传「公钥证书 + 私钥」或「证书 + 链证书」两段内容,回源协议按需选 HTTPS 或 HTTP。

六、证书类型与部署方式对比表

选型时按「验证强度 + 域名覆盖 + 部署位置」三个维度决策,下表可直接对照:

证书类型 验证内容 签发时长 有效期上限 典型场景
DV 域名型 DNS 或文件验证域名控制权 10 分钟–2 小时 398 天 个人站、博客、测试环境
OV 企业型 营业执照 + 工商信息核验 1–3 个工作日 398 天 企业官网、电商、SaaS
EV 扩展型 严格企业核验 + 电话回拨 3–7 个工作日 398 天 金融、支付、医疗合规
免费证书 ACME 自动域名验证 1–5 分钟 90 天 中小站点、内部系统
部署位置 证书安装点 优点 注意点
自建 Nginx/Apache /etc/nginx/ssl/ 完全可控、可配 OCSP 需自行续期与到期监控
云负载均衡 控制台上传证书 免运维、支持多后端 到期需重新上传,不会自动同步
CDN 边缘节点 控制台上传证书 就近加速、抗 DDoS 需确认回源协议与回源证书
Kubernetes Ingress tls Secret 与 CI/CD 集成、自动化 Secret 更新后需滚动重启

成本与风险提示:免费证书与付费 DV 在加密强度上完全一致,差别在于有效期(90 天 vs 398 天)、是否提供资金赔付保险、是否有人工技术支持。OV/EV 的溢价主要买的是「企业身份背书」,若站点涉及支付、用户实名信息,建议直接上 OV 及以上。通配符证书在多子域场景下性价比最高,但要评估私钥泄露的爆炸半径——一张 *.example.com 泄露意味着所有子域全部失守,因此私钥权限务必设为 600,且不要放入代码仓库。

七、常见错误与真实报错排查

下面这张表覆盖了 90% 以上的线上 HTTPS 故障,报错信息可直接在浏览器控制台、curl 或 Nginx 错误日志中检索:

报错信息 根因 修复方式
curl: (60) SSL certificate problem: unable to get local issuer certificate 服务器未下发中间证书 改用 fullchain.pem
NET::ERR_CERT_COMMON_NAME_INVALID 证书 SAN 不含当前访问域名 重签含该域名的证书
NET::ERR_CERT_DATE_INVALID 证书过期或服务器时间偏差 续期 / 校准 NTP
SSL_ERROR_BAD_CERT_DOMAIN(Firefox) 访问域名与证书不匹配 同上,补 SAN 或改跳转域名
nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 证书与私钥不配对 用 modulus md5 比对后重配
nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) 证书文件格式错误或把 .key 当证书 检查文件头是否为 BEGIN CERTIFICATE
AH01909: server certificate does NOT include an ID which matches the server name Apache ServerName 与证书域名不一致 改 ServerName 或换证书
Mixed Content: The page at ‘https://…’ was loaded over HTTPS, but requested an insecure element ‘http://…’ 页面写死 http:// 资源链接 改为相对协议或全站 https

定位证书链问题最快的命令是:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
curl -vI https://example.com 2>&1 | grep -Ei "SSL|subject|issuer|expire"

如果 -showcerts 只输出 1 张证书,说明服务器没下发中间证书,必须补全链。混合内容问题不是配置错误,而是程序里写死了 http:// 调用,需联系开发把模板、数据库、富文本中的 http 链接统一改成 https 或 // 相对协议,同时在响应头加 Content-Security-Policy: upgrade-insecure-requests 兜底。此外若报连接超时而非证书错误,先查 443 端口是否被防火墙/安全组拦截:telnet example.com 443。

八、效果验证与自动续期

配置完成后必须逐项验证,不能只看浏览器绿锁:

# 1. 查看证书主体、签发者、有效期、SAN
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

# 2. 验证 TLS 1.0/1.1 已被禁用(应握手失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null

# 3. 验证 80 端口强制跳转
curl -I http://example.com

# 4. 验证 HSTS 头是否下发
curl -sI https://example.com | grep -i strict-transport-security

# 5. 判断证书是否在 30 天内过期
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -checkend 2592000 && echo "30 天内不会过期"

Let’s Encrypt 证书(90 天)必须配置自动续期,先干跑验证:

certbot renew --dry-run
echo "0 3 * * * root /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'" > /etc/cron.d/certbot

商业证书没有自动续期,建议加一个到期监控脚本:

#!/bin/bash
DAYS=$(( ( $(date -d "$(openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -enddate | cut -d= -f2)" +%s) - $(date +%s) ) / 86400 ))
[ $DAYS -lt 30 ] && echo "证书剩余 $DAYS 天" | mail -s "SSL 到期告警" ops@example.com

最后用 SSL Labs 或 MySSL 做一次外部体检,目标评级 A 及以上,重点看三项:Certificate Chains(证书链是否完整)、Protocol Support(是否残留 TLS 1.0/1.1)、Key Exchange(是否支持前向保密)。评级低于 A 时,优先补 HSTS、关掉 TLS 1.1、启用 TLS 1.3。

常见问题

公网信任证书自 2020 年 9 月 1 日起最长有效期为 398 天,含到期当天。Let’s Encrypt 免费证书固定 90 天,必须用 ACME 自动续期。所谓三年期产品是一次签发加两次免费重签,仍需按 398 天周期更换。

这是混合内容问题,不是证书配置错误。页面里仍写死了 http:// 的图片、JS、CSS 链接,浏览器会拦截。需把模板、数据库、富文本中的链接改为 https:// 或 // 相对协议,并加 CSP upgrade-insecure-requests 兜底。

单域名证书只保护一个 FQDN;多域名 SAN 证书可在一张证书里写多个不同域名,常见上限 100 个;通配符证书覆盖同一级所有子域。企业常用「example.com + *.example.com」的 SAN 组合。

不能。*.example.com 只匹配 a.example.com 这类同级子域,不匹配 example.com 本身,也不匹配 a.b.example.com 二级子域。因此通配符证书通常要和主域一起写进 SAN 字段。

加密强度完全一致,都是 2048 位 RSA 或 ECDSA。差别在有效期(90 天 vs 398 天)、是否提供资金赔付保险、是否有人工技术支持、是否支持 OCSP 与多域名。生产环境建议至少配自动续期监控。

浏览器可能因为缓存了中间证书而显示正常,但 Android 原生请求、Java 客户端、curl 会直接报 unable to get local issuer certificate。修复方法是将站点证书与中间证书合并成 fullchain.pem 后重新加载。

内容审核

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