跳到主要内容
ssl证书按装

腾讯云 SSL 证书配置全流程:Nginx、Tomcat、IIS 部署与排错实战

腾讯云 SSL 证书配置全流程:Nginx、Tomcat、IIS 部署与排错实战 — 腾讯云 SSL 证书配置全流程:Nginx、Tomcat、IIS 部署与排错实战

问题背景与根因:为什么腾讯云服务器必须部署 SSL 证书

Chrome、Edge、Firefox、Safari 均已把 HTTP 页面在地址栏标记为“不安全”;微信小程序的 wx.request 只接受 https 域名;HTTP/2 在主流浏览器中仅在 TLS 之上通过 ALPN 协商启用;Service Worker、地理位置、摄像头等 Web API 都要求安全上下文。也就是说,一台腾讯云 CVM 上跑的 Nginx、Tomcat 或 IIS,只要还监听 80 端口对外提供明文服务,就会在可用性、SEO 和用户信任三个维度同时失分。

证书部署完仍然报错,根因通常不是“证书没买对”,而是下面五类问题:

1. 证书链不完整——只上传了站点证书 www.example.com.crt,没有拼接中间 CA。桌面浏览器能靠 AIA 自动补链,Android 老版本和 Java 客户端直接握手失败。
2. 证书已过期——免费证书 90 天一张,忘记续期。
3. 域名不匹配——证书 SAN 里只有 www.example.com,用户访问 example.com 或 m.example.com 报错。
4. 私钥与证书不配对——重新签发后只换了 crt 没换 key。
5. 协议与套件过旧——服务端仍开启 TLSv1.0/1.1 或 RC4、3DES 套件,被现代浏览器拒绝。

另外,原文“默认提供有效期为一年的 SSL 证书”已经过时,需按现行规则修正:CA/Browser Forum 规定自 2020 年 9 月 1 日起,公有可信 TLS 证书单张最长有效期不得超过 398 天;Let’s Encrypt 免费证书为 90 天;腾讯云免费 DV 证书有效期同样是 90 天,付费证书按年售卖但单张有效期也不超过 398 天。规划续期自动化时请以 398 天和 90 天这两个数字为准,而不是 365 天。

证书选型、CSR 生成与腾讯云申请验证

选型看两个维度:验证等级与域名覆盖范围。

类型 验证方式 签发时长 地址栏展示 适用场景
DV 域名型 仅验证域名所有权(DNS / 文件) 1~10 分钟 锁标志 个人站、博客、小程序接口
OV 企业型 域名 + 企业工商信息核验 1~5 个工作日 锁标志 企业官网、SaaS 平台
EV 增强型 域名 + 企业 + 电话回访 3~7 个工作日 部分浏览器展示企业名 金融、电商、支付

域名覆盖分三类:单域名证书只保护一个 FQDN;多域名证书(SAN/UCC)默认 3~5 个并可扩展;通配符证书 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。需要同时保护主域名与泛域名时,买“通配符 + 单域名”组合,或改用多域名证书把各级域名全部写进 SAN。

CSR 建议在服务器本地生成,私钥不出机器:

openssl req -new -newkey rsa:2048 -nodes -keyout www.example.com.key -out www.example.com.csr -subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example Tech/CN=www.example.com'
openssl req -in www.example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
chmod 600 www.example.com.key

腾讯云控制台 → SSL 证书 → 申请证书,验证方式选 DNS。按控制台给出的主机记录(形如 _dnsauth.www,开头下划线不能漏)添加 TXT 记录,TTL 建议 600 秒,然后本地校验:

dig TXT _dnsauth.www.example.com +short
nslookup -qt=txt _dnsauth.www.example.com 8.8.8.8

记录值本身带双引号,复制时别把多余空格带进去。DV 证书验证通过后 1~10 分钟签发;OV/EV 需人工审核,期间 CA 可能致电企业注册电话。若 DNS 验证反复失败,改用文件验证:把控制台给的文件放到 /.well-known/pki-validation/ 目录下,确保公网可直接访问且返回 200、Content-Type 为 text/plain。签发后在“下载”里按服务器类型取包:Nginx/Apache 得到 .crt(已含中间链)与 .key,Tomcat 得到 .jks 与 keystorePass.txt,IIS 得到 .pfx。

Nginx 服务器证书安装与完整配置示例

