跳到主要内容
SSL 证书付费服务

SSL 证书 HTTPS 加密安装配置实战:CSR 生成、证书链修复与 Nginx/Apache/Tomcat 部署

SSL 证书 HTTPS 加密安装配置实战:CSR 生成、证书链修复与 Nginx/Apache/Tomcat 部署 — SSL 证书 HTTPS 加密安装配置实战:CSR 生成、证书链修复与 Nginx/Apache/Tomcat 部署

一、为什么“证书装上了”浏览器还是提示不安全

把 SSL 证书文件复制到服务器、在 Nginx 里写两行 ssl_certificate,这只是 HTTPS 部署的第一步。生产环境中“证书已安装但不生效”的问题,根因集中在四类:证书链不完整、私钥与证书不匹配、域名覆盖范围不符、协议与端口配置错误。

根因一:只部署了叶子证书。CA 签发时通常给你两个文件:域名证书(叶子证书)和中间证书(Intermediate)。浏览器信任的是根证书,需要靠中间证书把叶子证书连接到根证书上。只配置叶子证书时,桌面浏览器有时能靠缓存或 AIA 补链成功,但 Android、微信内置浏览器、Java 客户端、curl、Go 程序会直接报错,典型信息是 unable to verify the first certificate 或 x509: certificate signed by unknown authority。

根因二:证书与私钥不匹配。重新签发证书后只替换了 .crt 文件,没有替换 .key 文件,或者从 A 服务器复制证书、从 B 服务器复制私钥,Nginx 会直接拒绝启动:SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。

根因三:域名覆盖范围不符。CSR 里只写了 example.com,实际访问 www.example.com 就会报 NET::ERR_CERT_COMMON_NAME_INVALID。注意 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 api.test.example.com。

根因四:有效期规则变了。2020 年 9 月起,CA/Browser Forum 与 Apple、Chrome 共同要求公共信任 TLS 证书单次有效期不超过 398 天。过去“买两年、三年”的产品,实际执行方式是首年签发 + 到期前重新签发,运维必须建立续期流程,否则一年后必然大面积报 certificate has expired。

先做一次快速检查,确认服务器实际返回了什么:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"

返回值小于 2,基本可以判定链不完整。再看证书主体与有效期:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates

如果 Subject 里没有你访问的域名、SAN 为空、Not After 已过,接下来的操作方向就非常明确:重新签发或补齐证书链。

二、证书选型:DV/OV、单域名/通配符与 398 天有效期

选型只需要回答三个问题:要保护几个域名、是否需要核验组织身份、能不能接受 90 天续期一次。下表是常见类型对比(价格为参考区间,以实际报价为准):

类型 保护范围 验证方式 签发速度 参考年价 典型场景
DV 单域名 example.com 或 www.example.com 一个 DNS / HTTP / 邮箱 分钟级 约 200 元 单站点、测试环境
DV 通配符 *.example.com(裸域需写入 SAN) DNS-01 5-30 分钟 500-800 元 多子域、SaaS 平台
OV 单域名/通配符 同上,另含组织核验 工商/电话核验 1-3 工作日 数千元 政企、招投标合规
免费 DV(Let’s Encrypt 等) 单域名或多域名、通配符 DNS-01 / HTTP-01 1 分钟 0 元 自动化运维、内部系统

几个容易出问题的细节:

  • 通配符证书的 SAN 必须同时包含 *.example.com 和 example.com,否则裸域访问会报证书错误。下单时要把两个都写进 CSR。
  • 通配符只覆盖一级:*.example.com 匹配 www.example.com、api.example.com,不匹配 a.b.example.com,也不匹配 example.com。
  • OV/EV 的组织信息在浏览器里基本不可见:Chrome、Firefox、Safari 早已移除 EV 绿色地址栏,只保留证书详情中的主体信息。选 OV 的理由是合规与审计,不是 UI 效果。
  • 398 天是硬性上限,任何“两年期/三年期”产品本质都是多次签发,续期动作不会消失。

域名验证方式对比如下,选择哪种直接决定你能不能签通配符:

验证方式 原理 耗时 能否签通配符 适用场景
DNS-01 添加 TXT 记录(_dnsauth / _acme-challenge) 1-10 分钟,受 TTL 影响 可以 无 80 端口、内网、通配符
HTTP-01 根目录放验证文件 分钟级 不可以 有公网 80 端口
邮箱验证 接收 whois 邮箱 数十分钟到数小时 可以 传统商业 CA
文件验证 上传指定文件到网站根目录 分钟级 可以 虚拟主机

三、生成私钥与 CSR,并完成域名所有权验证

CSR(Certificate Signing Request)包含公钥和域名信息,私钥必须留在自己服务器上,任何情况下都不要发给 CA 或服务商。RSA 2048 兼容性最好,OpenSSL 1.1.1 及以上可直接用 -addext 写 SAN:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout 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:*.example.com"

chmod 600 example.com.key
openssl rsa -in example.com.key -check

