跳到主要内容
HTTPS安装配置

HTTPS 配置与 SSL 证书安装全流程实战:Nginx/Apache/Tomcat 部署、报错排查与效果验证

HTTPS 配置与 SSL 证书安装全流程实战:Nginx/Apache/Tomcat 部署、报错排查与效果验证 — HTTPS 配置与 SSL 证书安装全流程实战:Nginx/Apache/Tomcat 部署、报错排查与效果验证

问题背景与根因:HTTPS 配置失败的六类真实原因

绝大多数「HTTPS 打不开」「证书装完还是不安全」的工单,根因并不在证书本身,而在部署环节的六类问题:①只下发了服务器证书(server certificate),漏装中间证书(intermediate CA),客户端报 unable to get local issuer certificate;②私钥与证书不匹配,Nginx 直接启动失败;③证书与域名不匹配,例如只签了 www 却用裸域访问,或误以为泛域名能覆盖二级以上子域;④页面内仍是 http:// 绝对链接,触发混合内容(mixed content)拦截;⑤TLS 协议版本与加密套件过旧,被现代浏览器判定为弱加密;⑥80 端口未做 301 跳转,同一内容被双协议重复收录。

先用三条命令做自检,可定位约 80% 的故障:

# 1. 校验证书与私钥是否配对,两条输出的 MD5 必须完全一致
openssl x509 -noout -modulus -in server.crt | openssl md5
openssl rsa -noout -modulus -in server.key | openssl md5

# 2. 校验证书链完整性,正常应输出 OK
openssl verify -CAfile fullchain.crt server.crt
# 报 error 20 at 0 depth lookup: unable to get local issuer certificate 即链不完整

# 3. 校验证书覆盖的域名列表
openssl x509 -noout -text -in server.crt | grep -A1 'Subject Alternative Name'

必须纠正两个被老教程带偏的事实:其一,按 CA/Browser Forum 基线要求,公有 CA 签发的单张 TLS 证书有效期上限为 398 天,主流 CA 实际签发多为 90~365 天;其二,Let’s Encrypt 免费证书有效期为 90 天,并已提供更短的 6 天周期选项,必须配合自动续期,否则到期当天全站变成「您的连接不是私密连接」。因此正确认知是「安装 + 自动化续期 + 到期监控」三件套,而非一次安装永久有效。

前置准备:生成 CSR、规划域名与选择证书类型

申请证书的第一步是生成私钥与 CSR(Certificate Signing Request)。推荐 ECDSA P-256,密钥体积小、握手更快,主流浏览器与 Android 7+ 均已支持;若需兼容老旧 Android 5、部分 IoT 设备或 Java 6 客户端,则退回 RSA 2048。

# 方案 A:ECDSA P-256 私钥 + CSR(推荐)
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co.,Ltd/CN=example.com'

# 方案 B:RSA 2048 私钥 + CSR(兼容性优先)
openssl genrsa -out example.com.key 2048
openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co.,Ltd/CN=example.com'

# 检查 CSR 内容是否正确
openssl req -noout -text -in example.com.csr | head -20

CN 只写一个主域名,多域名必须写进 SAN(Subject Alternative Name)。申请时把 example.com 与 www.example.com 一并提交;泛域名 *.example.com 只覆盖一级子域,不覆盖裸域,也不覆盖 a.b.example.com。DV 证书走 DNS TXT 或 HTTP 文件验证,通常 10 分钟内签发;OV/EV 需人工核验工商信息与电话,一般 1~2 个工作日,EV 还需完成企业电话回呼(座机、DUNS 记录或信用公示平台登记的企业电话均可)。域名规划上建议只保留一个规范域名(裸域或 www 二选一),其余全部 301 过去;后台与 API 用独立子域单独签证书,避免单张证书泄露影响全域。

完整实操:Nginx 部署 SSL 证书的 7 个步骤

以 Ubuntu 22.04 + Nginx 1.18 为例,以下命令可直接复制执行。

