腾讯云 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 证书用于兼容老旧客户端,两者并存可兼顾性能与兼容性。