CentOS 7 自带的 OpenSSL 1.0.2 不支持 -addext,改用配置文件:

cat > req.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = v3_req
prompt = no
[dn]
CN = example.com
O = Example Ltd
C = CN
[v3_req]
subjectAltName = @alt
[alt]
DNS.1 = example.com
DNS.2 = *.example.com
EOF

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -config req.cnf

提交前务必校验 CSR,确认 SAN 没写错:

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

域名所有权验证中,DNS 方式最快。添加记录后用公共 DNS 确认全球生效:

dig +short TXT _dnsauth.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1

HTTP 方式则本地先测通再点验证:

curl -I http://example.com/.well-known/pki-validation/xxxx.txt

邮箱验证只接受 whois 记录或预置的 admin@、administrator@、webmaster@、hostmaster@、postmaster@ 等地址。验证失败三大原因是:80 端口被安全组拦截、CDN 回源未同步、DNS 记录 TTL 未生效就提前点击验证。

四、证书格式与证书链:PEM、PFX、JKS 互转与全链拼接

CA 下发的文件在不同平台叫法不同,本质只有四种格式。搞错格式是“证书装不上”的第二大原因。

格式 常见扩展名 内容 典型用途
PEM .pem .crt .cer .key Base64 文本,可拼接多张证书 Nginx、Apache、Linux
DER .der .cer 二进制 Java 老版本、部分硬件设备
PKCS#12 .pfx .p12 证书 + 私钥 + 链,带密码 IIS、Windows、Tomcat
JKS .jks Java KeyStore Tomcat、WebLogic

PEM 与 DER 互转:

openssl x509 -in example.com.crt -outform DER -out example.com.der
openssl x509 -in example.com.der -inform DER -out example.com.crt

拼接全链,顺序必须是叶子 → 中间 → 根,根证书建议省略:

cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile fullchain.pem example.com.crt
grep -c "BEGIN CERTIFICATE" fullchain.pem

PEM 转 PFX(Windows/IIS 用):

openssl pkcs12 -export -out example.pfx -inkey example.com.key 
  -in example.com.crt -certfile chain.pem -name example.com

PFX 拆回 PEM:

openssl pkcs12 -in example.pfx -nodes -out all.pem
openssl pkcs12 -in example.pfx -nokeys -clcerts -out example.com.crt
openssl pkcs12 -in example.pfx -nokeys -cacerts -out chain.pem

PFX 转 JKS(Tomcat 用):

keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12 
  -destkeystore example.jks -deststoretype JKS 
  -deststorepass changeit -srcalias example.com

注意事项:生产链文件不要带根证书,会增大握手包,部分客户端对多余根证书敏感;私钥权限设为 600,属主为运行服务的用户;替换时保持文件名与路径不变,避免 reload 时因路径错误导致服务不可用。

五、服务器配置示例:Nginx、Apache、Tomcat 与 IIS

Nginx 完整配置,注意 ssl_certificate 必须指向 fullchain.pem,ssl_trusted_certificate 指向不含叶子证书的 chain.pem:

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;
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
nginx -t && systemctl reload nginx

Apache(2.4.8 起可把中间证书直接合并进 SSLCertificateFile):

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/fullchain.pem
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLProtocol -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Tomcat server.xml:

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

IIS 先在 certlm.msc 把 PFX 导入“个人”存储,再在网站绑定中添加 https/443 并勾选“需要服务器名称指示”。命令行绑定可用:

netsh http add sslcert hostnameport=example.com:443 certhash=ABC123... appid={4dc3e181-e14b-4a21-b022-59fc669b0914} certstorename=MY

六、续期与到期监控:398 天规则下的自动化

商业证书续期流程:到期前 30 天提交重签,可复用私钥与 CSR(同私钥重签),也可换新私钥。换私钥更安全,但必须在同一时间窗口内替换证书与私钥,否则 reload 后直接 mismatch。重新签发后仍需完成一次域名验证,DV 证书通常分钟级完成。

免费证书用 ACME 协议自动化,Let’s Encrypt 有效期 90 天,建议每 60 天续期一次。certbot 用法:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
certbot renew --dry-run
systemctl list-timers | grep certbot

acme.sh 更适合通配符与 DNS API 自动化:

curl https://get.acme.sh | sh -s email=ops@example.com
acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali
acme.sh --install-cert -d example.com 
  --key-file       /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.pem 
  --reloadcmd      "systemctl reload nginx"

到期监控是必须项,一条命令即可查剩余时间:

echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem

checkend 返回 0 表示 30 天内不会过期,返回 1 表示即将过期,可直接作为脚本退出码接入告警。批量巡检:

for d in example.com api.example.com; do
  echo -n "$d: "
  echo | openssl s_client -connect $d:443 -servername $d 2>/dev/null | openssl x509 -noout -enddate
done