# 1. 建立证书目录,权限收紧,私钥只允许 root 读取
sudo mkdir -p /etc/nginx/ssl/example.com
sudo cp fullchain.crt /etc/nginx/ssl/example.com/
sudo cp example.com.key /etc/nginx/ssl/example.com/
sudo chmod 600 /etc/nginx/ssl/example.com/example.com.key
sudo chown root:root /etc/nginx/ssl/example.com/*

# 2. 写入 server 配置(模板见下一节)

# 3. 语法检查,必须看到 syntax is ok 与 test is successful
sudo nginx -t

# 4. 平滑重载,不断开现有连接
sudo systemctl reload nginx

# 5. 放行 443(firewalld 与 ufw 二选一)
sudo firewall-cmd --permanent --add-service=https && sudo firewall-cmd --reload
sudo ufw allow 443/tcp

# 6. 验证自动续期链路是否可用(Let's Encrypt 场景)
sudo certbot renew --dry-run

# 7. 添加续期后的重载钩子脚本,内容仅一行:systemctl reload nginx
sudo mkdir -p /etc/letsencrypt/renewal-hooks/deploy
sudo vi /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh

四个易踩的细节:ssl_certificate 必须指向 fullchain(叶子证书 + 中间证书拼接),只写叶子证书会让部分客户端握手失败;ssl_certificate_key 指向私钥,两者路径写反会直接启动失败;ssl_protocols 只保留 TLSv1.2 与 TLSv1.3,删除 TLSv1 与 TLSv1.1;开启 ssl_session_cache shared:SSL:10m 可缓存约 4 万个会话,显著降低重复握手开销。

配置示例:Nginx / Apache / Tomcat 三套可套用模板

Nginx(1.25.1 起 http2 on; 替代旧的 listen 443 ssl http2):

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://example.com$request_uri;
}

server {
    listen 443 ssl;
    http2 on;
    server_name example.com;

    ssl_certificate     /etc/nginx/ssl/example.com/fullchain.crt;
    ssl_certificate_key /etc/nginx/ssl/example.com/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: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;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/example.com/chain.crt;
    resolver 223.5.5.5 1.1.1.1 valid=300s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;

    root /var/www/html;
    index index.html;
}

Apache 2.4(需启用 mod_ssl 与 mod_headers):

<VirtualHost *:443>
    ServerName example.com
    DocumentRoot /var/www/html
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.crt
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLCertificateChainFile /etc/httpd/ssl/chain.crt
    SSLProtocol -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
    SSLHonorCipherOrder off
    Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>

Tomcat 9/10(推荐 PKCS12,替代已废弃的 JKS):

openssl pkcs12 -export -in fullchain.crt -inkey example.com.key 
  -out example.com.p12 -name tomcat -passout pass:Changeit123

# server.xml 中 Connector 需设置的关键属性:
# port=8443  protocol=org.apache.coyote.http11.Http11NioProtocol
# SSLEnabled=true  scheme=https  secure=true
# certificateKeystoreFile=/opt/tomcat/conf/example.com.p12
# certificateKeystorePassword=Changeit123  certificateKeystoreType=PKCS12
# sslProtocol=TLSv1.2,TLSv1.3
服务器 证书指令 私钥指令 协议指令 生效命令
Nginx ssl_certificate(fullchain) ssl_certificate_key ssl_protocols nginx -t && nginx -s reload
Apache SSLCertificateFile + SSLCertificateChainFile SSLCertificateKeyFile SSLProtocol apachectl configtest && apachectl -k graceful
Tomcat certificateKeystoreFile certificateKeystorePassword sslProtocol shutdown.sh && startup.sh

证书类型与部署方案对比表

选型不要只看价格,要看验证等级、有效期与运维成本。下表为当前实际可签发的情况:

证书类型 验证内容 签发时长 有效期上限 浏览器展示 适用场景
Let’s Encrypt DV 域名控制权(HTTP-01 / DNS-01) 1~10 分钟 90 天,需自动续期 锁标志 个人站、测试环境、中小站点
商业 DV 域名控制权 10 分钟~2 小时 398 天 锁标志 多域名 SAN、泛域名业务
OV 域名 + 企业工商信息核验 1~2 个工作日 398 天 锁标志,点开可见企业名 企业官网、B 端 SaaS
EV 域名 + 企业 + 电话/DUNS 回呼 2~5 个工作日 398 天 锁标志(Chrome 77 起已取消绿色地址栏) 金融、支付、政企

再补充一组部署形态对比:单域名证书成本最低但扩展性差;多域名 SAN 证书一张覆盖 5~100 个域名,适合多子域业务;泛域名证书覆盖一级子域,但私钥一旦泄露影响全域,且无法用于裸域。工程上更稳妥的做法是「泛域名 + 关键域名单独签」,并用配置管理工具统一分发,避免手工拷贝导致的版本混乱。

常见错误排查:8 条真实报错与对应解法

下面每一条都是线上工单中出现频率最高的原始报错,直接对照处理即可。

报错信息 根因 解法
nginx: [emerg] PEM_read_bio_X509_AUX(…) failed (SSL: error:0909006C:PEM routines:get_name:no start line) 证书是 DER 二进制,或下载时被 HTML 页面内容污染 openssl x509 -in a.crt -inform DER -out a.pem 转换,或从 CA 重新下载 PEM
nginx: [emerg] SSL_CTX_use_PrivateKey(…) failed (SSL: error:0B080074:X509_check_private_key:key values mismatch) 私钥与证书不配对,常见于多张证书混用 用 modulus md5 比对后重新配对
curl: (60) SSL certificate problem: unable to get local issuer certificate 缺中间证书,只部署了叶子证书 改用 fullchain.crt 并确认链文件顺序
NET::ERR_CERT_COMMON_NAME_INVALID 证书未覆盖当前访问域名(www 与裸域不一致) 重签含 SAN 的证书,或统一 301 到已覆盖域名
Mixed Content: The page at https://… was loaded over HTTPS, but requested an insecure element http://… 页面内存在 http 绝对链接 改为 // 或 https,并下发 CSP upgrade-insecure-requests
SSL_ERROR_NO_CYPHER_OVERLAP 客户端与服务器无交集加密套件(老 XP / Java 6) 临时放行 TLSv1.2 兼容套件,或推动客户端升级
AH01909: RSA certificate configured for www.example.com:443 does not include an ID which matches the server name Apache 中 ServerName 与证书域名不一致 修正 ServerName 或更换匹配证书
525 SSL handshake failed(Cloudflare 回源) 源站 443 未监听或证书链错误 源站执行 openssl s_client 自测,回源模式改为 Full (strict)

关于第 5 条要特别说明:配置完成后如果页面样式错乱、图片加载失败,绝大多数不是证书配置问题,而是程序模板里硬编码了 http:// 调用。排查命令:curl -s https://example.com | grep -o 'http://[^"]*' | head -20,把命中的资源逐个改为相对协议或 https,再清理 CDN 与浏览器缓存。

效果验证:从命令行到浏览器评级

配置完成不等于生效,必须做四层验证:协议与套件、证书链、跳转与安全响应头、到期监控。

# 1. 查看协商结果与证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 2. 确认旧协议已关闭,期望输出 handshake failure 或 alert protocol version
openssl s_client -connect example.com:443 -tls1_1 </dev/null

# 3. 检查 80 跳转与 HSTS 响应头
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -Ei 'strict-transport-security|^HTTP/'

# 4. 取到期时间,剩余不足 15 天应触发告警
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -enddate

浏览器侧按 F12 打开 Security 面板,确认 Connection 显示 TLS 1.3、Certificate 显示有效且证书链完整;Console 中不应出现 Mixed Content 告警。第三方评级可提交 SSL Labs 检测,目标是 A 及以上;若出现「This server supports weak Diffie-Hellman parameters」或「Uses SHA-1」,需替换为 ECDHE 套件并重签证书。最后把到期检查接入监控(Zabbix / Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标),阈值设为剩余 15 天告警,这才是完整的 HTTPS 交付。

常见问题

证书已经安装,浏览器仍提示不安全怎么办?

按顺序排查三点:一是证书链是否完整,执行 openssl verify -CAfile fullchain.crt server.crt 看是否 OK;二是访问域名是否在证书 SAN 列表中,注意 www 与裸域是两张不同的名字;三是系统时间是否准确,客户端时间偏差超过证书有效期会直接报错。若三项都正常,检查是否有 CDN 或 WAF 层终止了 TLS 并返回了自签证书。

一张证书可以同时用于多个域名或子域吗?

可以,用多域名 SAN 证书,一张证书可写多个完全不同的域名,主流 CA 支持 5~100 个。泛域名 *.example.com 只覆盖一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com,实际使用中通常需要「泛域名 + 裸域」组合下单。

Let’s Encrypt 免费证书和付费证书的核心差别是什么?

加密强度没有差别,都是 2048 位 RSA 或 P-256 ECDSA。差别在三点:有效期 90 天对 398 天,免费证书必须做自动续期;验证等级只有 DV,不含企业身份核验;无商业 SLA 与人工支持。对外服务的生产环境建议用商业 OV 证书,测试与内部系统用 Let’s Encrypt 完全够用。

证书续期或更换服务器后需要重新配置吗?

续期只替换证书文件,配置文件不用改,但必须重载服务:Nginx 执行 nginx -t && nginx -s reload,Apache 执行 apachectl -k graceful,Tomcat 需重启。迁移服务器时私钥要一并迁移,否则新机器上的证书无法使用;如果私钥已泄露,必须重新签发而不是复制旧文件。

启用 HTTPS 后还需要单独配置 HTTP/2 吗?

需要。HTTP/2 在主流服务器上依赖 TLS(h2 协议),但必须显式开启:Nginx 1.25.1 之前写 listen 443 ssl http2;,之后写 http2 on;;Apache 需加载 mod_http2 并设置 Protocols h2 http/1.1。开启后可用 curl -sI --http2 https://example.com 验证返回 HTTP/2。

HSTS 头可以随便加吗?

不建议一开始就设长周期。建议先用 max-age=300 观察一周,确认全站资源与子域都已支持 HTTPS,再逐步提升到 31536000 并追加 includeSubDomains。一旦下发长周期 HSTS 且某个子域只有 HTTP 服务,该子域在有效期内将无法被访问,回滚只能等 max-age 到期。

内容审核

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