跳到主要内容
HTTPS安装配置

SSL/TLS 证书部署完整指南:CSR 生成、Nginx/Apache/IIS/Tomcat 配置、报错排查与自动续期

SSL/TLS 证书部署完整指南:CSR 生成、Nginx/Apache/IIS/Tomcat 配置、报错排查与自动续期 — SSL/TLS 证书部署完整指南:CSR 生成、Nginx/Apache/IIS/Tomcat 配置、报错排查与自动续期

一、为什么必须部署 SSL/TLS:问题背景与根因

很多文章把 SSL 证书部署描述成“买一个装上就行”的服务,但从工程角度看,它解决的是三个具体问题:传输层明文、服务端身份不可验证、以及现代浏览器与移动平台对安全上下文的强制要求。理解根因,才能解释后面所有配置项为什么必须写。

根因 1:HTTP 明文可被任意篡改。链路中间的运营商、公共 Wi-Fi 网关、透明代理都可以在响应体里插入广告或 JS,这就是常说的“广告劫持”;Cookie 未加 Secure 属性时随明文传输,会话可被直接复制。TLS 通过证书公钥协商出会话密钥,中间人无法解密,也无法伪造签名,从协议层消除这类注入。

根因 2:平台与 API 强制安全上下文。微信小程序 wx.request 只接受 https 域名;iOS 的 ATS(NSAppTransportSecurity)默认拒绝非 TLS 连接,需额外配置例外;Chrome 自 68 起对 HTTP 页面地址栏标注“不安全”;HTTP/2 在浏览器中只通过 TLS + ALPN 协商,HTTP/3 更是基于 QUIC + TLS 1.3;Service Worker、地理位置、摄像头、剪贴板等 Web API 均要求 secure context。没有证书,这些能力直接不可用。

根因 3:证书有效期规则已经变化。这里必须修正原文“默认提供有效期为一年的 SSL 证书”的说法。按 CA/Browser Forum 基线要求,2020-09-01 之后签发的公信证书单张有效期不得超过 398 天,Apple 对超过 398 天的证书在 iOS/macOS 上直接拒绝信任;Let’s Encrypt 的证书固定 90 天。所谓“一年”只是服务商的托管与续期服务期,不等于单张证书有效期。因此部署方案必须包含自动续期,否则 398 天后必然中断。

根因 4:线上故障多数不在签发环节。实际排障中占比最高的是证书链不完整(缺中间证书)、私钥与证书不匹配、多站点未启用 SNI、协议与加密套件过旧,而不是 CA 没签发成功。所以部署的重点是“链、配对、协议”三件事。

二、证书选型:DV / OV / EV 与单域名 / 多域名 / 通配符

选型要同时看两个维度:验证级别(决定审核流程和证书里的 O 字段)和覆盖范围(决定 SAN 列表怎么写)。

验证级别 CA 验证内容 签发时长 浏览器表现 典型场景
DV 域名型 仅域名控制权:DNS TXT、HTTP 文件、CNAME 1-10 分钟 锁标识,证书详情无组织信息 个人站、API、内部系统、小程序后端
OV 企业型 域名控制权 + 工商登记核验(第三方库或电话回访) 1-5 个工作日 锁标识,证书详情可见 O 字段 企业官网、SaaS、B 端门户
EV 增强型 域名 + 严格法人核验,部分 CA 需律师函或邓白氏编码 3-10 个工作日 Chrome 77 起已取消绿色地址栏与公司名展示,Safari 同样移除 金融、支付合规审计场景

原文“EV 证书浏览器地址栏直接显示公司名称”已过时:Chrome 77(2019 年)移除 EV 视觉指示器,Safari 也不再展示。EV 现在的价值主要在合规审计、CT 日志中的品牌可见性与部分行业保险要求,而不是“地址栏变绿”。

覆盖类型 写法示例 覆盖范围 注意
单域名 CN=www.example.com 仅该主机名 example.com 与 www.example.com 视为两个域名
多域名 SAN SAN: a.com, b.com, api.c.com SAN 列表内全部域名 部分 CA 上限 100 个,扩容需重新签发
通配符 CN=*.example.com 仅一级子域 不覆盖 a.b.example.com,也不覆盖裸域 example.com

选型建议:个人站与中小业务直接用 DV,Let’s Encrypt、ZeroSSL 等可免费获取;需要覆盖大量子域时用通配符,但通配符只能走 DNS-01 验证,必须有 DNS API 权限;企业门户按合规要求选 OV。预算有限时优先保证“链完整 + 自动续期”,而不是追求 EV。

三、实操第一步:在服务器本地生成私钥与 CSR

私钥必须在自己控制的机器上生成,不要提交给任何服务商。原文“购买须知”里让用户提供域名管理权限和服务器版本是可以的,但如果对方要求你上传私钥,等于把身份交出去。以下命令可直接执行:

mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com

# RSA 2048,兼容性最好
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
chown root:root example.com.key

# 生成 CSR 并写入 SAN(OpenSSL 1.1.1+ 支持 -addext)
openssl req -new -sha256 -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'

