跳到主要内容
ssl证书按装

SSL 证书配置完整指南:从 CSR 申请到 Nginx/Apache/Tomcat 部署与自动续期

SSL 证书配置完整指南:从 CSR 申请到 Nginx/Apache/Tomcat 部署与自动续期 — 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 或负载均衡降级。

内容审核

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