腾讯云 SSL 证书安装配置全流程:Nginx/Apache/Tomcat/IIS 部署与 HTTPS 报错排查
一、问题背景与根因:浏览器为什么提示“不安全”
网站地址栏出现“不安全”红色警告,本质是浏览器与服务器之间仍走 HTTP 明文,或 TLS 握手阶段校验失败。TLS 握手时,服务器必须下发一张由受信任 CA 签发、域名匹配、且在有效期内的证书,并附带完整的中间证书链,浏览器才会显示锁形图标。
常见根因有五类:① 只监听 80 端口,未配置 443;② 证书链不完整,只部署了站点证书而缺少中间 CA,腾讯云 Nginx 包里的 xxx_bundle.crt 就是已拼接好的完整链;③ 证书过期,目前公开信任的付费证书最长有效期被限制为 398 天,Let’s Encrypt 与腾讯云免费 DV 证书均为 90 天,必须做自动续期;④ 证书绑定域名与实际访问域名不一致,例如申请了 a.example.com 却用 www.example.com 访问;⑤ 页面内仍引用 http:// 的图片、JS、CSS,触发混合内容(Mixed Content)拦截。
排查顺序建议:先用 curl -I https://your-domain.com 确认是否返回 200;再用 openssl s_client 检查证书链是否完整;最后看浏览器 F12 控制台是否有 Mixed Content 报错。三步定位,基本可以覆盖 90% 的“不安全”场景。
二、申请与下载证书:腾讯云控制台操作与 CSR 生成
登录腾讯云 SSL 证书控制台,申请免费 DV 证书并填写域名。通配符证书填 *.example.com,可覆盖同一主域下一级所有子域,不限个数;单域名证书填 ssl.example.com,只保护该主机名。验证方式选 DNS 验证(在域名解析中添加一条 TXT 记录)或文件验证(把指定文件放到站点根目录的 /.well-known/pki-validation/),DV 证书一般 10 分钟内签发。
如需自建 CSR(OV/EV 证书或迁移场景):
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key
-out example.com.csr
-subj "/C=CN/ST=Guangdong/L=Shenzhen/O=Example/CN=example.com"
下载时按服务器类型选择格式:Nginx 选 Nginx 格式(.crt + .key),Apache 选 Apache 格式(含站点证书、私钥、CA 链共 3 个文件),Tomcat 选 JKS,IIS 选 PFX(下载弹窗中的密码即 PFX 密码)。下载后务必本地核对:
openssl x509 -in example.com_bundle.crt -noout -subject -issuer -dates
openssl rsa -in example.com.key -check
前者输出证书主题、签发者与 notBefore/notAfter,后者校验私钥是否损坏。注意 openssl x509 读取 bundle 时只显示第一张证书,需拆分文件或用 -text 确认中间证书确实在内。
三、Nginx SSL 证书配置(含完整可执行示例)
先把证书上传到统一目录并收紧私钥权限:
mkdir -p /etc/nginx/ssl
cp example.com_bundle.crt /etc/nginx/ssl/
cp example.com.key /etc/nginx/ssl/
chmod 600 /etc/nginx/ssl/example.com.key
完整 server 配置:
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/example.com_bundle.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;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
add_header Strict-Transport-Security "max-age=31536000" always;
root /var/www/html;
index index.html index.php;
}
关键点:ssl_certificate 必须指向含中间证书的 bundle 文件,顺序为“站点证书 → 中间 CA”,顺序颠倒会导致部分 Android 客户端握手失败。校验并热加载:
nginx -t
systemctl reload nginx # 或 nginx -s reload
只有 nginx -t 输出 syntax is ok 与 test is successful 才可继续;务必用 reload 而非 restart,避免中断在线连接。
四、Apache 与 Tomcat SSL 证书配置
Apache 需要三段式配置,SSLCertificateChainFile 指向 CA 链文件:
<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/example.com_chain.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Apache 2.4.8 及以上可把 SSLCertificateFile 直接指向 fullchain 文件并省略 SSLCertificateChainFile。生效命令:CentOS 用 httpd -t && systemctl reload httpd,Debian/Ubuntu 用 apachectl -t && systemctl reload apache2。
Tomcat 需先把 PFX 转成 JKS:
keytool -importkeystore -srckeystore example.com.pfx -srcstoretype PKCS12
-srcstorepass 下载密码 -destkeystore example.com.jks
-deststoretype JKS -deststorepass 新密码 -destkeypass 新密码
然后修改 conf/server.xml:
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="200" SSLEnabled="true" scheme="https" secure="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="/opt/tomcat/conf/example.com.jks"
certificateKeystorePassword="新密码" type="RSA"/>
</SSLHostConfig>
</Connector>
Tomcat 8.5 以下使用 keystoreFile/keystorePass 属性,配置后需 systemctl restart tomcat 才能生效。
五、IIS SSL 证书导入与站点绑定
IIS 不能直接使用 .crt/.key,必须导入含私钥的 PFX。推荐用管理员 PowerShell 导入到“本地计算机 → 个人”证书存储:
Import-PfxCertificate -FilePath C:sslexample.com.pfx
-CertStoreLocation Cert:LocalMachineMy
-Password (ConvertTo-SecureString -String 'pfx密码' -AsPlainText -Force)
随后打开 IIS 管理器 → 目标站点 → 右侧“绑定” → 添加 → 类型选 https、端口 443、SSL 证书选择刚导入的证书,并勾选“需要服务器名称指示”(SNI),这样同一 IP:443 可承载多个站点证书。
验证与解绑命令:
netsh http show sslcert
netsh http delete sslcert hostnameport=example.com:443
若导入后在证书下拉列表中看不到该证书,通常是 PFX 不含私钥,或导入时未选“本地计算机”而落到了“当前用户”存储;重新导出 PFX 时务必勾选“如果可能,则包括证书路径中的所有证书”和“导出私钥”。
六、四类 Web 服务器与证书类型对比
下表汇总四种主流环境的证书格式与生效命令,便于按现有架构选择:
| Web 服务器 | 推荐证书格式 | 关键配置项 | 校验与生效命令 |
|---|---|---|---|
| Nginx | .crt(bundle) + .key | ssl_certificate / ssl_certificate_key | nginx -t && systemctl reload nginx |
| Apache | .crt + .key + chain.crt | SSLCertificateFile / SSLCertificateChainFile | httpd -t && systemctl reload httpd |
| Tomcat | .jks 或 .pfx | certificateKeystoreFile / certificateKeystorePassword | systemctl restart tomcat |
| IIS | .pfx | 站点绑定 → HTTPS → 启用 SNI | netsh http show sslcert |
证书类型选择参考:
| 证书类型 | 保护范围 | 验证方式 | 有效期上限 | 适用场景 |
|---|---|---|---|---|
| 免费 DV 单域名 | 1 个具体域名 | DNS 或文件 | 90 天 | 个人站、测试环境 |
| DV 通配符 | *.example.com 一级子域不限 | DNS | 398 天 | 多子域业务 |
| OV 单域名/多域名 | 1 个或多个域名 | 组织验证 | 398 天 | 企业官网、后台 |
| EV 证书 | 同 OV | 严格组织验证 | 398 天 | 金融、支付类站点 |
注意:通配符证书不匹配二级子域,*.example.com 不覆盖 a.b.example.com;免费证书到期不会自动顺延,必须重新签发并重新部署。
七、常见错误排查:真实报错与定位方法
1)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)
用模数比对确认是否配对,两个 MD5 必须一致:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
2)curl 报证书链不完整:curl: (60) SSL certificate problem: unable to get local issuer certificate,说明缺少中间 CA,改用 bundle/fullchain 文件即可。
3)浏览器报 NET::ERR_CERT_DATE_INVALID:证书已过期,或服务器系统时间偏差过大,用 date -u 与 timedatectl 校时。
4)浏览器报 ERR_CERT_COMMON_NAME_INVALID:证书 SAN 列表不含当前访问域名,需重新签发或改用通配符证书。
5)Apache 报 AH02565: Certificate and PrivateKey ... do not match:同上,检查 crt 与 key 是否同批下载。
6)Tomcat 报 java.io.IOException: Keystore was tampered with, or password was incorrect:JKS 密码错误,重新执行 keytool 转换,确保 -deststorepass、-destkeypass 与 server.xml 中密码完全一致。
7)IIS 绑定报 0x80070520:证书私钥不可用或权限不足,用 certlm.msc 检查证书是否带钥匙图标,并为 NETWORK SERVICE 授予私钥读取权限。
八、效果验证与 HTTPS 加固检查
配置完成后按以下顺序验收,全部通过才算部署成功:
# 1. 查看实际下发的证书主题、签发者与有效期
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 验证证书链是否可信(返回 0 即通过)
curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com
# 3. 检查 80 端口是否 301 跳转到 443
curl -sI http://example.com | head -n 3
# 4. 检查 HSTS 响应头
curl -sI https://example.com | grep -i strict-transport-security
再用浏览器 F12 → Security 面板查看证书链是否为“完整”,并在 Console 搜索 Mixed Content 确认无 HTTP 资源残留。建议同时用 SSL Labs(ssllabs.com/ssltest)跑一次评级,TLS 1.2/1.3 + 强套件 + HSTS 通常可拿到 A 或 A+。
最后检查续期机制:免费证书 90 天到期,建议用 acme.sh 或 certbot 配置自动续期并加 --deploy-hook "systemctl reload nginx",或至少在日历中设置到期前 15 天提醒。
常见问题
目前腾讯云免费 DV 证书有效期为 90 天,到期前可在控制台重新申请,签发的是新证书,需重新下载部署。它不会自动延长同一张证书,建议配合脚本或日历提醒。
不能。*.example.com 只匹配 a.example.com 这一级,不匹配 a.b.example.com。若需覆盖多级,要单独申请 *.b.example.com,或在证书 SAN 中逐个列出具体域名。
先点锁图标看证书是否生效及有效期,再查 F12 控制台有无 Mixed Content 报错,最后确认 80 端口已 301 跳转到 443。三项正常仍报错,多为证书链缺中间 CA。
说明证书与私钥不配对。分别对 crt 和 key 执行 openssl 的 -modulus 后接 openssl md5,两个 MD5 必须一致;不一致就重新下载同批次的证书与私钥。
CA/B 论坛规定公开信任的 TLS 证书最长 398 天,Chrome、Safari 均按此执行;Let’s Encrypt 与腾讯云免费证书为 90 天,需配置自动续期避免过期。
多为 JKS 密码错误或 pfx 转换时密码不一致。重新执行 keytool -importkeystore,确保 -srcstorepass、-deststorepass、-destkeypass 与 server.xml 中 certificateKeystorePassword 完全一致。