OpenSSL 1.0.2 不支持 -addext,需要改用配置文件:

cat > san.cnf <<'EOF'
[req]
distinguished_name = dn
req_extensions = v3_req
prompt = no
[dn]
CN = example.com
[v3_req]
subjectAltName = @alt
[alt]
DNS.1 = example.com
DNS.2 = www.example.com
EOF
openssl req -new -sha256 -key example.com.key -out example.com.csr -config san.cnf

如需 ECDSA 私钥(TLS 1.3 下握手更快):openssl ecparam -genkey -name prime256v1 -out example.com.key。校验 CSR 内容是否包含 SAN:openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'。

两个常见坑:CN 字段上限 64 字节,超过会报错,长域名请把完整列表放 SAN;CSR 一旦签发就不能再改域名,改域名必须重新生成 CSR 并重新签发。

四、实操第二步:域名验证与签发

DV 证书的验证方式只有三类:HTTP-01(80 端口放文件)、DNS-01(TXT 记录)、TLS-ALPN-01(443 端口)。通配符只能走 DNS-01。先用命令确认环境是否满足:

# HTTP-01:确认 80 端口可达,且 .well-known 路径没有被强制跳转或拦截
curl -I http://example.com/.well-known/acme-challenge/test

# DNS-01:确认 TXT 已生效,换两个公共 DNS 交叉验证
 dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @1.1.1.1

# 检查 CAA 记录,若存在则必须允许签发 CA
dig +short CAA example.com

用 Certbot 申请通配符证书:

certbot certonly --manual --preferred-challenges dns 
  -d example.com -d '*.example.com' 
  --agree-tos -m ops@example.com

商业 CA 的 DV 流程通常是给你一条 _dnsauth 或 _acme-challenge 的 TXT 记录,TTL 建议设 60-600 秒。权威 DNS 多节点同步有延迟,验证前务必用两个不同的递归 DNS 查询确认。若同一域名并发签发多条记录,不要把旧 TXT 删掉再建新的,应保留多值,否则先提交的验证会失败。

常见报错 urn:ietf:params:acme:error:caa 表示 CAA 记录不允许该 CA,解决方式是添加 0 issue 'letsencrypt.org'。签发成功后得到四个文件:cert.pem(叶子证书)、chain.pem(中间证书)、fullchain.pem(叶子+中间,Nginx 用这个)、privkey.pem。顺序不能错:叶子在前,中间在后,绝对不能把根证书拼进去,否则部分客户端会报链错误。

五、配置示例:Nginx / Apache / IIS / Tomcat

Nginx 是最常见的场景,注意 http2 指令在 1.25.1 之后独立成行:

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_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;
    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;
}

执行 nginx -t && systemctl reload nginx。Apache 配置(2.4.8+ 也可把 chain 追加进 SSLCertificateFile,但保留 ChainFile 更清晰):

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

IIS 用 PFX 导入并绑定,务必勾选 SNI(SslFlags 为 1),中间证书要装进“中间证书颁发机构”存储,否则浏览器报链错误:

Import-PfxCertificate -FilePath C:certexample.pfx -CertStoreLocation Cert:LocalMachineMy -Password (ConvertTo-SecureString -String 'PfxPass' -AsPlainText -Force)
New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 -HostHeader example.com -SslFlags 1

Tomcat 8.5+ 直接支持 PEM,无需 JKS:

<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true">
  <SSLHostConfig>
    <Certificate certificateFile="/opt/tomcat/ssl/cert.pem"
                 certificateChainFile="/opt/tomcat/ssl/chain.pem"
                 certificateKeyFile="/opt/tomcat/ssl/example.com.key" type="RSA" />
  </SSLHostConfig>
</Connector>

六、证书格式与部署方式对比

同一个证书在不同平台需要不同封装,搞错格式是最常见的低级故障来源。

格式 内容 适用平台 转换命令
PEM(.pem/.crt/.cer) Base64 文本,可含多张证书 Nginx、Apache、Tomcat 8.5+、HAProxy openssl x509 -in cert.der -inform DER -out cert.pem
DER(.der/.cer) 二进制单证书 Java 部分场景、嵌入式设备 openssl x509 -in cert.pem -outform DER -out cert.der
PFX / PKCS#12 私钥 + 叶子 + 链,带密码 IIS、Windows、Java openssl pkcs12 -export -out example.pfx -inkey example.com.key -in fullchain.pem -certfile chain.pem
JKS Java KeyStore Tomcat 7 及更早、老版 WebLogic keytool -importkeystore -srckeystore example.pfx -srcstoretype PKCS12 -destkeystore example.jks -deststoretype JKS

部署方式上,手工粘贴 PEM 适合单机少量站点;PFX 适合 Windows 体系;大规模环境推荐统一在入口层(Nginx/HAProxy/云 LB)终止 TLS,后端走内网 HTTP,这样证书只在一处续期。ACME 客户端 + deploy-hook 自动重载是当前主流做法,可以彻底避免“忘记续期导致全站不可访问”。

