跳到主要内容
ssl证书按装

腾讯云 SSL 证书安装配置全流程:Nginx/Apache/Tomcat/IIS 部署与 HTTPS 报错排查

腾讯云 SSL 证书安装配置全流程:Nginx/Apache/Tomcat/IIS 部署与 HTTPS 报错排查 — 腾讯云 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 完全一致。

内容审核

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