跳到主要内容
ssl证书按装

HTTPS 全站加密实战:SSL 证书申请、Nginx/Tomcat 配置与检测优化

HTTPS 全站加密实战:SSL 证书申请、Nginx/Tomcat 配置与检测优化 — HTTPS 全站加密实战:SSL 证书申请、Nginx/Tomcat 配置与检测优化

一、问题背景与根因:明文 HTTP 与“一年期证书”都已失效

把站点从 HTTP 迁移到 HTTPS,原因并非只是“更安全”这句口号;三条硬性约束叠加在一起,才促使大家这样做:其一,明文 HTTP 在链路上可被任意中间设备读取和篡改,运营商劫持插广告、公共 Wi-Fi 注入脚本都是真实事件;其二,浏览器把安全上下文当成能力开关,HTTP/2、HTTP/3、Service Worker、地理位置、剪贴板、摄像头等 API 在非安全上下文下直接不可用;其三,生态方强制要求,微信小程序要求所有请求域名必须是 HTTPS,Apple ATS 默认阻断明文连接,Android 9 起 Network Security Config 默认禁止明文流量。

根因通常只有三个:服务端只有 80 端口在监听、证书链不完整或域名不匹配、页面里残留 http:// 资源造成混合内容。前两个决定浏览器能否完成握手,第三个决定地址栏的锁是否“变灰”。

更要注意,很多旧教程里的“证书有效期一年”已经不符合现行规则:

  • CA/Browser Forum 规定,2020-09-01 之后签发的公开信任证书有效期上限为 398 天,所谓“一年期证书”实际签发出来是 397 天左右,不存在 365 天以上的例外。
  • Let’s Encrypt 免费证书固定 90 天有效期,官方建议在剩余 30 天时续期。
  • SC-081 时间表已生效:2026-03-15 起公开证书最长 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。这意味着“人工每年续一次”的模式必然被淘汰,自动化签发与续期是唯一可行方案。
  • EV 证书自 Chrome 77(2019 年)起不再在地址栏显示公司名称,只保留在证书详情中。EV 现在的价值主要来自更严格的单位审核与责任保障,而非“地址栏显示公司名”这个卖点。

动手前先摸清现状,一条命令看清线上证书的签发者、有效期与 SAN:

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

如果输出里 notAfter 已过期,或 subjectAltName 中没有你正在访问的域名,后续所有配置优化都是徒劳,先解决证书本身。

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

证书选型看两个维度:验证等级和覆盖范围。验证等级决定审核流程与信任背书,覆盖范围决定一张证书能保护多少个域名。

验证等级方面:DV 只验证域名控制权,通过 DNS TXT 或 HTTP 文件完成,几分钟签发,地址栏与 OV/EV 无差别,都是锁标志;OV 需营业执照与电话回访,1-3 个工作日;EV 需更严格的单位存在性核验,但 2019 年后地址栏无特殊显示。

覆盖范围方面:单域名只保护一个 FQDN,www 与裸域算两个;多域名(SAN/UCC)在一张证书里放多个 SAN,通常 3-5 个起步,可追加;通配符 *.example.com 覆盖一级子域,但不覆盖 example.com 本身,也不覆盖 a.b.example.com。

类型 验证方式 签发时长 典型有效期 地址栏表现 适用场景
DV 单域名 DNS TXT / HTTP-01 1-10 分钟 90 天(LE)或最长 398 天(商业) 锁标志 个人站、API、内部测试
DV 通配符 仅 DNS-01 5-30 分钟 同上 锁标志 多子域、SaaS 租户
OV 多域名 单位资料 + 电话核验 1-3 个工作日 最长 398 天 锁标志 企业门户、对外业务系统
EV 严格单位核验 + 第三方库 3-7 个工作日 最长 398 天 锁标志(不再显示公司名) 金融、支付、招投标要求
自签证书 无 即时 自定义 红色警告 仅内网、开发调试

实践建议:绝大多数站点用 DV 通配符加自动化续期即可;只有招标文件或合规审计明确要求 OV/EV 时才付费。购买商业证书时注意“单域名”通常不含 www,必须把 www.example.com 加入 SAN 或单独购买。

一条命令确认证书覆盖了哪些域名,避免漏配 www:

openssl x509 -in fullchain.pem -noout -text | sed -n '/Subject Alternative Name/,+1p'

三、实操一:生成私钥与 CSR(含 SAN)

