跳到主要内容
ssl证书按装

HTTPS 配置与 SSL 证书安装全流程实战:CSR 生成、Nginx/Apache/Tomcat 部署与故障排查

HTTPS 配置与 SSL 证书安装全流程实战:CSR 生成、Nginx/Apache/Tomcat 部署与故障排查 — HTTPS 配置与 SSL 证书安装全流程实战:CSR 生成、Nginx/Apache/Tomcat 部署与故障排查

一、问题背景与根因:为什么“证书装完了”仍然报错

SSL/TLS 协议在传输层提供三项服务:认证服务器身份(必要时也认证客户端),确保数据发送到正确的主机;对传输数据加密,防止中途被窃取;通过 MAC/AEAD 维护数据完整性,确保报文在传输过程中不被篡改。HTTPS 就是把 HTTP 报文放进这条加密通道,默认端口 443。电商系统、支付与金融系统、以搜索引擎为主要流量来源的站点,都应尽早完成 HTTPS 化——主流搜索引擎对 HTTPS 页面优先抓取、优先展示,同时 HTTPS 能有效防止站点被镜像、被劫持插广告。

但在实际交付中,“证书已上传”不等于“HTTPS 可用”。我们处理过的工单里,报错集中在六类根因:

  • 证书链不完整:只部署了服务器证书,没带中间 CA,桌面 Chrome 正常,Android、curl、Java 客户端直接报错;
  • 证书与私钥不匹配:CSR 与私钥不是同一对,Nginx reload 直接失败;
  • 域名不匹配:证书 SAN 里只有 example.com,用户访问 www.example.com 就告警;
  • 443 端口未放行:云安全组、firewalld、SELinux 任一环节拦截都会表现为连接超时;
  • 页面混合内容:HTML 里写死 http:// 的图片、JS、CSS,导致“页面错乱”,这不是证书配置问题,而是程序调用了 http 资源;
  • 证书过期或系统时间错误:服务器时钟偏差超出证书有效期区间。

动手改配置前,先用一条命令把现状摸清:

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

输出中 Verify return code 为 0 才表示链校验通过;若出现 unable to get local issuer certificate,基本可判定中间证书缺失。再看 subjectAltName 里有没有你正在访问的域名,没有就是 SAN 不匹配。把这两条先确认,后面 90% 的排查都会快很多。

二、前置准备:密钥算法、CSR 生成与有效期新规

证书选型先定三件事:验证等级(DV/OV/EV)、覆盖范围(单域名 / 多域名 SAN / 通配符)、密钥算法(RSA 2048 或 3072、ECDSA P-256)。密钥一律用 openssl 在本机生成,私钥永不出服务器。

# 生成私钥,权限立刻收紧
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key

# 生成 CSR,主域名与 www 一起写进 SAN
openssl req -new -key example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Guangdong/L=Shenzhen/O=Example Tech Co.,Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

注意:现代浏览器早已不看 CN,只认 SAN 扩展。用 -addext 把主域名和 www 都写进 SAN,能避免大量 ERR_CERT_COMMON_NAME_INVALID。提交给 CA 前务必核对:

openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

有效期规则要提前告知客户,否则续期工单会反复出现:公共信任 CA 签发的单张证书有效期上限为 398 天(CA/Browser Forum 基线要求,2020 年 9 月起生效);按 SC-081 提案,2026-03-15 起降至 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。Let’s Encrypt 免费证书固定 90 天,必须依赖 ACME 自动续期,不能一年一换。

签发时效:DV 型走 DNS TXT 或 HTTP 文件验证,通常 10 分钟内签发;OV 型需核验企业工商信息并电话回拨,1–2 个工作日;EV 型还需核验企业电话(座机、DUNS 编号或百度信用留存的企业电话均可),同样 1–2 个工作日。需要说明的是,Chrome 79 之后已取消 EV 证书的绿色地址栏,EV 目前的价值在于合规准入与品牌背书,而非“更绿的锁”。

三、完整实操:Nginx 部署 SSL 证书的可执行步骤

以下命令在 CentOS 7+/Ubuntu 20.04+ 的 Nginx 1.18+ 上可直接执行。假设 CA 下发了 example.com.crt(服务器证书)、intermediate.crt(中间证书)和 example.com.key。

# 1. 备份现有配置,回滚靠它
cp -a /etc/nginx /etc/nginx.bak.$(date +%F)

# 2. 建立证书目录并收紧权限
mkdir -p /etc/nginx/ssl/example.com
cp example.com.crt intermediate.crt example.com.key /etc/nginx/ssl/example.com/
chmod 600 /etc/nginx/ssl/example.com/example.com.key