用 Prometheus 的 blackbox_exporter 时,关注 probe_ssl_earliest_cert_expiry 指标,按 30 天、7 天两级阈值告警即可覆盖绝大多数事故。

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

下表按出现频率排列,报错信息均为线上真实输出:

报错信息 根因 修复动作
NET::ERR_CERT_AUTHORITY_INVALID / unable to verify the first certificate 缺中间证书 ssl_certificate 改为 fullchain.pem
x509: certificate signed by unknown authority(Go、Docker) 同上 同上,并确认链文件顺序
SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074 … key values mismatch) 证书与私钥不匹配 比对 modulus,替换配套私钥
PEM_read_bio_X509:no start line 文件混入说明文字或换行错误 重新导出纯 PEM
certificate has expired 未续期 重签并 reload,检查系统时间
SSL_ERROR_BAD_CERT_DOMAIN SAN 不含当前域名 重签,补 www 或裸域
sslv3 alert handshake failure / wrong version number 协议或端口错配 确认 443 端口、TLS 版本与客户端一致
javax.net.ssl.SSLHandshakeException: PKIX path building failed Java 信任库缺中间证书 导入 chain 到 cacerts

核对证书与私钥是否配套,RSA 证书用 modulus 比对,两个 md5 必须一致:

openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

ECDSA 证书没有 modulus,改用公钥比对:

openssl x509 -in example.com.crt -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

Java 客户端报 PKIX 时,把中间证书导入信任库:

keytool -importcert -alias intermediate -file chain.crt 
  -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit

多域名共用一台服务器时,若客户端不支持 SNI 或 Nginx 未配置 server_name 匹配,会返回默认站点证书,表现为“证书不是这个域名的”。排查时加 -servername 参数复现真实握手。

八、效果验证:从命令行到 SSL Labs

配置完成后不要只看浏览器,按下面的顺序逐项验证。第一步看握手与证书链:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

输出中应看到至少两张证书,且 Verify return code 为 0 (ok)。第二步看协议版本是否按预期启用:

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null

后者应当握手失败,说明 TLS 1.0/1.1 已关闭。第三步看跳转与安全响应头:

curl -sI http://example.com | grep -i location
curl -sI https://example.com | grep -iE "strict-transport-security|server"

第四步枚举加密套件,确认没有 RC4、3DES、CBC 弱套件残留:

nmap --script ssl-enum-ciphers -p 443 example.com
testssl.sh --severity HIGH example.com

第五步检查 OCSP Stapling 是否生效,正常应返回 OCSP Response Status: successful:

openssl s_client -connect example.com:443 -servername example.com -status </dev/null | grep -A2 "OCSP Response Status"

第六步查混合内容,页面里残留的 http:// 资源会让浏览器显示“不安全”:

curl -s https://example.com | grep -o 'http://[^"]*' | head

最后用 SSL Labs 做整体评分,目标为 A 或 A+。若得 B,通常是协议版本过低或未开启 HSTS;若得 T,是证书链不受信任,回到第四节重新拼接 fullchain。验收通过的标准建议定为:链完整、SAN 覆盖全部域名、TLS 1.2/1.3、HSTS 已下发、到期时间已纳入监控。

常见问题

通配符证书能保护 example.com 裸域吗?

不能。*.example.com 只匹配一级子域,如 www.example.com、api.example.com。裸域 example.com 必须在 CSR 的 SAN 中显式写入 DNS:example.com,下单时两个域名一起提交。

为什么买的“两年期证书”只签发了 398 天?

2020 年 9 月起,公共信任 TLS 证书单次有效期上限为 398 天,由 CA/Browser Forum 与主流浏览器共同强制。所谓两年期产品实际是首年签发 + 到期前重新签发,续期动作无法省略,务必把续期纳入运维流程。

换服务器时可以直接复制证书文件吗?

可以复制证书与私钥,但要保证三件事:私钥权限为 600、路径与配置一致、fullchain.pem 与 chain.pem 区分正确。跨环境迁移更推荐重新签发,避免私钥在多台机器留存导致泄露风险。

免费的 Let’s Encrypt 和付费 DV 证书有区别吗?

在浏览器信任层面没有区别,都走同一套根证书体系。差异在有效期(90 天 vs 最长 398 天)、是否提供商业保险与人工支持、验证方式以及是否支持通配符的便捷签发。内部系统与自动化场景用免费证书完全够用。

私钥泄露了怎么办?

立即吊销当前证书并重新签发,同时更换私钥。注意 Let’s Encrypt 已停止 OCSP 服务,吊销状态查询转向 CRL;商业 CA 通常提供吊销入口。吊销后要同步更新所有使用该证书的节点,包括 CDN 与负载均衡。

HTTPS 页面为什么仍提示“部分内容不安全”?

这是混合内容问题:页面里的图片、脚本、样式仍通过 http:// 加载。把资源改为 https:// 或协议相对地址,并在生产环境启用 Content-Security-Policy 的 upgrade-insecure-requests 指令,可彻底消除告警。

内容审核

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