SSL/TLS 证书安装部署全攻略:Nginx、Apache、Tomcat、IIS 与宝塔面板实操配置与排错
问题背景与根因:证书装完了,为什么浏览器还是提示不安全
大量“HTTPS 证书安装部署”工单的真实原因并不是证书本身有问题,而是部署环节的三类失误:证书链不全、私钥与证书不匹配、页面存在混合内容。先定位根因,比反复重装证书有效得多。
根因一:证书链不完整。服务器只下发了域名证书(leaf certificate),没有附带中间证书(intermediate CA)。桌面浏览器能通过 AIA 扩展自动补链,所以 PC 上看起来正常;但 Android、微信内置浏览器、Java 客户端、curl、Python requests 一律报错:
curl: (60) SSL certificate problem: unable to get local issuer certificate
根因二:私钥与证书不配套。同一域名重新签发后,旧的 .key 还留在服务器上,Nginx 直接启动失败:
nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
根因三:混合内容(Mixed Content)。页面本身走 HTTPS,但引用的 js、css、img、字体、接口仍是 http://。Chrome 自 2020 年起默认把被动混合内容升级为 https 请求,升级失败即静默阻断,控制台输出:
Mixed Content: The page at 'https://www.example.com/' was loaded over HTTPS, but requested an insecure element 'http://cdn.example.com/a.js'. This request has been blocked.
此外有两个事实已经过时,必须纠正:其一,Chrome 70 之后地址栏不再显示绿色“安全”字样,Chrome 77 之后 EV 证书也不再显示绿色公司名,所谓“小绿锁”只是灰色锁形图标,判断 HTTPS 是否生效请看锁形图标与开发者工具的安全面板;其二,公开信任的 TLS 证书最长有效期自 2020 年 9 月起为 398 天,Let’s Encrypt 为 90 天,并按 CA/Browser Forum SC-081 计划,2026 年 3 月 15 日起缩短到 200 天、2027 年 3 月 15 日起 100 天、2029 年 3 月 15 日起 47 天。手工续期必然不可持续,部署时必须同步规划自动化。
准备阶段:CSR、私钥与证书文件清单
不同服务器接受的证书格式不同,先理清文件再动手。常见文件与用途:
| 文件 | 内容 | 使用场景 |
|---|---|---|
example.com.key |
私钥(PEM) | 所有环境,权限必须 600 |
example.com.crt |
域名证书(leaf) | 不能单独使用,需配链 |
chain.crt / ca-bundle |
中间证书 | OCSP Stapling、Apache 2.4.8 以前 |
fullchain.crt |
域名证书 + 中间证书 | Nginx / Apache 2.4.8+ 首选 |
example.com.pfx / .p12 |
PKCS#12(含私钥) | IIS、Tomcat、Java 客户端 |
example.com.csr |
证书签名请求 | 仅签发时提交给 CA |
生成私钥与 CSR(RSA 2048 或 ECC P-256,后者握手更快、包更小):
# RSA
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech/CN=example.com"
# ECC(推荐)
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -sha256 -out example.com.csr -subj "/CN=example.com"
CSR 中的 CN 只能写一个域名,多域名与通配符全靠 SAN 扩展,签发时必须一并提交 example.com、www.example.com、api.example.com。注意通配符 *.example.com 只覆盖一级子域,既不覆盖 a.b.example.com,也不自动覆盖裸域 example.com。
拿到证书后做三项校验,缺一不可:
# 1. 合并完整链
cat example.com.crt intermediate.crt > fullchain.crt
# 2. 私钥与证书是否匹配(RSA)
openssl x509 -noout -modulus -in example.com.crt | openssl sha256
openssl rsa -noout -modulus -in example.com.key | openssl sha256
# 3. 查看 SAN 与有效期
openssl x509 -in example.com.crt -noout -subject -issuer -dates -ext subjectAltName
# 4. 权限收敛
install -m 600 example.com.key /etc/nginx/ssl/example.com.key
install -m 644 fullchain.crt /etc/nginx/ssl/fullchain.crt
Nginx 部署实操
Nginx 要求 ssl_certificate 指向的文件里同时包含域名证书与中间证书(顺序:域名证书在前,中间证书在后),否则部分客户端校验失败。完整配置如下(Nginx ≥ 1.25.1 用 http2 on;,旧版写 listen 443 ssl http2;):
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt;
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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384: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.crt;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
root /var/www/example;
index index.html;
}
改完必须先测试再重载,直接 restart 会把语法错误变成线上故障:
nginx -t && systemctl reload nginx
免费证书推荐用 certbot 全自动签发与续期,它同时完成 80 端口校验和配置写入:
apt install -y certbot python3-certbot-nginx
certbot --nginx -d example.com -d www.example.com --agree-tos -m ops@example.com --redirect
systemctl list-timers | grep certbot # 确认续期定时器已启用
certbot renew --dry-run # 演练续期,务必执行一次
注意 ssl_stapling on 必须配合 ssl_trusted_certificate 指向中间证书,否则 Nginx 报 ssl_stapling_init_cert: can't retrieve issuer certificate,OCSP Stapling 静默失效。
Apache 部署实操
Apache 2.4.8 之后支持把中间证书直接拼在 SSLCertificateFile 指向的文件里;更早版本必须用 SSLCertificateChainFile 单独指定,否则移动端报链不完整。先确认模块已加载:
dnf install -y mod_ssl # RHEL / CentOS
# a2enmod ssl # Debian / Ubuntu
虚拟主机配置:
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
DocumentRoot /var/www/example
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache 2.4.8 之前必须额外配置:
# SSLCertificateChainFile /etc/httpd/ssl/chain.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
SSLHonorCipherOrder off
SSLSessionTickets off
SSLUseStapling on
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
校验并平滑重载(服务名在 RHEL 系是 httpd,Debian 系是 apache2):
apachectl configtest # 等价 httpd -t,输出 Syntax OK 才继续
systemctl reload httpd
两个高频坑:私钥若带密码保护,启动时报 AH02564: Failed to configure encrypted (?) private key,需先解密 openssl rsa -in enc.key -out example.com.key;若开启 Stapling 但没配链文件,日志持续输出 AH02217: ssl_stapling_init_cert: can't retrieve issuer certificate!。
Tomcat、IIS 与宝塔面板部署
Tomcat(Java 系)需要先转成 PKCS#12,再在 server.xml 中通过 SSLHostConfig 引用。Tomcat 8.5 起 keystoreFile、keystorePass 属性已废弃,继续使用会告警甚至不生效:
openssl pkcs12 -export -in fullchain.crt -inkey example.com.key
-certfile chain.crt -name tomcat -out example.com.p12
keytool -list -v -keystore example.com.p12 -storetype PKCS12 | grep -i "owner|valid"
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" maxThreads="200" scheme="https" secure="true">
<SSLHostConfig protocols="TLSv1.2,TLSv1.3">
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.com.p12"
certificateKeystorePassword="changeit"
certificateKeystoreType="PKCS12" type="RSA" />
</SSLHostConfig>
</Connector>
IIS:在 certlm.msc(本地计算机 → 个人 → 证书)导入 .pfx,勾选“允许导出私钥”以便后续备份;中间证书必须单独导入“中间证书颁发机构”存储区,否则 Android 与 Java 客户端校验失败。然后站点 → 绑定 → 添加 https / 443 → 选择证书。强制跳转用 URL Rewrite 模块配置 301 规则。
宝塔面板:网站 → 设置 → SSL → 其他证书,把 fullchain.crt 全文粘贴到“证书(PEM 格式)”,把 example.com.key 全文粘贴到“私钥(KEY 格式)”,保存后打开“强制 HTTPS”。文件落盘路径为 /www/server/panel/vhost/cert/example.com/,可用 tail -f /www/server/panel/vhost/nginx/example.com.conf 核对写入结果。phpstudy、WDCP 等同理:面板粘贴 PEM 时必须含中间证书,只贴域名证书是移动端报错的头号原因。
各环境方案对比与选型
同一张证书在不同环境的落地方式差异很大,下表可直接用于选型与排期:
| 环境 | 证书文件 | 关键配置 | 生效命令 | 典型坑点 |
|---|---|---|---|---|
| Nginx | fullchain.crt + key | ssl_certificate |
nginx -t && systemctl reload nginx |
链必须合并在证书文件内 |
| Apache | fullchain.crt + key | SSLCertificateFile |
apachectl configtest |
2.4.8 前需 SSLCertificateChainFile |
| Tomcat | .p12 / .jks | SSLHostConfig |
重启 Tomcat | 8.5 后 keystoreFile 废弃 |
| IIS | .pfx | 站点绑定 443 | 无需重载 | 中间证书要单独导入 |
| 宝塔/phpstudy | 粘贴 PEM + KEY | 面板 SSL 页 | 面板自动 reload | PEM 必须含中间证书 |
| CDN | 上传证书 + 私钥 | 回源协议改 HTTPS | 边缘节点分钟级生效 | 源站也要装证书,否则回源裸奔 |
| 虚拟主机 | 提供商代装 | 控制面板 | 由服务商操作 | 需 SNI 或独立 IP 支持 |
证书类型的选择同样影响成本与审核周期:
| 类型 | 验证方式 | 签发时长 | 有效期上限 | 适用场景 |
|---|---|---|---|---|
| DV | DNS / 文件校验 | 分钟级 | 398 天 | 个人站、API、内部测试 |
| OV | 企业资质核验 | 1–3 工作日 | 398 天 | 企业官网、电商 |
| EV | 严格主体核验 | 3–7 工作日 | 398 天 | 金融、政企(地址栏已无绿色标识) |
| Let’s Encrypt | ACME 自动校验 | 分钟级 | 90 天(可选 6 天短周期) | 可自动化的所有场景 |
结论很明确:只要具备 shell 权限,优先 Let’s Encrypt + certbot 自动化;不具备 shell 权限的虚拟主机或需要 OV/EV 主体的场景,再选商业证书,并把到期监控写进运维流程。通配符证书适合子域数量多且频繁变动的业务,单域证书则在成本与吊销影响面上更可控。
常见错误排查(真实报错对照)
| 报错信息 | 根因 | 处理 |
|---|---|---|
NET::ERR_CERT_AUTHORITY_INVALID |
自签证书或证书链不全 | 部署 fullchain,确认中间证书正确 |
NET::ERR_CERT_COMMON_NAME_INVALID |
域名不在 SAN 列表中 | 重新签发并补全 SAN |
NET::ERR_CERT_DATE_INVALID |
证书过期或服务器时间漂移 | 续签;timedatectl set-ntp true |
SSL_ERROR_BAD_CERT_DOMAIN |
访问域名与证书不匹配 | 检查 server_name 与 SNI 分流 |
curl: (60) unable to get local issuer certificate |
缺中间证书 | 合并 fullchain.crt |
curl: (35) ... sslv3 alert handshake failure |
客户端仅支持 TLS 1.0/1.1,服务端已禁用 | 升级客户端;临时保留 TLSv1.2 兼容 |
nginx: [emerg] ... key values mismatch |
私钥与证书不配套 | 用 modulus 比对,替换为新私钥 |
AH02564: Failed to configure encrypted (?) private key |
私钥带口令 | openssl rsa -in enc.key -out example.com.key |
Job for nginx.service failed because the control process exited with error code |
配置语法或路径错误 | 先跑 nginx -t 看具体行号 |
Type: unauthorized ... Invalid response from http://example.com/.well-known/acme-challenge/xxx: 404 |
80 端口被安全组拦截或伪静态规则拦截 | 放行 80;在 Nginx 中为 /.well-known/ 加 location 白名单 |
too many failed authorizations recently |
Let’s Encrypt 失败限流 | 等待 1 小时后重试,先用 --dry-run 验证 |
混合内容排查建议直接开浏览器开发者工具 Console 面板,或临时下发 Content-Security-Policy: upgrade-insecure-requests 观察是否仍有阻断;根治办法是把模板里所有 http:// 硬编码改成协议相对或 https 绝对地址,并对 CDN 域名一并启用 HTTPS。
证书链排查一条命令即可定位缺失环节:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl crl2pkcs7 -nocrl -certfile /dev/stdin | openssl pkcs7 -print_certs -noout
输出应当包含“域名证书 + 至少一张中间证书”。只有一项,就是链不全。
效果验证:命令行与在线检测
部署完成后按下面五步验收,全部通过才算交付:
# 1. 握手并查看证书主体、签发者、有效期、SAN
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 2. 协议能力:TLS 1.1 应失败,TLS 1.3 应成功
openssl s_client -connect example.com:443 -tls1_1 </dev/null
openssl s_client -connect example.com:443 -tls1_3 </dev/null
# 3. HTTP 到 HTTPS 跳转与 HSTS 头
curl -sSI http://example.com | head -n 5
curl -sSI https://example.com | grep -i strict-transport-security
# 4. 证书剩余天数监控(建议接入 Zabbix/Prometheus)
end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
left=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
echo "剩余 $left 天"
[ "$left" -lt 21 ] && echo "WARN: 证书即将过期" && exit 1
第 3 步期望看到 HTTP/1.1 301 与 location: https://example.com/,以及 strict-transport-security: max-age=31536000。第 1 步中若 issuer 为自签主体,说明仍在用测试证书。
再配合在线检测收尾:SSL Labs(https://www.ssllabs.com/ssltest/)目标评级 A 及以上,出现“Chain issues: Incomplete”即链不全;HSTS Preload 站点可校验提交资格;myssl.com 可快速检查是否支持 TLS 1.3、是否兼容 Android 4.x 老客户端。验收通过后,把续期任务(certbot timer 或面板自动续签)纳入监控告警,才算真正完成“SSL 证书安装部署配置”闭环。
常见问题
虚拟主机、共享空间可以安装 SSL 证书吗?
可以,但取决于主机商是否支持 SNI(现代共享主机基本都支持)。多数控制面板没有证书上传入口,需要联系客服手工部署,或在面板的“SSL”页粘贴证书与私钥。若主机只提供共享 IP 且不支持 SNI,则无法为自有域名启用 HTTPS,只能更换套餐或迁移到云服务器。
网站使用了 CDN 还能装 SSL 证书吗?
能,而且要装两张:一张上传到 CDN 用于“用户 ↔ CDN 边缘节点”加密,一张装在源站用于“CDN ↔ 源站”回源加密,否则回源段仍是明文。主流 CDN(含阿里云、腾讯云)免费版已支持上传自定义证书与 HTTPS 回源,但通配符证书与多域名证书的支持范围各家不同,购买前需确认证书类型限制。
证书安装好浏览器为什么不显示“小绿锁”?
因为绿色地址栏已被移除:Chrome 70 起不再显示“安全”绿字,Chrome 77 起 EV 证书也不再显示绿色公司名。现在只需确认地址栏出现锁形图标、点击后显示“连接是安全的”,且开发者工具 Security 面板无混合内容警告即可。若仍报不安全,99% 是页面里残留 http:// 资源或证书链不全。
证书会被吊销吗?正常使用会不会突然失效?
正常使用不会。CA 只在几种情况下吊销:私钥泄露、域名所有权变更、主体信息造假、用于钓鱼或诈骗等违法用途、以及违反 CA/Browser Forum 基线要求。因 CA 自身合规问题导致的证书不受信任,正规 CA 会免费重签。建议保留私钥权限 600、开启证书透明度(CT)监控,可第一时间发现异常签发。
免费证书和付费证书差在哪里?
加密强度完全一致,差别在验证等级、有效期、赔付条款与技术支持。Let’s Encrypt 等免费证书均为 DV,有效期 90 天,必须自动化续期;付费证书可提供 OV/EV 主体核验、通配符与多域名 SAN 打包、商业保险赔付和中文工单支持。纯技术角度,能自动化的站点用免费证书更划算;需要向客户展示主体资质或没有 shell 权限的场景选付费。
证书到期如何做到自动续签?
Let’s Encrypt 用 certbot renew --dry-run 验证续期链路,确认 systemctl list-timers | grep certbot 中定时器已激活,并在 /etc/letsencrypt/renewal-hooks/deploy/ 放置重载脚本(如 systemctl reload nginx)。商业证书目前仍需手工重签再替换文件,建议把上文那段“剩余天数”脚本接入监控,阈值设为 21 天,并在证书有效期缩短至 100 天、47 天的新规生效前完成 ACME 化改造。