CSR(证书签名请求)包含公钥和主体信息,私钥必须自己生成且绝不上传。现代 CA 只认 SAN 扩展,CN 字段已不作为域名校验依据,因此 CSR 必须带 subjectAltName,否则签出来的证书在浏览器里就是 ERR_CERT_COMMON_NAME_INVALID。

优先使用 ECC(P-256),握手更快、密钥更短;对老客户端兼容性有要求时用 RSA 2048/3072。

# 1. ECC 私钥(推荐)
openssl ecparam -name prime256v1 -genkey -noout -out /etc/ssl/private/example.com.key

# 2. RSA 私钥(兼容性优先)
# openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out /etc/ssl/private/example.com.key

# 3. 收紧权限
chmod 600 /etc/ssl/private/example.com.key
chown root:root /etc/ssl/private/example.com.key

# 4. 生成带 SAN 的 CSR(OpenSSL 1.1.1+ 支持 -addext)
openssl req -new -sha256 -key /etc/ssl/private/example.com.key 
  -out /etc/ssl/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,DNS:api.example.com"

# 5. 校验 CSR 中的 SAN
openssl req -in /etc/ssl/example.com.csr -noout -text | sed -n '/Subject Alternative Name/,+1p'

如果 OpenSSL 版本低于 1.1.1(如 CentOS 7 自带的 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 = DNS:example.com,DNS:www.example.com
EOF
openssl req -new -sha256 -key example.com.key -out example.com.csr -config san.cnf

证书下发后,务必验证证书与私钥是否配对,这一步能提前避免 Nginx 的 key values mismatch 报错:

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

两个 md5 值一致才说明匹配。RSA 证书也可以用 -modulus 比对。

四、实操二:域名验证与签发(acme.sh / certbot)

DV 证书的验证方式只有两类:HTTP-01 要求在 http://域名/.well-known/acme-challenge/ 下放一个随机 token 文件;DNS-01 要求在 _acme-challenge.域名 添加 TXT 记录。通配符证书只能走 DNS-01,这是硬性限制。

以 acme.sh 为例,它是纯 shell 实现,无 Python 依赖,自带 cron 续期:

# 安装
curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc

# 方式 A:HTTP-01,webroot 模式(站点已能通过 80 端口访问)
acme.sh --issue -d example.com -d www.example.com 
  --webroot /var/www/html --server letsencrypt

# 方式 B:DNS-01,通配符(以阿里云 DNS 为例)
export Ali_Key="LTAIxxxxxx"
export Ali_Secret="xxxxxx"
acme.sh --issue -d example.com -d '*.example.com' --dns dns_ali --server letsencrypt

# 方式 C:DNS 手动验证(无法提供 API 的场景)
acme.sh --issue -d example.com -d '*.example.com' --dns --yes-I-know-dns-manual-mode-enough-go-ahead-please
# 按提示把 TXT 记录加到 DNS,确认生效后再续
dig +short TXT _acme-challenge.example.com @8.8.8.8
acme.sh --renew -d example.com --yes-I-know-dns-manual-mode-enough-go-ahead-please

签发成功后把证书“安装”到固定路径,并绑定 reload 命令,这样续期后服务自动生效:

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"

# 查看续期任务(默认每天检查一次,剩余 30 天时自动续)
crontab -l | grep acme.sh

certbot 用户的等价命令:

certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
certbot renew --dry-run

注意 –server letsencrypt 对应 90 天有效期的 Let’s Encrypt;换成 ZeroSSL 等其他 ACME 服务,有效期同样受 398 天上限约束,但 acme.sh 默认仍按 60 天周期续期。测试环境可用 –staging,避免触发生产环境速率限制(Let’s Encrypt 对同一注册域名每周限 50 张重复证书)。

五、配置示例:Nginx / Apache / Tomcat 的 TLS 落地

Nginx 完整示例,1.25.1 之前把 http2 on 改为 listen 443 ssl http2:

server {
    listen 80;
    server_name example.com www.example.com;
    location ^~ /.well-known/acme-challenge/ { root /var/www/html; }
    return 301 https://$host$request_uri;
}

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_trusted_certificate /etc/nginx/ssl/fullchain.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: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;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    add_header X-Content-Type-Options nosniff always;
    add_header Content-Security-Policy "upgrade-insecure-requests" always;

    root /var/www/html;
}