# 3. 合并完整链:服务器证书在前,中间证书在后
cat /etc/nginx/ssl/example.com/example.com.crt 
    /etc/nginx/ssl/example.com/intermediate.crt 
    > /etc/nginx/ssl/example.com/fullchain.pem

# 4. 校验证书与私钥是否匹配,两条 md5 必须完全一致
openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

# 5. 校验证书链
openssl verify -CAfile intermediate.crt example.com.crt

# 6. 语法检查 + 平滑重载(不要 restart)
nginx -t && systemctl reload nginx

端口与防火墙同步处理:云厂商安全组放行入方向 443;本机执行 firewall-cmd --permanent --add-service=https && firewall-cmd --reload;若开启 SELinux,需允许 Nginx 读取证书目录,否则会出现权限类加载失败:

semanage fcontext -a -t httpd_sys_content_t "/etc/nginx/ssl(/.*)?"
restorecon -Rv /etc/nginx/ssl

整套动作的核心只有三条:链要全、私钥要对、进程要重载。任何一步跳过,最终都会在浏览器里变成一句难以定位的报错。配置完成后建议立刻用 nginx -T | grep ssl_certificate 确认加载的是哪份文件,多站点服务器上最容易配错的就是这一行。

四、配置示例:Nginx / Apache / Tomcat 三套模板

Nginx(推荐,含 HTTP 跳转、HSTS、OCSP Stapling):

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

    ssl_certificate     /etc/nginx/ssl/example.com/fullchain.pem;
    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;
    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/intermediate.crt;
    resolver 223.5.5.5 1.1.1.1 valid=300s;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    root /var/www/example;
    index index.html;
}

Apache 2.4(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/example.com.key
    # 2.4.8 之前需单独指定:SSLCertificateChainFile .../intermediate.crt
    SSLProtocol           all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite        ECDHE+AESGCM:ECDHE+CHACHA20:!aNULL:!MD5
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

Tomcat(PEM 转 PKCS12 再转 JKS):

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -out example.com.p12 -name tomcat -passout pass:Changeit123
keytool -importkeystore -srckeystore example.com.p12 -srcstoretype PKCS12 
  -srcstorepass Changeit123 -destkeystore example.com.jks -deststoretype JKS 
  -deststorepass Changeit123 -destkeypass Changeit123 -alias tomcat
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" scheme="https" secure="true"
           keystoreFile="/opt/tomcat/conf/example.com.jks"
           keystorePass="Changeit123" alias="tomcat"
           sslProtocol="TLS" sslEnabledProtocols="TLSv1.2,TLSv1.3" />

五、对比表格:验证等级、覆盖范围与文件格式

选型混乱是返工的主要来源。下表按验证等级横向对比,签发时效与验证方式均以当前主流 CA 实践为准:

类型 验证内容 签发时效 浏览器表现 典型场景
DV 仅验证域名控制权(DNS TXT / HTTP 文件) 约 10 分钟 锁图标 博客、测试环境、内部系统
OV 域名 + 企业工商信息核验 + 电话回拨 1–2 个工作日 锁图标,证书详情含企业名 企业官网、SaaS 平台
EV OV 基础上加验企业电话(座机 / DUNS / 信用平台留存号码) 1–2 个工作日 锁图标(绿色地址栏已于 Chrome 79 取消) 金融、支付、招投标合规
Let’s Encrypt ACME 域名验证,有效期 90 天 分钟级,可自动续期 锁图标 中小站点、容器化集群

覆盖范围与文件格式同样要对齐,否则会出现“证书买了却用不上”:

维度 类型 说明
覆盖范围 单域名 只保护 example.com,www 需另配
覆盖范围 多域名 SAN 一张证书保护 5–100 个不同域名,适合多站点
覆盖范围 通配符 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com
文件格式 PEM (.crt/.pem) Base64 文本,Nginx/Apache 使用
文件格式 PKCS12 (.pfx) 含证书 + 私钥 + 链,Windows/IIS 导入
文件格式 JKS Java 体系,Tomcat/JBoss 使用

一句话选型:只有域名控制权就选 DV;需要展示企业主体、过合规审计选 OV/EV;子域数量多且命名规则固定选通配符,否则用 SAN 多域名更省钱。

六、常见错误排查:真实报错与对应修复

下面这些报错全部来自实际工单,可直接按“报错原文”对号入座:

报错原文 根因 修复动作
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied) 路径错误或 SELinux/权限拦截 核对路径,chmod 600 私钥,执行 restorecon -Rv /etc/nginx/ssl
SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 证书与私钥不配对 用 modulus md5 比对,重签 CSR 或找回原私钥
curl: (60) SSL certificate problem: unable to get local issuer certificate 未发送中间证书 服务器证书 + 中间证书合并为 fullchain.pem 后重载
NET::ERR_CERT_COMMON_NAME_INVALID SAN 不含当前域名 重新签发含 www/裸域的 SAN 证书,或做 301 统一域名
SSL_ERROR_NO_CYPHER_OVERLAP 协议或套件不兼容(老客户端只支持 TLS 1.0) 确需兼容时临时放开 TLSv1.1,并同步推动客户端升级
AH01909: RSA certificate configured for example.com:443 does not include an ID which matches the server name Apache ServerName 与证书域名不符 修正 VirtualHost 的 ServerName,或改用 SNI 独立配置
Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure element 'http://example.com/a.jpg' 页面硬编码 http 资源 改相对协议 // 或全站 https,配合 CSP upgrade-insecure-requests
urn:ietf:params:acme:error:unauthorized ACME 验证失败,80 端口不可达或被 CDN 拦截 放行 80,或改用 DNS-01 验证 certbot certonly --manual --preferred-challenges dns

