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 列表中显式列出裸域,避免主站访问告警。