要点说明:fullchain.pem 必须是“站点证书 + 中间证书”,只配站点证书会导致 Android 与部分 Java 客户端报 unable to get local issuer certificate;ssl_prefer_server_ciphers 在新版建议 off,让客户端选择更优的 AEAD 套件;ssl_session_tickets off 可减少前向安全性损失。关于 OCSP stapling,Let’s Encrypt 已在 2025 年逐步关闭 OCSP 响应服务并改用 CRL,因此对 LE 证书配置 ssl_stapling on 已无实际收益,可移除该指令,ssl_trusted_certificate 仍可用于链校验。

Apache 2.4.8 之后不再需要 SSLCertificateChainFile,fullchain 已包含中间证书:

<VirtualHost *:443>
    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
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Tomcat 8.5.30+ 直接支持 PEM,不需要再转 JKS:

<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true" maxThreads="200">
  <SSLHostConfig protocols="TLSv1.2,TLSv1.3">
    <Certificate certificateFile="/etc/tomcat/ssl/fullchain.pem"
                 certificateKeyFile="/etc/tomcat/ssl/example.com.key"
                 type="RSA" />
  </SSLHostConfig>
</Connector>

若必须用 JKS:先用 keytool -importcert -alias chain -file chain.pem -keystore keystore.jks 导入中间证书,再配合 PKCS12 私钥使用。

六、对比表格:免费 DV、商业证书与自签的取舍

把“价格”和“信任”分开看:浏览器只校验证书链能否回到内置根、域名是否匹配、是否在有效期内,DV 与 OV/EV 在 TLS 握手层面完全等价,差别在审核、赔付与合规材料。

方案 有效期 信任范围 自动化 成本 典型适用
Let’s Encrypt DV(单域名/SAN) 90 天 全浏览器/系统 acme.sh、certbot 全自动 0 绝大多数网站、API 网关
Let’s Encrypt DV 通配符 90 天 全浏览器/系统 需 DNS API,全自动 0 多子域、SaaS
商业 DV 最长 398 天 全浏览器/系统 部分支持 ACME 百元级/年 需要发票与 SLA 的场景
商业 OV 最长 398 天 全浏览器/系统 人工续期 千元级/年 企业门户、政企项目
商业 EV 最长 398 天 全浏览器/系统 人工续期 数千元/年 金融、支付、招投标强制
自签证书 自定义 仅手动信任的客户端 openssl 一条命令 0 内网、开发调试

另一张表对比验证方式的选择:

验证方式 端口要求 能否签通配符 失败高频原因
HTTP-01 80 必须公网可达 否 301 跳转未放行 /.well-known、CDN 回源错误
DNS-01 无 是 TXT 未生效、API 权限不足、CNAME 冲突
TLS-ALPN-01 443 否 端口被其他服务占用

结论:预算有限就用 LE 通配符加自动续期,把省下的钱投入到监控与自动化;只有合规硬性要求时才上 OV/EV,并注意有效期上限是 398 天而非 365 天,续期节奏要按 397 天倒排。

七、常见错误排查:真实报错与定位命令

报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate。原因:服务端只发了站点证书,没发中间证书。用 -showcerts 数一下证书数量,正常至少 2 张:

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

返回 1 就说明链断了,把 fullchain.pem(站点证书 + 中间证书)配到 ssl_certificate,不要配 cert.pem。

报错 2:浏览器 NET::ERR_CERT_COMMON_NAME_INVALID,或 curl 报 no alternative certificate subject name matches target host name。原因:SAN 里没有当前访问的域名,最常见的是漏了 www。用下面的命令看证书到底覆盖了什么:

openssl x509 -in fullchain.pem -noout -ext subjectAltName

修复只能重签,改 CN 没用,现代浏览器只看 SAN。

报错 3:nginx: [emerg] cannot load certificate “/etc/nginx/ssl/fullchain.pem”: PEM_read_bio_X509_AUX() failed。原因:文件不是 PEM 格式(下载到的是 DER/.cer/.pfx)、内容为空、或带 UTF-8 BOM。转换与确认:

openssl x509 -in fullchain.pem -noout -subject   # 能解析才是合法 PEM
openssl x509 -inform DER -in cert.cer -out cert.pem

报错 4:nginx: [emerg] SSL_CTX_use_PrivateKey(“/etc/nginx/ssl/example.com.key”) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。原因:证书和私钥不是一对,常见于续期后只替换了其中一个文件。用第三节的 pubkey md5 比对法确认。

报错 5:ERR_SSL_PROTOCOL_ERROR 或 curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number。原因:用 https 连了 80 端口,或反向代理把明文流量转到了 443。确认监听:

ss -lntp | grep -E ':80|:443'
curl -vI http://example.com