七、常见错误排查(含真实报错)

以下报错按出现频率排序,每条都给出定位命令。

  • curl: (60) SSL certificate problem: unable to get local issuer certificate,浏览器对应 ERR_CERT_AUTHORITY_INVALID。原因几乎都是缺中间证书。定位:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE',正常应为 2(叶子+中间)。修复:Nginx 的 ssl_certificate 改指 fullchain.pem。
  • ERR_CERT_COMMON_NAME_INVALID:证书 SAN 不含当前域名。检查 openssl x509 -in cert.pem -noout -text | grep -A1 'Subject Alternative Name',注意裸域与 www 是两条 SAN。
  • nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line):文件路径错、文件为空、内容是 DER 二进制,或把私钥误写进了证书文件。
  • nginx: [emerg] SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不配对。比对:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两者必须一致。
  • ERR_SSL_PROTOCOL_ERROR / SSL_ERROR_NO_CYPHER_OVERLAP:协议或套件无交集,或 443 端口被非 TLS 服务占用(Nginx 与 Apache 抢端口)。用 ss -lntp | grep 443 确认监听进程。
  • ERR_CERT_DATE_INVALID:服务器或客户端时间漂移,执行 timedatectl status 检查 NTP 同步。
  • urn:ietf:params:acme:error:unauthorized … Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404:webroot 路径配错,或 80 被强制跳转到 https。加 --webroot -w /var/www/html 指定真实根目录。
  • too many failed authorizations recently:触发速率限制,需等待约 1 小时。调试期先用 --dry-run 或 --staging 环境。
  • 老设备报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH:禁用 TLS 1.0/1.1 后,Android 4.x、Windows 7 未打补丁的客户端无法握手。需评估终端分布再决定兼容策略。

另外,Windows XP 与 Android 2.x 不支持 SNI,多站点共用 443 时会拿到默认证书,这是历史客户端问题,不能通过配置修复。

八、效果验证与自动续期

部署完成后必须做客观验证,而不是只看浏览器有没有锁。

# 查看服务端实际下发的证书链、有效期与签发者
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 检查 OCSP Stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -i 'OCSP Response Status'

# 到期前 30 天预警,返回 0 表示仍有效
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -checkend 2592000 -noout

# 响应头与跳转验证
curl -sI https://example.com | head -5

更全面的评级用 testssl.sh --severity HIGH https://example.com 或 SSL Labs 的 API:curl 'https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off'。目标通常是 A 及以上,关键项为 TLS 1.2/1.3 可用、无 RC4/3DES、支持前向保密、HSTS 生效。

续期必须自动化。先演练:certbot renew --dry-run。然后配置定时任务:

# /etc/cron.d/certbot
0 3 * * * root /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'

用 systemd 的系统可执行 systemctl list-timers | grep certbot 确认 timer 已启用。Nginx 的新连接会重新读取证书文件,但 reload 更稳妥;HAProxy 需通过 runtime API 更新;Tomcat 8.5+ 可调用 reloadSslHostConfigs,否则需重启 Connector。最后把“剩余天数”接入监控告警,阈值设 15 天。

常见问题

证书有效期到底是多久,还能买“一年期”吗?

不能买单张一年期公信证书。2020-09-01 起 CA/B 基线要求单张证书最长 398 天,Let’s Encrypt 固定 90 天。市面上说的“一年”是服务商的托管、续期与技术支持服务期,实际证书仍会在 398 天内到期并由服务商或 ACME 客户端重新签发。

通配符证书能覆盖多级子域和裸域吗?

不能。*.example.com 只匹配一级子域,a.example.com 可以,a.b.example.com 不行;它也不包含裸域 example.com。需要同时覆盖时,在 SAN 中额外加上 example.com。

只开放 443 端口、不开放 80 端口,能签发证书吗?

可以,但要走 DNS-01(TXT 记录)或 TLS-ALPN-01(443 端口)。HTTP-01 必须能访问 80 端口的 /.well-known/acme-challenge/ 路径,且该路径不能被强制跳转到 https 或返回 403。

EV 证书现在还会在浏览器地址栏显示公司名称吗?

不会。Chrome 77 起移除了 EV 的绿色地址栏与组织名展示,Safari 也已取消。EV 的当前价值在于更严格的法人核验、合规审计与证书透明度日志中的品牌记录,而不是视觉标识。

更换证书需要重启 Web 服务吗?

Nginx 执行 nginx -t && systemctl reload nginx 即可热加载;Apache 用 graceful 重载;Tomcat 8.5+ 可通过 JMX 调用 reloadSslHostConfigs,否则需重启 Connector 或实例。IIS 在证书更新后重新绑定即可,通常无需重启服务器。

自签证书能用于小程序或 iOS ATS 吗?

不能。小程序与 ATS 都要求受信任 CA 签发的证书,并且服务端必须下发完整证书链(叶子 + 中间证书)。自签证书只能用于内部测试,且需在客户端手动导入信任。

内容审核

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