上传文件到 /etc/nginx/ssl/,权限收紧到 600,然后写两个 server 块:80 强制跳转,443 承载业务。

mkdir -p /etc/nginx/ssl
cp www.example.com_bundle.crt www.example.com.key /etc/nginx/ssl/
chmod 600 /etc/nginx/ssl/www.example.com.key
chown -R nginx:nginx /etc/nginx/ssl
server {
    listen 80;
    server_name www.example.com example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    http2 on;                      # nginx 1.25.1+ 写法;旧版本写 listen 443 ssl http2;
    server_name www.example.com;

    ssl_certificate     /etc/nginx/ssl/www.example.com_bundle.crt;
    ssl_certificate_key /etc/nginx/ssl/www.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 10m;
    ssl_session_tickets off;

    ssl_stapling on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/www.example.com_bundle.crt;
    resolver 183.60.83.19 183.60.82.98 valid=300s;

    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    add_header X-Content-Type-Options nosniff always;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

改完先 nginx -t 再 nginx -s reload。若腾讯云负载均衡 CLB 已卸载 TLS,后端 Nginx 只监听 80,此时不要重复配置 443,但必须保证应用能正确读取 X-Forwarded-Proto,否则后端生成的重定向链接会退回 http,形成跳转死循环。另需注意 ssl_stapling 的 resolver 必须填内网可达的 DNS,填 8.8.8.8 在部分可用区会被拦截,导致 OCSP 校验超时。

Tomcat 服务器证书安装:JKS 导入与 Connector 配置

Tomcat 只认 JKS / PKCS12 密钥库。腾讯云下载包里直接有 www.example.com.jks 与 keystorePass.txt;如果手上是 IIS 用的 .pfx,用 keytool 转换:

keytool -importkeystore -srckeystore www.example.com.pfx -srcstoretype PKCS12 -srcstorepass 原密码 -destkeystore www.example.com.jks -deststoretype JKS -deststorepass 自定义强密码 -destkeypass 自定义强密码
keytool -list -v -keystore www.example.com.jks -storepass 自定义强密码 | grep -E 'Alias|Valid'

把 jks 放到 $CATALINA_HOME/conf/,修改 conf/server.xml(Tomcat 8.5 / 9 / 10 使用 SSLHostConfig 写法):

<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol'
           maxThreads='200' SSLEnabled='true' scheme='https' secure='true'
           URIEncoding='UTF-8'>
    <SSLHostConfig protocols='TLSv1.2,TLSv1.3'
                   ciphers='TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256:TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384'
                   honorCipherOrder='false'>
        <Certificate certificateKeystoreFile='conf/www.example.com.jks'
                     certificateKeystorePassword='自定义强密码'
                     certificateKeystoreType='JKS'
                     type='RSA' />
    </SSLHostConfig>
</Connector>

同时在 conf/web.xml 末尾、</web-app> 之前加入安全约束,强制应用走 HTTPS:

<security-constraint>
  <web-resource-collection><web-resource-name>SSL</web-resource-name>
    <url-pattern>/*</url-pattern></web-resource-collection>
  <user-data-constraint><transport-guarantee>CONFIDENTIAL</transport-guarantee></user-data-constraint>
</security-constraint>

两个高频坑:一是 Tomcat 以非 root 用户运行,绑定 443 会抛 java.net.BindException: Permission denied,需要用 setcap 'cap_net_bind_service=+ep' /usr/lib/jvm/java-11/bin/java 授权,或前面挂 Nginx 卸载 TLS;二是 Tomcat 7 的旧写法 keystoreFile / keystorePass 直接写在 Connector 属性上,照搬到 Tomcat 9 会启动失败。生产环境建议 Java 应用只监听 127.0.0.1:8080,由 Nginx 终结 TLS,续期证书时无需重启 JVM。

IIS 服务器 SSL 证书导入与站点绑定

IIS 使用 Windows 证书存储,证书必须导入“本地计算机 → 个人”存储,而不是“当前用户”,否则 IIS 管理器的绑定列表里根本看不到它。

1. 双击 .pfx → 选择“本地计算机” → 输入密码 → 勾选“标记此密钥为可导出”(便于后续备份)。
2. 确认中间证书已入链:把腾讯云包里的 CA 证书导入“中间证书颁发机构”存储,否则部分 Android 设备会报证书链错误。
3. IIS 管理器 → 站点 → 绑定 → 添加 → 类型 https → 端口 443 → 选择证书 → 勾选“需要服务器名称指示(SNI)”(同一 IP 多站点必需)。
4. 命令行验证绑定:

netsh http show sslcert
netsh http add sslcert ipport=0.0.0.0:443 certhash=证书指纹 appid={4dc3e181-e14b-4a21-b022-59fc669b0914}
certutil -store My
certutil -repairstore My 证书序列号

5. 强制 HTTPS:安装 URL Rewrite 模块,在站点 web.config 中加入规则:

<system.webServer>
  <rewrite>
    <rules>
      <rule name='Redirect to HTTPS' stopProcessing='true'>
        <match url='(.*)' />
        <conditions>
          <add input='{HTTPS}' pattern='off' ignoreCase='true' />
        </conditions>
        <action type='Redirect' url='https://{HTTP_HOST}/{R:1}' redirectType='Permanent' />
      </rule>
    </rules>
  </rewrite>
</system.webServer>

Windows Server 2008/2012 默认只启用 TLS 1.0,需要改注册表 SCHANNELProtocols 下的 TLS 1.2 键值并禁用 1.0/1.1,改完必须重启。IIS 7 与 IIS 10 的差别主要在 SNI 支持与 TLS 1.3(仅 Windows Server 2022 支持),老系统请以 TLS 1.2 为基线。另外,443 端口被其他服务占用时,绑定会静默失败,用 netstat -ano | findstr :443 排查。

四种服务端部署方式对比

对比项 Nginx Apache Tomcat IIS
证书文件格式 .crt + .key(PEM) .crt + .key .jks / .p12 .pfx
关键配置项 ssl_certificate / ssl_certificate_key SSLCertificateFile / SSLCertificateKeyFile / SSLCertificateChainFile SSLHostConfig + Certificate 站点绑定 + SNI
生效方式 nginx -s reload(热加载) systemctl reload httpd 重启 Tomcat,无热加载 iisreset /noforce
OCSP Stapling 原生支持 2.4.20+ 支持 不支持 不支持
HTTP/2 1.9.5+ 支持 2.4.17+ 支持 需前置代理 Windows Server 2016+
典型部署位置 公网入口 / 反向代理 传统 LAMP 栈 Java 应用直连 Windows 生态

实践建议:Java 应用不要在 Tomcat 上直接终结 TLS,把 Nginx 或腾讯云 CLB 放在前面做卸载,Tomcat 只监听 127.0.0.1:8080,续期证书时只重载 Nginx,不用停机重启 JVM。IIS 多站点场景建议用集中式证书管理,避免重复导入导致指纹不一致、绑定指向旧证书。Apache 的 SSLCertificateChainFile 在 2.4.8 之后已被 SSLCertificateFile 取代,新版应直接把中间证书拼进 crt 文件。

常见错误排查:真实报错与定位命令

下面这些报错在工单里出现频率最高,按“报错原文 → 根因 → 处理”给出。

1. nginx: [emerg] SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
证书与私钥不配对。用 modulus 对比法确认:openssl x509 -noout -modulus -in bundle.crt | openssl md5 与 openssl rsa -noout -modulus -in www.example.com.key | openssl md5 输出必须一致,不一致就重新下载配对文件。

2. nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)
文件不是 PEM 格式(可能是 .pfx 或 DER 编码的 .cer),用 openssl x509 -inform DER -in a.cer -out a.crt 转换。

3. curl: (60) SSL certificate problem: unable to get local issuer certificate
服务端没下发中间证书。把中间 CA 拼到 crt 末尾:cat www.example.com.crt intermediate.crt > bundle.crt,然后重载服务。

4. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID
访问域名不在证书 SAN 中。用 openssl x509 -in bundle.crt -noout -text | grep -A1 'Subject Alternative Name' 核对,补签证书或做 301 归一化到证书内的域名。

5. NET::ERR_CERT_DATE_INVALID
证书过期或服务器时间偏差。用 date -u 与 openssl x509 -noout -dates -in bundle.crt 双向核对,云主机时钟漂移会造成“证书尚未生效”的假象,用 chronyd 校时即可。

6. java.io.IOException: Keystore was tampered with, or password was incorrect
JKS 密码错误,或 jks 由更高版本 JDK 生成(JDK 9+ 默认 PKCS12)。用 keytool -list -keystore x.jks 验证,必要时加 -deststoretype JKS 重新转换。

7. IIS 绑定后 443 无法访问,事件日志报 0x8007000D(数据无效)
证书未导入本地计算机个人存储,或私钥权限未授予 IIS_IUSRS / NETWORK SERVICE。用 certutil -store My 确认,并在证书私钥管理中补权限。

8. nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use)
端口被占用,ss -lntp | grep :443 定位,常见是残留的 nginx worker 或另一个 Web 服务。

效果验证:命令行核验与到期监控

部署完成后按下面四步核验,全部通过才算完成。

# 1. 看服务端实际下发的证书、有效期、SAN
echo | openssl s_client -connect www.example.com:443 -servername www.example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

# 2. 确认链完整,输出应为 Verify return code: 0 (ok)
echo | openssl s_client -connect www.example.com:443 -servername www.example.com -CAfile /etc/ssl/certs/ca-certificates.crt 2>/dev/null | grep 'Verify return code'

# 3. 确认 80 端口 301 到 443
curl -sI http://www.example.com | head -n 3

# 4. 确认旧协议已关闭,应输出 handshake failure
openssl s_client -connect www.example.com:443 -tls1_1 2>&1 | grep -i 'handshake failure'

在线侧可用 SSL Labs 接口:curl 'https://api.ssllabs.com/api/v3/analyze?host=www.example.com&publish=on',目标评级 A 及以上;若返回中出现 “Chain issues: Incomplete”,即为缺中间证书。

到期监控不能靠人记。用 cron 每天检查并提前 15 天告警:

#!/bin/bash
DOMAIN=www.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 15 ] && echo "证书剩余 ${LEFT} 天,需续期" | mail -s "SSL 到期告警" ops@example.com

按 398 天与 90 天规则设置续期窗口:付费证书提前 30 天续签;腾讯云免费证书 90 天一张,建议提前 20 天重新申请,给 DNS 验证和审核留出缓冲,避免出现空窗期。

常见问题

腾讯云免费 SSL 证书有效期是多久?

目前腾讯云免费 DV 证书单张有效期为 90 天,到期需重新申请签发,不支持续费延期。付费证书按年售卖,但受 CA/Browser Forum 规则限制,单张证书最长有效期不超过 398 天,到期同样需要重新签发。建议用上文的 cron 脚本做到期监控,提前 15~20 天告警。

为什么证书最长只能 398 天,不是一年?

CA/Browser Forum 于 2020 年 3 月通过 SC-31 决议,自 2020 年 9 月 1 日起,公有可信 TLS 证书的 max validity 不得超过 398 天(含到期当天)。Chrome、Safari、Firefox 均已执行该策略,超期证书会被直接判定为不合规。因此“一年期证书”的说法已经过时,规划续期流程时请按 398 天计算,免费证书按 90 天计算。

通配符证书能覆盖多级子域吗?

不能。*.example.com 只匹配一级子域(如 www.example.com、api.example.com),不匹配 example.com 本身,也不匹配 a.b.example.com。要同时保护主域名与泛域名,需购买“通配符 + 单域名”组合,或改用多域名证书把各级域名全部写进 SAN。

部署完成后浏览器仍提示“不安全”或部分资源加载失败怎么办?

先按 F12 看 Console 是否有 Mixed Content 警告,这通常是页面里仍硬编码了 http:// 的图片、JS、CSS 或接口地址。处理方式:把资源地址改成 // 或 https://,并在 Nginx/IIS 中增加响应头 Content-Security-Policy: upgrade-insecure-requests,强制浏览器升级请求。

私钥泄露或需要紧急更换证书怎么办?

立即在腾讯云控制台对该证书执行吊销(Revoke),重新生成一对新的密钥与 CSR 并申请签发,替换服务器上的 crt / key 后重载服务,不要复用旧私钥。如果已经下发过长期 HSTS,需评估清理周期——HSTS 的 max-age 一旦生效,浏览器在有效期内不会回退到 http。

Nginx 能否同时部署 RSA 与 ECC 双证书?

可以。Nginx 1.11.0+ 支持在同一个 server 块中写两组 ssl_certificate / ssl_certificate_key,分别对应 RSA 与 ECDSA 证书,Nginx 会根据客户端 ClientHello 的签名算法自动选择。ECC 证书握手更快、体积更小,RSA 证书用于兼容老旧客户端,两者并存可兼顾性能与兼容性。

内容审核

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