报错 6:acme.sh 报 Verify error:Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404。原因:webroot 路径写错,或 Nginx 的 rewrite/伪静态把请求拦走。必须为挑战路径加白名单:

location ^~ /.well-known/acme-challenge/ { root /var/www/html; default_type text/plain; }

报错 7:certificate has expired or is not yet valid。原因:服务器时间漂移。检查并强制校时:

timedatectl
chronyc tracking && chronyc makestep

报错 8:ERR_CERT_AUTHORITY_INVALID。原因:自签证书,或服务端发送的链顺序错误、混入了根证书。用 openssl s_client -showcerts 按顺序核对,链里不要放根证书。

八、效果验证:从命令行到 SSL Labs 的完整检测

配置改完必须验证四件事:协议版本、证书链、SAN、HTTP 头。

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

# 2. 证书链数量(应 ≥2,且不含根证书)
echo | openssl s_client -connect example.com:443 -servername example.com -showcerts 2>/dev/null 
  | grep -c 'BEGIN CERTIFICATE'

# 3. 旧协议应握手失败(TLS1.0/1.1 已被主流浏览器弃用)
openssl s_client -connect example.com:443 -servername example.com -tls1 </dev/null

# 4. HSTS 与跳转
curl -sSI https://example.com | grep -iE 'strict-transport-security|^HTTP'
curl -sSI http://example.com | grep -iE '^HTTP|^location'

批量与可视化检测:

# testssl.sh 全量扫描
git clone --depth 1 https://github.com/drwetter/testssl.sh.git
./testssl.sh/testssl.sh --fast https://example.com

# 密码套件枚举
nmap --script ssl-enum-ciphers -p 443 example.com

# SSL Labs 评分(异步,需轮询)
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done" | head -c 800

把到期检查写进监控,避免凌晨过期:

# 剩余不足 30 天返回非 0
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem || 
  echo "cert will expire in 30 days" | mail -s "TLS ALERT" ops@example.com

验收标准建议定为:SSL Labs 评级 A 及以上、仅启用 TLS1.2/1.3、HSTS max-age 不低于 31536000、80 端口 301 到 https、页面无 http:// 资源、证书剩余有效期告警已接入。

常见问题

Let’s Encrypt 免费证书能用在生产环境和电商站点吗?

可以。浏览器不区分免费与付费证书,只校验证书链、域名和有效期。LE 的根证书已被主流系统和浏览器信任,90 天有效期是策略而非限制。需要注意的是必须做自动化续期,且 LE 不提供 OV/EV 审核,若招标文件明确要求 OV/EV 则无法替代。

为什么我的证书有效期是 90 天,而不是 398 天?

398 天是 CA/Browser Forum 对公开信任证书的有效期上限,不是所有 CA 都会用满。Let’s Encrypt 固定 90 天以缩短吊销窗口并推动自动化。此外 SC-081 已排定缩短时间表:2026-03-15 起上限 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天,长期看所有证书都会走向短周期。

通配符证书能覆盖 example.com 本身和三级域名吗?

不能。*.example.com 只匹配一级子域(www、api、mail),不匹配裸域 example.com,也不匹配 a.b.example.com。实际签发时通常把 example.com 和 *.example.com 一起写进同一张证书的 SAN,这样裸域和所有一级子域都能覆盖。

更换证书后必须重启 Nginx 吗?

不需要重启,reload 即可。systemctl reload nginx 会平滑加载新证书,已有连接不受影响。但 acme.sh –install-cert 的 –reloadcmd 必须配置,否则续期后磁盘上是新证书、内存里还是旧的。用 openssl s_client 查看 notBefore 是否已更新来确认。

启用 HTTP/2 或 TLS 1.3 有什么前置条件?

HTTP/2 在浏览器中强制要求 TLS,且需要 Nginx 1.9.5+ 编译了 ngx_http_v2_module,1.25.1 之后用 http2 on 指令,之前用 listen 443 ssl http2。TLS 1.3 需要 OpenSSL 1.1.1+ 与 Nginx 1.13+,并且不要手动把 TLSv1.3 的套件写进 ssl_ciphers,否则配置不生效。

内网系统也要用公开 CA 证书吗?

只有访问者浏览器需要无警告时才需要。纯内网可用自建 CA(openssl 签发)并把根证书推送到客户端信任库,或用 mkcert 生成开发证书。自签证书在公网会触发 ERR_CERT_AUTHORITY_INVALID,且无法通过 SSL Labs 评级。

内容审核

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