HTTPS 配置 SSL 证书完整指南:Nginx/Apache/Tomcat 安装部署、证书链修复与排错
一、问题背景与根因:证书装上了,浏览器为何仍报“不安全”
绝大多数“HTTPS 配置 SSL 证书”故障,不是证书买错了,而是部署时证书链的某个环节断了。典型现场:运维把 CA 机构邮件里的 example.com.crt 上传到服务器,Nginx 重启成功,PC 端 Chrome 正常显示锁标,但安卓 App 内嵌 WebView、微信小程序、Java 客户端和 curl 全部握手失败。根因集中在以下几点:
- 证书链不完整:服务器只下发了叶子证书(服务器证书),没有下发中间 CA 证书。桌面浏览器支持 AIA(Authority Information Access)自动补链,移动端与多数 SDK 不会,于是报
unable to get local issuer certificate。 - 证书链顺序错误:正确顺序是“叶子证书 → 中间 CA”,根证书不要放进服务端文件(客户端本地已内置)。顺序颠倒会直接握手失败。
- 私钥与证书不匹配:续签后只替换了证书没换私钥,或从 A 服务器复制证书、从 B 服务器复制私钥。
- 域名不匹配:证书 SAN 只写了
example.com,实际访问www.example.com;或误以为泛域名*.example.com能覆盖a.b.example.com。 - 有效期问题:公有 TLS 证书单张最长有效期已被压缩到 398 天(2020 年 9 月起 Apple、Chrome 等强制实施),Let’s Encrypt 免费证书为 90 天。忘记续期是最常见的半夜告警来源。
- 协议与套件过时:只开 TLS 1.0/1.1 的站点在 Chrome 98+、iOS 15+ 上会被直接拒绝,必须启用 TLS 1.2/1.3。
- 混合内容:页面是 HTTPS,但内部引用了
http://的图片、JS、字体,浏览器仍判定“不安全”。 - 服务器时间偏差:容器或虚拟机未同步 NTP,导致
certificate has expired or is not yet valid。
下面按“准备 → Nginx → Apache/Tomcat → 选型对比 → 排错 → 验证”的顺序,给出一套可直接执行的 SSL 证书安装配置流程。
二、前置准备:CSR 生成、证书链拼接与私钥匹配校验
申请前先自建私钥和 CSR,推荐 RSA 2048 位或 ECDSA P-256,SHA-256 签名:
openssl req -new -newkey rsa:2048 -nodes -sha256
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 example.com.key
-addext 需要 OpenSSL 1.1.1 及以上版本;部分 CA 会忽略 CSR 中的 SAN 而以订单填写为准,下单时务必把主域名与 www 都填进 SAN。证书下发后先做三件事:拼链、验链、验私钥匹配。
# 1. 拼接完整链:叶子在前,中间 CA 在后(根证书不要放)
cat example.com.crt intermediate.crt > fullchain.pem
# 2. 查看主题/签发者/有效期/SAN
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -ext subjectAltName
# 3. 校验证书链(root.pem 为对应根证书)
openssl verify -CAfile root.pem -untrusted intermediate.crt example.com.crt
# 4. 校验私钥与证书是否配对,两条命令输出的 MD5 必须一致
openssl x509 -in example.com.crt -noout -modulus | openssl md5
openssl rsa -in example.com.key -noout -modulus | openssl md5
若私钥是 ECDSA,第 4 步改用 openssl ec -in example.com.key -noout -text 比对公钥点。证书若是 DER 格式(.cer/.der),先转 PEM:
openssl x509 -in cert.cer -inform DER -out cert.pem -outform PEM
Tomcat、IIS 需要 PKCS#12 容器时:
openssl pkcs12 -export -name tomcat -inkey example.com.key
-in fullchain.pem -certfile intermediate.crt
-out example.p12 -passout pass:changeit
建议把 fullchain.pem、example.com.key、chain.pem(仅中间 CA,供 OCSP stapling 使用)统一放到 /etc/nginx/ssl/,目录权限 700、私钥 600、属主 root。
三、Nginx 安装与 HTTPS 完整配置示例
先确认版本,1.25.1 起 http2 改为独立指令,旧写法会告警:
nginx -v
sudo apt install -y nginx # Debian/Ubuntu
sudo yum install -y nginx # RHEL/CentOS
sudo mkdir -p /etc/nginx/ssl && sudo chmod 700 /etc/nginx/ssl
新建 /etc/nginx/conf.d/example.conf:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+;旧版写 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/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_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
resolver 223.5.5.5 119.29.29.29 valid=300s ipv6=off;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
location / {
root /var/www/html;
index index.html;
}
}
生效前必须做语法与证书可读性检查,再平滑重载:
sudo nginx -t && sudo systemctl reload nginx
几个易踩点:ssl_certificate 必须指向 fullchain.pem 而非单张叶子证书;ssl_trusted_certificate 只放中间 CA,不能放叶子;HSTS 建议先设 max-age=300 试运行,确认全站无混合内容后再提升到 31536000;若 Nginx 跑在 Docker 里,证书挂载路径要与配置中的绝对路径一致。
四、Apache 与 Tomcat 的证书安装配置
Apache(httpd):确认 mod_ssl 已加载后,在 /etc/httpd/conf.d/ssl.conf 写入:
sudo yum install -y mod_ssl # Debian/Ubuntu: sudo a2enmod ssl
Listen 443 https
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
SSLHonorCipherOrder off
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
sudo apachectl configtest && sudo systemctl reload httpd
Apache 2.4.8+ 允许把中间证书直接追加到 SSLCertificateFile 指向的文件末尾,此时可省略 SSLCertificateChainFile。启用 SELinux 的机器上传证书后需修正上下文,否则 httpd 读不到文件。
Tomcat:先把 PEM 转成 PKCS#12,再修改 conf/server.xml:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-name tomcat -out /opt/tomcat/conf/example.p12 -passout pass:changeit
keytool -list -v -keystore /opt/tomcat/conf/example.p12 -storetype PKCS12
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="200" SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig protocols="TLSv1.2,TLSv1.3" sslProtocol="TLS">
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.p12"
certificateKeystoreType="PKCS12"
certificateKeystorePassword="changeit" />
</SSLHostConfig>
</Connector>
Tomcat 的 Connector 在进程启动时初始化 SSLContext,改完 server.xml 必须重启,reload 无效。若 80 端口需要跳转 443,可在应用 web.xml 中加 <security-constraint> + <transport-guarantee>CONFIDENTIAL</transport-guarantee>,或在前面挂 Nginx 做 301。
五、证书类型、格式与部署方式对比
选型决定了后续是 90 天还是 398 天动一次手,也决定移动端兼容性。按验证级别对比:
| 对比项 | DV 域名型 | OV 企业型 | EV 扩展验证 |
|---|---|---|---|
| 验证内容 | 仅验证域名控制权(DNS TXT / 文件 / 邮箱) | 域名 + 营业执照、电话回访 | 域名 + 严格企业身份核验 |
| 签发时长 | 1-10 分钟,可全自动 | 1-3 个工作日 | 3-7 个工作日 |
| 浏览器表现 | 锁标 | 锁标 | 锁标(Chrome 77+ 已不再显示绿色公司名) |
| 有效期上限 | 398 天(Let’s Encrypt 90 天) | 398 天 | 398 天 |
| 典型用途 | 个人站、测试环境、内部 API | 企业官网、电商 | 金融、政务等合规场景 |
按覆盖范围对比:
| 维度 | 单域名 | 通配符 | 多域名 SAN |
|---|---|---|---|
| 覆盖范围 | example.com 或 www.example.com | *.example.com(仅一级) | 一张证书可含多个不同主域 |
| 裸域是否覆盖 | 按订单填写 | 否,需额外加 SAN | 是,按需添加 |
| 适用场景 | 单一站点 | SaaS 多租户、大量同域子站 | 多品牌、多业务线 |
| 运维风险 | 续期分散,易漏 | 一张管全部子域,私钥泄露影响面大 | 变更影响所有绑定域名 |
格式与部署方式:PEM 适用于 Nginx、Apache、HAProxy;PKCS#12(.pfx/.p12)与 JKS 适用于 Tomcat、IIS 及 Java 应用。部署方式上,手工上传 + reload 适合少量站点;ACME 自动化(certbot / acme.sh + cron)适合 Let’s Encrypt 90 天证书;在负载均衡或 CDN 上终止 TLS 时,回源段建议同样启用 TLS 1.2+,否则内网仍存在明文风险。
六、常见错误排查:真实报错与处理办法
| 真实报错 | 根因 | 处理 |
|---|---|---|
curl: (60) SSL certificate problem: unable to get local issuer certificate |
服务端未下发中间证书 | 改用 fullchain.pem;临时测试可加 curl --cacert chain.pem |
NET::ERR_CERT_AUTHORITY_INVALID |
证书链不受信或为自签名 | 换受信 CA 证书并补全链,检查是否误放了根证书 |
NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN |
SAN 不含当前域名 | 重签证书把 www、裸域都写入 SAN |
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line) |
文件不是 PEM、含 BOM/CRLF,或误传 DER | openssl x509 -in cert.cer -inform DER -out cert.pem,再 dos2unix |
nginx: [emerg] SSL_CTX_use_PrivateKey(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) |
私钥与证书不配对 | 用 modulus md5 比对,替换为匹配的私钥 |
AH02572: Failed to configure at least one certificate and key for example.com:443 |
Apache 路径错、权限不足或 SELinux 拦截 | 核对路径,执行 restorecon -Rv /etc/httpd/ssl |
java.io.IOException: Keystore was tampered with, or password was incorrect |
Tomcat keystorePass 错误或类型不匹配 | 用 keytool -list -storetype PKCS12 验证口令与类型 |
sslv3 alert handshake failure |
客户端与服务端协议/套件无交集 | 确认客户端是否仅支持 TLS 1.0,评估兼容性后调整 ssl_protocols |
Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...' |
页面内引用 http 资源 | 资源改 https,或加 CSP upgrade-insecure-requests |
certificate has expired or is not yet valid |
证书过期或系统时间偏差 | chronyc makestep / ntpdate 校时,并检查续期任务 |
排错顺序建议:先用 openssl s_client 确认服务端实际下发的证书链,再判断是链问题、域名问题还是协议问题,最后才怀疑浏览器缓存。更换证书后记得清理本地 DNS 与浏览器缓存,多节点部署时逐个节点核对指纹:openssl x509 -in cert.pem -noout -fingerprint -sha256。
七、效果验证与上线检查清单
配置完成后,用命令行做客观验证,不依赖浏览器观感:
# 1. 查看服务端下发的证书链、协议与校验结果
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>&1 | grep -E 'Verify return code|Protocol|Cipher'
# 2. HTTP 状态与证书校验结果(0 表示校验通过)
curl -sS -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com
# 3. 确认已禁用 TLS 1.0/1.1(应握手失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 4. 确认 OCSP stapling 生效
openssl s_client -connect example.com:443 -status </dev/null 2>&1 | grep -i 'OCSP Response Status'
# 5. 确认 80 端口 301 与 HSTS 头
curl -sSI http://example.com | head -5
curl -sSI https://example.com | grep -i strict-transport-security
再加上一条到期监控脚本,避免 398 天/90 天到期无人知晓:
#!/bin/bash
end=$(echo | openssl s_client -servername example.com -connect example.com:443 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
left=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
echo "到期时间: $end,剩余 $left 天"
[ "$left" -lt 15 ] && echo "WARN: 证书即将到期"
上线检查清单:证书链完整且顺序正确;SAN 覆盖所有对外域名;TLS 1.2/1.3 已启用;HSTS 头已下发;无混合内容;续期任务已配置;监控已接入。可用第三方评测(如 SSL Labs)复核,目标评级 A 及以上;有条件时开启 OCSP stapling 与 TLS 1.3 的 0-RTT 需谨慎评估重放风险。
常见问题
按顺序查三点:一是服务器是否下发完整证书链,Nginx 的 ssl_certificate 必须指向 fullchain.pem 而非单张叶子证书;二是页面是否存在 http:// 混合内容,用 DevTools Console 看 Mixed Content 警告;三是证书 SAN 是否覆盖当前访问域名、是否在有效期内。三点排除后基本可定位。
公有 TLS 证书单张最长有效期 398 天(2020 年 9 月起 Apple、Chrome 等强制实施),Let’s Encrypt 免费证书为 90 天。因此必须建立自动续期机制,推荐用 certbot 或 acme.sh 配置定时任务在到期前 30 天续签,并接入到期监控告警,避免到期导致业务中断。
只覆盖同一级,例如 a.example.com、www.example.com;不覆盖裸域 example.com,也不覆盖两级域名 a.b.example.com。实际部署时通常把 example.com 作为 SAN 附加到通配符证书上,或单独申请一张单域名证书,否则会出现 ERR_CERT_COMMON_NAME_INVALID。
配 fullchain.pem,即“服务器证书 + 中间 CA 证书”按顺序拼接的文件,ssl_certificate_key 配对应私钥。不要只配叶子证书,移动端会校验失败;也不要把根证书拼进去。ssl_trusted_certificate 则单独指向中间 CA 链,用于 OCSP stapling 校验。
不需要。执行 nginx -t 校验配置语法与证书可读性,通过后 systemctl reload nginx 即可平滑加载新证书,不中断现有连接。Apache 用 apachectl configtest 加 systemctl reload httpd;Tomcat 修改 server.xml 后必须重启进程,因为 Connector 在启动时初始化 SSLContext。
在 Nginx 中单独建一个 listen 80 的 server 块,使用 return 301 https://$host$request_uri;Apache 用 Redirect permanent 或 RewriteRule 实现。跳转生效后再下发 Strict-Transport-Security 响应头,建议先用 max-age=300 试运行,确认全站无混合内容后再提升到 31536000。