排查顺序建议固定为:先 nginx -t 看语法 → 再 openssl s_client 看链 → 再 curl -vI 看握手 → 最后开浏览器控制台看混合内容。跳过前两步直接改配置,往往越改越乱。

七、效果验证:命令行自检与到期监控

部署完成后必须做四项验证,缺一不可:

# 1. 状态码与 HSTS 头
curl -sSI https://example.com | head -n 8

# 2. 证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 3. 实际协商的协议与套件(确认已禁用 TLS 1.0/1.1)
openssl s_client -connect example.com:443 -servername example.com -tls1_2 &1 | grep -E "Protocol|Cipher"

# 4. 全量枚举支持的协议与加密套件
nmap --script ssl-enum-ciphers -p 443 example.com

预期结果:HTTP 返回 301 跳转;证书 issuer 为对应 CA 的中间证书名而非根证书;TLS 1.3 握手成功;nmap 输出中不出现 SSLv3、TLSv1.0。在线复检推荐 Qualys SSL Labs,目标评级 A 及以上;开启 HSTS 且链完整通常可拿到 A+。

证书过期是最容易被忽视的故障,建议在监控里加一条到期告警脚本:

#!/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 30 ] && echo "WARN: $DOMAIN 证书剩余 ${left} 天" | mail -s "SSL 到期告警" ops@example.com

最后别忘了混合内容自检:打开浏览器控制台,过滤 Mixed Content,凡是仍在请求 http:// 的图片、脚本、字体,都要在程序侧改成 https 或相对路径,否则“页面错乱”会一直存在——这部分属于程序改造,不是证书配置能解决的。

常见问题

先执行 openssl s_client -connect 域名:443 -servername 域名 -showcerts </dev/null,看 Verify return code 是否为 0、subjectAltName 是否含当前域名、日期是否有效。返回码非 0 多为缺中间证书,SAN 不含域名则是证书不匹配,两条命令即可定位 90% 的问题。


典型是证书链不完整。桌面 Chrome 会缓存并自行补全中间证书,而 Android、curl、Java 严格按服务器发送的链校验,缺中间 CA 就报 unable to get local issuer certificate。把服务器证书与中间证书合并成 fullchain.pem 后重载即可。


不能,90 天是 Let's Encrypt 的固定策略,公共 CA 单张证书上限也已收紧到 398 天并继续缩短。正确做法是用 certbot 或 acme.sh 配置自动续期,加一条 systemd timer 或 cron,并用 certbot renew –dry-run 验证续期链路可用。


不是。这是混合内容(Mixed Content):页面里仍硬编码 http:// 的图片、CSS、JS,浏览器在 HTTPS 下会拦截。需联系程序商把资源地址改为 https 或相对协议 //,也可临时加 CSP 指令 upgrade-insecure-requests 自动升级请求。


用 SNI 多虚拟主机:Nginx 为每个域名配置独立 server 块与各自的 ssl_certificate,Apache 用多个 VirtualHost 加 ServerName 区分,Tomcat 用不同 Connector 或前置 Nginx 代理。SNI 已被所有现代浏览器支持,老客户端可单独保留默认站点证书兜底。


只能覆盖一级子域。*.example.com 匹配 a.example.com、b.example.com,但不匹配 example.com 本身,也不匹配 a.b.example.com。实际部署通常采用通配符 + 单域名 SAN 组合,或在证书 SAN 列表中显式列出裸域,避免主站访问告警。

内容审核

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