跳到主要内容
ssl证书按装

腾讯云 SSL 证书配置全流程:Nginx/Apache/Tomcat/IIS/Caddy 部署与排错

腾讯云 SSL 证书配置全流程:Nginx/Apache/Tomcat/IIS/Caddy 部署与排错 — 腾讯云 SSL 证书配置全流程:Nginx/Apache/Tomcat/IIS/Caddy 部署与排错

问题背景与根因:证书签发成功不等于 HTTPS 可用

很多用户在腾讯云 SSL 证书控制台看到「已签发」就以为完事,实际访问仍是红色警告。HTTPS 配置失败通常不是证书本身的问题,而是部署链路某一环断裂。按出现频率排序,根因集中在以下 6 类:

  • 证书链不完整:只上传了域名证书(leaf),漏掉中间证书(intermediate)。桌面浏览器靠 AIA 补链能自愈,但 Android、微信内置浏览器、Java 客户端、curl 会直接报 unable to get local issuer certificate。
  • 私钥与证书不匹配:CSR 与私钥不是同一次生成,或从 A 服务器复制了证书、从 B 服务器复制了私钥。
  • 域名覆盖不全:只申请了 example.com,未包含 www.example.com,SAN 字段缺失。
  • 端口未放行:腾讯云安全组、系统 firewalld/ufw、主机侧防火墙三层任一未放行 443。
  • 协议或套件过旧:仍启用 TLS 1.0/1.1,主流浏览器已拒绝握手。
  • 混合内容:页面内仍引用 http:// 的图片、JS、CSS。

快速定位两条命令即可:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>&1 | openssl x509 -noout -subject -issuer -dates
curl -vI https://example.com 2>&1 | grep -E 'SSL|subject|issuer|expire'

若 curl 输出 SSL certificate problem: unable to get local issuer certificate,基本可判定为链不完整;若输出 no alternative certificate subject name matches target host name,则是域名不匹配。需要说明的是,证书配置服务只做实施、不售卖证书;若手上还没有证书,可在配置过程中直接签发 Let’s Encrypt 免费证书(有效期 90 天,必须配置自动续期)。

前置准备:确认服务器类型、证书格式与有效期

动手前先做三件事:确认环境、确认格式、确认有效期。共享型虚拟主机不提供 443 端口与证书安装权限,必须使用腾讯云 CVM 或轻量应用服务器等有 root 权限的环境。

1. 确认 Web 服务器类型与版本

nginx -v 2>&1; httpd -v; /usr/local/tomcat/bin/version.sh; caddy version

2. 统一证书格式。腾讯云下载包一般含 Nginx/example.com_bundle.crt(已含链)、example.com.crt、example.com.key、Tomcat/example.com.jks、IIS/example.com.pfx。若只有单证书,需手动拼接 fullchain:

cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile intermediate.crt example.com.crt

pfx 转 PEM:

openssl pkcs12 -in example.com.pfx -nodes -out all.pem
openssl pkcs12 -in example.com.pfx -clcerts -nokeys -out cert.pem
openssl pkcs12 -in example.com.pfx -nocerts -nodes -out key.pem

3. 有效期与续期节奏。按 CA/Browser Forum 规则,公有可信证书最长有效期为 398 天;Let’s Encrypt 与腾讯云免费 DV 证书均为 90 天。后续还将进一步缩短(2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天),因此自动续期不是可选项。

4. 生成 CSR(自签或第三方签发):

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' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

生成后务必核对私钥与证书是否配对,避免上线后才发现 mismatch:

openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

实操一:Nginx 与 Apache 部署证书

以 CentOS/OpenCloudOS + Nginx 1.20 为例,证书目录统一放在 /etc/nginx/ssl/,私钥权限 600。

