SSL 证书配置完整指南:从 CSR 申请到 Nginx/Apache/Tomcat 部署与自动续期
问题背景与根因:HTTP 明文传输与证书有效期新规
很多站长把 HTTPS 当成“加个绿锁”的可选项,直到微信小程序审核被拒、iOS 端页面被运营商注入浮动广告、Chrome 地址栏打出“不安全”红字才开始处理。根因只有一条:HTTP 是明文协议,从用户浏览器到源站的每一跳(公共 WiFi、运营商链路、CDN 回源)都能被读取和篡改。典型劫持表现是页面底部被插入广告、下载链接被替换、首次访问被强制跳转到博彩页面,这些在 TLS 加密后全部失效。
同时规则在收紧:微信小程序要求所有网络请求必须是 HTTPS 且 TLS 版本不低于 1.2;Chrome 自 2018 年起对 HTTP 页面标记“不安全”;HTTP/2 与 HTTP/3 在主流实现(Nginx 1.25+、Chrome、Firefox)中都要求基于 TLS。也就是说不上 HTTPS 不只是安全问题,还会直接损失性能与搜索排名。
另一条必须知道的新规是证书有效期。CA/Browser Forum 规定,自 2020 年 9 月 1 日起所有公开信任的 SSL/TLS 证书最长有效期被限制为 398 天(约 13 个月),此前签发的 2 年、3 年证书已不被浏览器接受。Let’s Encrypt 更短,免费证书有效期为 90 天。所以原文里“默认提供有效期为一年的证书”的说法已经过时,任何方案都必须把“自动续期”写进流程,否则一年后必然出现 ERR_CERT_DATE_INVALID。本文按“申请—签发—配置—验证—自动续期”的完整链路给出可直接执行的命令与配置。
证书选型:验证等级、域名覆盖与有效期对比
选型只看三个维度:验证等级、覆盖域名数量、有效期。DV(Domain Validation)只验证域名控制权,通过 DNS TXT 记录或 HTTP 文件校验,通常 1-10 分钟自动签发;OV(Organization Validation)需要 CA 人工核验营业执照与组织信息,1-3 个工作日;EV(Extended Validation)额外核验法律实体与电话,3-7 个工作日。这里要纠正一个过时说法:Chrome 77 之后已不再在地址栏显示 EV 证书的公司名称,“地址栏显示公司名”这个卖点已经失效,为它支付数倍溢价并不划算。
| 类型 | 验证内容 | 签发时长 | 单张最长有效期 | 适用场景 |
|---|---|---|---|---|
| DV 域名型 | 域名控制权(DNS TXT / HTTP 文件) | 1-10 分钟 | 398 天 | 个人站、API、测试环境、小程序后端 |
| OV 组织型 | 域名 + 营业执照等组织信息 | 1-3 个工作日 | 398 天 | 企业官网、B 端 SaaS |
| EV 扩展型 | 域名 + 法律实体 + 电话核验 | 3-7 个工作日 | 398 天 | 金融、电商(地址栏已不显示公司名) |
域名覆盖上分三类,选错是最常见的浪费:
| 覆盖类型 | 示例 | 可覆盖 | 不覆盖 |
|---|---|---|---|
| 单域名 | a.example.com | 仅该主机名 | example.com、www.example.com |
| 多域名 SAN | a.com / b.com / c.com | 列表内全部,单张最多 100 个 | 列表外域名 |
| 通配符 | *.example.com | www、api、mail 等一级子域 | example.com 本身、a.b.example.com |
两个易踩的坑:通配符 *.example.com 不覆盖裸域 example.com,也不覆盖 a.b.example.com 这类二级以上子域,需额外添加 SAN;多域名证书(SAN/UCC)单张最多 100 个域名,但域名越多单张越贵,超过 5 个域名时通常比买多张 DV 更划算。签发后先用命令核对实际有效期与 SAN,别等上线才发现少了 www:
openssl x509 -in example.com.fullchain.pem -noout -dates -subject
openssl x509 -in example.com.fullchain.pem -noout -ext subjectAltName
申请前的准备:域名、CSR、DNS 与 443 端口
动手前把下面 5 项核对完,可以避免 80% 的返工:
- 域名管理权限:能新增 TXT 记录(DNS-01 验证)或能把验证文件放到网站根目录(HTTP-01 验证)。
- 服务器时间准确:
timedatectl status或chronyc tracking,时间偏差超过 5 分钟会直接导致 ACME 校验失败。 - 443 端口放行:云服务器要同时改安全组和系统防火墙,
firewall-cmd --permanent --add-service=https && firewall-cmd --reload或ufw allow 443/tcp;用ss -lntp | grep :443确认端口未被占用。 - 服务端版本:
nginx -v、httpd -v、openssl version(TLS 1.3 需要 OpenSSL 1.1.1+)。 - 证书链文件:必须使用 fullchain(服务器证书 + 中间证书),只部署服务器证书会在 Android 和部分 Java 客户端报错。
用商业 CA 需要先生成私钥与 CSR(Let’s Encrypt 由工具自动生成,可跳过):
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 核对 CSR 中的 SAN 是否齐全
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 核对私钥与 CSR 是否配对(两个 md5 必须一致)
openssl req -noout -modulus -in example.com.csr | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
私钥权限收紧到 600:chmod 600 example.com.key && chown root:root example.com.key。也可以使用 ECDSA P-256 私钥(-newkey ec -pkeyopt ec_paramgen_curve:prime256v1),证书体积更小、握手更快,但需确认客户端兼容性;面向老旧 Android 的业务仍建议 RSA 2048。
实操:DNS-01 验证与证书签发(acme.sh / certbot)
生产环境推荐 DNS-01 验证:不依赖 80 端口、支持通配符、签发时无需停服。以阿里云 DNS 为例,用 acme.sh 一条链路走完申请到部署:
# 1. 安装(自动写入 cron 续期任务)
curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
# 2. 配置 DNS API 凭据(阿里云 RAM 子账号,仅授权 AliyunDNSFullAccess)
export Ali_Key="LTAI5t******"
export Ali_Secret="******"
# 3. 签发(同时覆盖裸域与 www,通配符写 -d "*.example.com")
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d www.example.com
# 4. 安装到 Nginx 目录并注册热加载命令
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
用 certbot 的场景(HTTP-01 验证,需 80 端口可访问):
certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
--email admin@example.com --agree-tos --no-eff-email
# 演练续期,必须成功
certbot renew --dry-run
systemctl list-timers | grep certbot
关键点:Let’s Encrypt 证书有效期 90 天,官方建议在剩余 30 天时续期;acme.sh 默认 60 天后自动续,certbot 由 systemd timer 每日两次检查。不要手动续期,把续期写进自动化并用 --dry-run 验证;398 天上限内的商业证书同样建议到期前 30 天更换,避免 ERR_CERT_DATE_INVALID。
配置示例:Nginx、Apache、Tomcat 可直接套用
Nginx(1.25.1 之前写 listen 443 ssl http2;,之后用独立的 http2 on;,混用会报 [warn] the "listen ... http2" directive is deprecated):
server {
listen 443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/example.com.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/example.com.fullchain.pem;
add_header Strict-Transport-Security "max-age=31536000" always;
}
Apache 2.4(SSLCertificateChainFile 在 2.4.8 之后已废弃,直接把链拼进 SSLCertificateFile 指向的文件):
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Tomcat 9/10 用 PKCS12 更省事,先转换再改 server.xml:
openssl pkcs12 -export -out example.pfx
-inkey example.com.key -in example.com.fullchain.pem -passout pass:changeit
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="150" SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.pfx"
certificateKeystorePassword="changeit" type="PKCS12"/>
</SSLHostConfig>
</Connector>
改完必须 nginx -t / apachectl configtest 再重载,语法错误会导致整站 502 或启动失败。所有证书文件统一放在 /etc/nginx/ssl/ 这类受控目录并设为 600,避免被 Web 目录遍历下载。
HTTP 301 强制跳转与 TLS 加固
跳转要用 301(永久)而不是 302,搜索引擎才会传递权重。Nginx 单独建一个 80 端口 server 块,不要用 rewrite 塞进业务 location:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
Apache 用 RewriteEngine On + RewriteCond %{HTTPS} off + RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [R=301,L];IIS 在 web.config 的 <rewrite> 里加规则,<action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />;Tomcat 在 web.xml 里加 <security-constraint> 并设置 <transport-guarantee>CONFIDENTIAL</transport-guarantee>。
加固要点:① 只开 TLS 1.2/1.3,TLS 1.0/1.1 已被主流浏览器弃用,PCI DSS 也不允许;② 开启 OCSP Stapling 减少一次外网请求,但必须配 ssl_trusted_certificate;③ HSTS 首次上线把 max-age 设成 300 秒试运行,确认所有子域都能 HTTPS 后再调到 31536000,否则会把用户锁死在无法访问的状态;④ 启用 HTTP/2 后单域名并发从 6 条连接降到 1 条多路复用。
验证协议与套件是否达标:
nmap --script ssl-enum-ciphers -p 443 example.com
openssl s_client -connect example.com:443 -servername example.com -tls1_1 # 应握手失败
常见错误排查:7 个真实报错与修复
1)nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) 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 key.pem | openssl md5 比对,不一致就重新签发或找齐配套文件。
2)curl: (60) SSL certificate problem: unable to get local issuer certificate:证书链不完整,只部署了服务器证书。改成 fullchain 文件,并用 openssl s_client -connect example.com:443 -servername example.com -showcerts 确认返回两张以上证书。Java 客户端还需把中间证书导入 truststore。
3)NET::ERR_CERT_COMMON_NAME_INVALID:SAN 里没有当前访问的域名,典型是只申请了 www.example.com 却用 example.com 访问。用 openssl x509 -noout -ext subjectAltName -in cert.pem 核对,缺哪个补哪个(只能重新签发,不能改证书)。
4)curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number 或浏览器 ERR_SSL_PROTOCOL_ERROR:443 端口上跑的不是 TLS,常见于 listen 443; 漏写 ssl,或反向代理 proxy_pass http://... 到明文后端却被客户端当 HTTPS 直连。
5)curl: (7) Failed to connect to example.com port 443: Connection timed out:端口没通,不一定是证书问题。依次查 ss -lntp | grep :443、nc -vz example.com 443、云控制台安全组入方向是否放行 TCP 443,以及 firewall-cmd --list-all。
6)nginx: [warn] "ssl_stapling" ignored, issuer certificate not found:缺 ssl_trusted_certificate 或链文件不完整,OCSP Stapling 被静默跳过,不影响访问但握手变慢。
7)浏览器 ERR_CERT_DATE_INVALID:证书过期或服务器时间错误。先 date -u 校验时间,再 openssl x509 -noout -dates -in cert.pem 看 notAfter,续期后重载服务。
效果验证:命令行与在线工具双重校验
部署完别只看浏览器有没有绿锁,按下面四步逐项确认:
# 1. 证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 协议版本与加密套件
openssl s_client -connect example.com:443 -servername example.com -brief
# 3. 跳转是否符合预期
curl -sI http://example.com | head -3 # 期望 301 + Location: https://...
curl -sI https://example.com | head -3 # 期望 200
# 4. HTTP/2 是否生效
curl -sI --http2 https://example.com | head -1 # 期望 HTTP/2 200
在线工具用 SSL Labs(https://www.ssllabs.com/ssltest/),目标 A 或 A+,重点看两项:Chain issues 必须是 None,Protocols 里不能出现 TLS 1.0/1.1。国内可用 MySSL 检测;微信小程序还需在“开发设置—服务器域名”确认 request 域名已备案且为 HTTPS。
最后加上到期监控,别依赖记忆。一个十几行的巡检脚本就够:
#!/bin/bash
DOMAIN="example.com"
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $LEFT -lt 15 ] && echo "WARN: $DOMAIN 证书剩余 $LEFT 天" | mail -s "SSL 到期告警" ops@example.com
用 Prometheus 的 blackbox_exporter 更规范:probe_ssl_earliest_cert_expiry 减去 time() 再除以 86400 就是剩余天数,配 Alertmanager 在 21 天时告警,比人工巡检可靠得多。
常见问题
证书有效期到底是 398 天还是 1 年?能一次买 3 年吗?
公开信任的 SSL/TLS 证书单张最长 398 天,这是 CA/Browser Forum 的强制上限,浏览器不会接受超过该期限的证书。所谓“买 3 年”实际是购买多年期订阅,CA 每年为你重签一张新证书,需要你配合重新验证并替换部署。Let’s Encrypt 更短,只有 90 天,必须依赖自动续期。
免费 Let’s Encrypt 和付费 DV 证书有区别吗?浏览器会警告吗?
加密强度与浏览器信任完全一致,两者都链到受信任根证书,不会出现任何警告,SSL Labs 同样可以评到 A+。差别在于有效期(90 天 vs 398 天)、保障赔付额度、是否提供人工技术支持、是否支持 OCSP 与证书透明度日志的托管服务。部分行业合规审计会要求 OV 及以上,此时才需要付费。
通配符证书能覆盖 example.com 和多级子域吗?
不能。*.example.com 只匹配一级子域,如 www、api、mail,不匹配裸域 example.com,也不匹配 a.b.example.com。正确做法是申请时同时添加 -d example.com -d "*.example.com" 两个 SAN;多级子域则需单独写进 SAN 列表或再申请一张通配符。
部署后仍提示“不安全”或资源加载失败怎么办?
多半是混合内容。Chrome 控制台会报 Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure image 'http://example.com/a.png'. This request has been blocked.。排查页内所有 http:// 引用,改成相对协议 // 或 https 绝对地址;也可在 Nginx 加 add_header Content-Security-Policy "upgrade-insecure-requests"; 自动升级。
更换证书需要停机吗?
不需要。Nginx 用 nginx -t && nginx -s reload 平滑重载,新连接立即使用新证书,老连接自然结束;Apache 用 apachectl -k graceful。acme.sh 的 --reloadcmd 与 certbot 的 --deploy-hook 都能把重载命令固化到续期流程里,实现零停机换证。
HTTP/2 开启后没生效怎么排查?
先看 Nginx 版本:1.25.1 之前写 listen 443 ssl http2;,之后必须写成 listen 443 ssl; 加独立的 http2 on;。其次确认站点是 HTTPS,HTTP/2 在主流实现中不跑明文。用 curl -sI --http2 https://example.com | head -1 验证,返回 HTTP/2 200 即生效;若返回 HTTP/1.1,检查是否被前置 CDN 或负载均衡降级。