mkdir -p /etc/nginx/ssl
cp fullchain.pem /etc/nginx/ssl/example.com.pem
cp example.com.key /etc/nginx/ssl/example.com.key
chmod 600 /etc/nginx/ssl/example.com.key
chown root:root /etc/nginx/ssl/*

编辑站点配置,把 80 跳转与 443 监听写成两个 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.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com.key;
    # 其余参数见下一节模板
}

检查并重载:nginx -t && systemctl reload nginx。若报 SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),说明私钥与证书不配对,回到上一步用 modulus 比对。

Apache 2.4 配置(/etc/httpd/conf.d/ssl.conf):

<VirtualHost *:443>
  ServerName example.com
  SSLEngine on
  SSLCertificateFile    /etc/httpd/ssl/fullchain.pem
  SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
  # Apache 2.4.8 之前需单独指定链文件
  # SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
</VirtualHost>

执行 apachectl configtest,输出 Syntax OK 后 systemctl reload httpd。若出现 AH02572: Failed to configure at least one certificate and key for example.com:443,多为路径错误或 SELinux 拒绝读取(用 chcon -t httpd_sys_content_t 或 setsebool -P httpd_can_network_connect 1)。最后放行端口:firewall-cmd --add-service=https --permanent && firewall-cmd --reload,同时在腾讯云控制台安全组放行 TCP 443。

实操二:Tomcat、IIS、Caddy 的差异化配置

Tomcat 9/10:推荐 PKCS12 而非 JKS。转换命令:

openssl pkcs12 -export -in fullchain.pem -inkey example.com.key 
  -name tomcat -out example.com.p12 -passout pass:ChangeMe123

server.xml 中的 Connector:

<Connector port='443' protocol='org.apache.coyote.http11.Http11NioProtocol'
  maxThreads='200' SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig>
    <Certificate certificateKeystoreFile='/usr/local/tomcat/conf/example.com.p12'
      certificateKeystoreType='PKCS12' certificateKeystorePassword='ChangeMe123'/>
  </SSLHostConfig>
</Connector>

常见报错 java.io.IOException: Keystore was tampered with, or password was incorrect,99% 是密码错或未声明 keystoreType;java.security.cert.CertificateException: No name matching example.com found 则是 SAN 不匹配。

IIS 10:服务器证书 → 导入 .pfx(必须含私钥)→ 站点绑定添加 https/443 → 勾选 SNI。命令行校验:

netsh http show sslcert | findstr /i 'Hostname:Port Certificate Hash'

同一 IP 多站点时必须为每个站点绑定不同主机名并启用 SNI,否则只有第一个站点能正常握手。

Caddy 2:内置 ACME 自动签发与续期,Caddyfile 三行搞定:

example.com, www.example.com {
    root * /var/www/html
    file_server
    encode gzip
}

使用已有证书则写 tls /etc/caddy/fullchain.pem /etc/caddy/example.com.key。执行 caddy validate --config /etc/caddy/Caddyfile 后 systemctl reload caddy。注意 Caddy 默认自动 HTTP→HTTPS 跳转并启用 HSTS,若前置还有 CLB/CDN,需确认回源协议为 HTTPS,否则会陷入重定向循环。

配置示例:一份可上生产的 Nginx HTTPS 站点模板

下面这份模板覆盖 TLS 1.2/1.3、HSTS、OCSP Stapling、会话复用与安全响应头,替换域名后可直接使用:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com;

    ssl_certificate     /etc/nginx/ssl/example.com.pem;   # fullchain
    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-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.pem;
    resolver 183.60.83.19 183.60.82.98 valid=300s;
    resolver_timeout 5s;

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

    root /var/www/html;
    index index.php index.html;
    location / { try_files $uri $uri/ /index.php?$query_string; }
}

几个易踩的参数点:ssl_trusted_certificate 必须指向链证书(不含服务器证书),否则 OCSP Stapling 不生效,error.log 会打印 ssl_stapling ignored, issuer certificate not found;ssl_session_tickets off 是为了前向安全,代价是握手略增;http2 on 在 Nginx 1.25.1 之前需写回 listen 443 ssl http2;。改完统一执行 nginx -t && systemctl reload nginx。

如果站点前置了腾讯云 CLB 或 CDN,证书应上传到负载均衡/加速域名侧,回源协议选 HTTPS 并在源站同样部署证书,否则会出现 526 Invalid SSL Certificate 或重定向循环。

方案对比:证书类型与各服务器部署形态

表 1 是选型时最常被问到的证书类型差异。注意 EV 证书在主流浏览器地址栏已不再显示绿色公司名,只剩证书详情中的主体信息,不必为「绿条」多付费。

维度 DV 域名型 OV 企业型 EV 扩展验证
验证内容 仅域名控制权(DNS/文件/邮件) 域名 + 企业工商信息 域名 + 企业 + 电话/律师函人工核验
签发时长 分钟级(自动) 1–3 工作日 3–7 工作日
有效期上限 398 天 398 天 398 天
浏览器展示 锁标识 锁标识 锁标识(不再显示公司名)
适用场景 博客、测试、内部系统 企业官网、API 网关 金融、政企合规要求

表 2 对比各 Web 服务器与接入层的部署形态,实际项目常组合使用(CDN 终止 TLS + 源站再加密)。

部署位置 证书文件 配置入口 重载命令 典型坑
Nginx fullchain.pem + key conf.d/*.conf nginx -t && systemctl reload nginx 漏拼中间证书
Apache fullchain.pem + key conf.d/ssl.conf apachectl configtest && systemctl reload httpd SELinux 拒绝读取
Tomcat .p12 / .jks server.xml Connector shutdown.sh && startup.sh keystoreType 未声明
IIS .pfx 站点绑定 443 iisreset /restart 多站点未启用 SNI
Caddy 自动 ACME Caddyfile systemctl reload caddy 与 CDN 双重跳转
腾讯云 CLB/CDN 控制台上传 证书管理 → 绑定域名 无需重载 回源协议未加密

常见错误排查:真实报错与处置动作

下表按报错原文检索,可直接对照处理。

报错信息 根因 处置
curl: (60) SSL certificate problem: unable to get local issuer certificate 证书链不完整 拼接 fullchain;Apache 2.4.8 以下补 SSLCertificateChainFile
NET::ERR_CERT_COMMON_NAME_INVALID 证书 SAN 不含当前域名 重新签发含 www 的证书,或改用已覆盖域名访问
nginx: [emerg] PEM_read_bio_X509_AUX(...) failed ... no start line 文件格式不对、为空或含 BOM 确认是 PEM 而非 DER/PFX,首行应为 —–BEGIN CERTIFICATE—–
X509_check_private_key:key values mismatch 私钥与证书不配对 modulus 比对后换回正确私钥
ERR_SSL_PROTOCOL_ERROR 443 被非 TLS 服务占用,或仅开 TLS 1.0 ss -lntp | grep :443 核查监听进程
AH02572: Failed to configure at least one certificate and key 路径错、SELinux 或权限不足 chmod 600 key,setsebool -P httpd_read_user_content 1
Keystore was tampered with, or password was incorrect Tomcat 密码或类型错 确认 PKCS12 类型与密码一致
Mixed Content: ... requested an insecure element http://... 页面内硬编码 http 资源 改为相对协议或 https,并加 CSP upgrade-insecure-requests
ssl_stapling ignored, issuer certificate not found ssl_trusted_certificate 指错 指向中间证书链文件

另外两个高频「玄学」问题:一是服务器时间偏差超过证书 notBefore,浏览器报 ERR_CERT_DATE_INVALID,用 chronyc tracking 或 timedatectl 校时;二是腾讯云安全组已放行但系统防火墙未放行,telnet example.com 443 不通时按「安全组 → 系统防火墙 → 服务监听」三层依次排查。还有一类是网站系统自身限制:部分老系统在代码里写死了 http:// 的站点 URL,或 Cookie 未加 Secure 标记,导致登录态在 HTTPS 下丢失,这需要改应用配置而不是改证书配置。

效果验证:五条命令确认 HTTPS 真正可用

配置完成不等于交付完成,必须做验证闭环。

# 1. 协议与证书链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null

# 2. 证书有效期与 SAN
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -dates -subject -ext subjectAltName

# 3. 是否强制跳转
curl -sI http://example.com | head -3          # 期望 301 + Location: https://...

# 4. 全链路校验(含中间证书)
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|HTTP/'

# 5. 旧协议强制测试(应握手失败)
openssl s_client -connect example.com:443 -tls1_1 </dev/null

输出中 Verify return code: 0 (ok) 才算链路完整;出现 verify error:num=20:unable to get local issuer certificate 则链仍缺。第 3 条应返回 301,若返回 200 说明跳转规则未生效。第 5 条若握手成功,说明仍在支持 TLS 1.1,需检查 ssl_protocols 或 SSLProtocol。

此外建议做两项外部检查:一是用 SSL Labs 跑一次评级(目标 A/A+),重点看 Chain issues 是否显示 None;二是浏览器 F12 → Security 面板确认无 Mixed Content 警告。若使用 Let’s Encrypt,务必验证自动续期:

certbot renew --dry-run
systemctl list-timers | grep certbot

用 acme.sh + DNSPod 的场景:

export DP_Id='你的ID'; export DP_Key='你的Token'
acme.sh --issue --dns dns_dp -d example.com -d www.example.com
acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/example.com.pem 
  --reloadcmd 'systemctl reload nginx'

证书到期前 30 天应收到告警,可用 openssl x509 -checkend 2592000 -noout -in fullchain.pem 写进巡检脚本,返回非 0 即触发续期。

常见问题

腾讯云免费证书和 Let’s Encrypt 有什么区别,该选哪个?

两者都是 DV 证书,浏览器信任度相同。腾讯云免费 DV 证书有效期为 90 天,需在控制台手动续期并重新下载部署;Let’s Encrypt 同为 90 天,但可通过 certbot 或 acme.sh 全自动续期并重载服务。若服务器是 CVM 且能开放 80 端口或使用 DNS 验证,推荐 Let’s Encrypt + acme.sh 实现零人工;若站点在 CLB/CDN 后面、无法做 HTTP 验证,用腾讯云证书控制台更省事。

为什么浏览器显示证书有效,但微信或安卓 App 里请求失败?

典型原因是证书链不完整。桌面浏览器有 AIA 补链机制,会自行下载中间证书,而 Android WebView、OkHttp、Java 客户端不会。解决办法是把服务器证书与中间证书拼接成 fullchain.pem 后重新部署,再用 openssl s_client -showcerts 确认返回了 2 张以上证书。

一台服务器多个域名,可以共用一个 443 端口吗?

可以,前提是启用 SNI(TLS 扩展,客户端在握手时带上目标主机名)。Nginx/Apache/Caddy 默认开启,IIS 8 以上需在站点绑定里勾选「需要服务器名称指示」。若存在极老客户端(如 Android 4.x),会拿到默认站点的证书而报错,此时只能做单域名单 IP 或升级客户端。

配置 HTTPS 后网站变慢、后台登录失效怎么办?

变慢多为未开启 HTTP/2 与会话复用:确认 http2 on、ssl_session_cache shared:SSL:10m 已生效。登录失效通常是 Cookie 未加 Secure 属性或站点 URL 仍写死 http://,导致会话跨协议丢失;在应用配置里把站点地址改为 https,并对 Cookie 设置 Secure; SameSite=Lax 即可。

证书最长有效期到底是多久?需要提前多久续期?

当前公有可信证书最长有效期为 398 天;Let’s Encrypt 与主流免费 DV 证书为 90 天。按 CA/Browser Forum 既定时间表,2026 年 3 月 15 日起缩短至 200 天,2027 年 3 月 15 日起 100 天,2029 年 3 月 15 日起 47 天。建议在到期前 30 天完成续期并保留 7 天缓冲,用自动续期加到期监控双保险。

虚拟主机能不能装 SSL 证书?

共享型虚拟主机通常不提供 443 端口、独立 IP 和配置文件权限,无法自行安装证书,只能使用服务商提供的「一键 HTTPS」功能。要自主配置,必须使用腾讯云 CVM、轻量应用服务器或容器服务等拥有 root 权限的环境。

内容审核

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