网站 HTTPS 全站加密实战:SSL 证书申请、Nginx 安装配置与故障排查
问题背景:为什么证书“已安装”却依然报不安全
很多站点在腾讯云 SSL 证书控制台完成签发,把证书包里的 .crt 和 .key 上传到服务器,nginx -t 也通过了,但浏览器打开仍显示红色“不安全”。绝大多数情况不是证书本身有问题,而是部署链条上几个固定环节出了问题。
根因一:证书链不完整。只部署了站点证书,没有附带中间证书。PC 端可能正常,但旧版 Android、iOS、微信内置浏览器以及 Java/Python 客户端会直接失败,典型报错 curl: (60) SSL certificate problem: unable to get local issuer certificate。
根因二:私钥与证书不匹配。常见于证书重签后只替换了一半文件,Nginx 启动直接报 SSL_CTX_use_PrivateKey:key values mismatch。
根因三:有效期管理缺失。公共可信 TLS 证书单张最长有效期为 398 天(CA/B 论坛规定,2020 年 9 月起生效);Let’s Encrypt 与腾讯云免费 DV 证书均为 90 天。按“一年一换”规划必然出问题。
根因四:协议与套件过旧。服务端仍开启 TLS 1.0/1.1 或只保留已被淘汰的套件,客户端与服务端没有交集,报 ERR_SSL_VERSION_OR_CIPHER_MISMATCH 或 SSL_ERROR_NO_CYPHER_OVERLAP。
根因五:混合内容。页面里仍硬编码 http:// 资源,被浏览器按 Mixed Content 拦截,锁标消失甚至样式错乱。
所以 HTTPS 配置并不是一个“上传文件”的动作,而是一条完整链路:私钥 → CSR → 域名验证 → 签发 → 证书链合并 → 服务端配置 → 协议套件 → 续期监控 → 混合内容清理。下面按这条链路逐段给出可直接执行的命令。
完整实操步骤:从私钥、CSR 到证书签发
第一步:生成私钥与 CSR。推荐 RSA 2048 或 ECDSA P-256,后者握手开销更小:
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example Tech/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
生成后必须校验 SAN 已正确写入——现代客户端只认 SAN,CN 字段已不再作为唯一依据:
openssl req -in example.com.csr -noout -subject -text | grep -A2 'Subject Alternative Name'
第二步:提交签发并完成域名验证。在腾讯云 SSL 证书控制台选择申请免费证书或购买付费证书,粘贴上一步的 CSR(也可选择平台自动生成 CSR,但此时私钥由云端保管,安全要求高的场景应自行生成)。域名验证二选一:DNS 验证添加一条 TXT 记录,等待 TTL 生效,通常 10 分钟内;文件验证需保证 http://example.com/.well-known/pki-validation/ 下的指定文件可被公网访问,且 80 端口未被 301 跳转到 HTTPS。验证通过后一般 1–30 分钟签发。
第三步:合并证书链。下载 Nginx 格式证书包,通常含 example.com_bundle.crt(站点证书 + 中间证书)与 example.com.key。用自建私钥替换包内 key,并确认链文件完整:
cat example.com_bundle.crt > fullchain.pem
openssl x509 -in fullchain.pem -noout -subject -issuer -dates
openssl x509 -in fullchain.pem -noout -ext subjectAltName
若使用 Let’s Encrypt,一条命令即可完成签发与链合并,产物 fullchain.pem 已包含中间证书:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
ls /etc/letsencrypt/live/example.com/
配置示例:Nginx 与 Apache 可直接套用
Nginx 推荐把 80 端口统一 301 到 443,HTTPS server 块写法如下(注意 http2 on; 需要 Nginx 1.25.1 及以上;旧版本改用 listen 443 ssl http2;):
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/fullchain.pem;
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: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/fullchain.pem;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
校验并平滑生效,不要用 restart:
nginx -t && systemctl reload nginx
Apache 对应写法(SSLCertificateChainFile 仅在中间证书独立成文件时才需要;已合并进 fullchain 则不必配置):
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
两个坑要提前避开:HSTS 头一旦下发就会被浏览器长期记住,务必确认全站 HTTPS 与所有子域都已就绪再开启 includeSubDomains;证书路径必须写绝对路径,用相对路径在 reload 时会因工作目录变化而失败。
证书类型与部署形态对比
选型直接影响续期成本和适用范围,先看清差异再下单:
| 类型 | 校验内容 | 签发时长 | 单张有效期上限 | 适用场景 |
|---|---|---|---|---|
| DV 域名型(免费) | 仅域名控制权(DNS/文件) | 1–30 分钟 | 90 天 | 博客、API、测试环境 |
| DV 域名型(付费) | 仅域名控制权 | 10–60 分钟 | 398 天 | 中小站点、内部系统 |
| OV 企业型 | 域名 + 工商信息核验 | 1–3 工作日 | 398 天 | 企业官网、对外业务 |
| EV 扩展验证 | 严格身份核验 | 3–7 工作日 | 398 天 | 金融、支付类(浏览器 UI 已不再单独展示) |
再看部署形态,决定续期是否可自动化:
| 形态 | 验证方式 | 覆盖范围 | 续期成本 |
|---|---|---|---|
| 单域名证书 | HTTP 文件 / DNS | 一个精确域名 | 低,可用 certbot 全自动 |
| 通配符证书 | 必须 DNS-01(TXT 记录) | *.example.com,仅一级子域 | 中,需 DNS API 凭据 |
| 多域名 SAN 证书 | 每个域名单独验证 | 最多数十个指定域名 | 中,新增域名需重签 |
| 云负载均衡托管 | 控制台上传证书 | 后端所有实例共享 | 低,无需登录服务器 |
需要注意:通配符 *.example.com 不匹配 a.b.example.com 这类多级子域,多级场景要么另签 *.b.example.com,要么把具体域名加入 SAN 列表。另外,加密强度与证书价格无关,DV 和 EV 使用的 RSA/ECC 密钥与 TLS 协议完全一致,付费买的是身份核验、有效期长度、赔付承诺与人工支持。
常见错误排查:真实报错与对应处置
1. 私钥与证书不匹配
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 fullchain.pem | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
2. 证书文件格式损坏或被覆盖
nginx: [emerg] PEM_read_bio_X509_AUX("/etc/nginx/ssl/fullchain.pem") failed
(SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)
多半是文件里混入了 HTML 错误页或文件为空。执行 head -1 fullchain.pem,首行必须是 -----BEGIN CERTIFICATE-----。
3. 证书链不完整
curl: (60) SSL certificate problem: unable to get local issuer certificate
查看服务端实际下发的证书张数,正常应至少 2 张(站点证书 + 中间证书):
- Wildcard 通配符 SSL 证书安装部署续费申请
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
4. 证书过期或服务器时间错误
curl: (60) SSL certificate problem: certificate has expired
x509: certificate has expired or is not yet valid
先看证书到期时间,再核对系统时钟与 NTP 同步状态:openssl x509 -in fullchain.pem -noout -enddate、timedatectl。
5. 域名不在 SAN 列表中:浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID,最常见是漏加 www 子域,或直接用 IP 访问。重新签发并补全 SAN。
6. 协议套件无交集:报 SSL_ERROR_NO_CYPHER_OVERLAP,检查 ssl_protocols 是否只留了 TLS 1.3 而客户端只支持 1.2;同时确认 443 端口是否被 CDN/WAF 提前接管,用 ss -lntp | grep :443 看真实监听进程。
7. 混合内容:控制台报 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource。用 curl -s https://example.com | grep -o 'http://[^"]*' 定位硬编码资源,改为 https 或相对协议,并在响应头加 Content-Security-Policy: upgrade-insecure-requests 兜底。
自动化续期与有效期监控
90 天的免费证书靠人工续期迟早出事,必须自动化。Let’s Encrypt 用 certbot 内置续期,先演练再上线:
certbot renew --dry-run
写入 crontab,续期成功后自动 reload,避免手工介入:
0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx'
腾讯云签发的免费 DV 证书同样为 90 天,可在 SSL 证书控制台开启托管/自动续期,或通过云 API 拉取新证书后推送到服务器;证书部署在 CLB、CDN 上的,直接在控制台上传更新即可,无需登录后端实例。
无论哪种方式,都要额外加一道独立的到期告警,因为自动化也可能静默失败(DNS 记录被删、webroot 目录权限变更、80 端口被防火墙关闭)。下面这条命令可直接嵌入监控脚本:
DAYS=$(( ( $(date -d "$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate | cut -d= -f2)" +%s) - $(date +%s) ) / 86400 ))
echo "剩余天数: $DAYS"
[ "$DAYS" -lt 30 ] && echo 'ALERT: 证书将在 30 天内到期'
阈值建议设为 30 天:既留出排查窗口,又不会因 398 天有效期太长而遗忘。同时把“续期成功”也纳入日志告警,确认 deploy-hook 真的执行了 reload,而不是只更新了文件。
效果验证:从命令行到评分工具逐项确认
配置完成后不要只看浏览器锁标,按下面四步逐项验证。
第一步:验证协议与信任链。重点看输出中的 Verify return code 是否为 0:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep -E 'Protocol|Cipher|Verify return code'
期望结果为 Protocol: TLSv1.2、Cipher: ECDHE-RSA-AES128-GCM-SHA256、Verify return code: 0 (ok)。
第二步:验证旧协议已被拒绝。握手应当失败,若仍能协商成功说明 ssl_protocols 未生效或前面还有一层代理:
openssl s_client -connect example.com:443 -tls1 </dev/null
第三步:验证跳转与安全响应头。
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -iE 'strict-transport-security|content-security-policy'
curl -s -o /dev/null -w '%{http_code} %{time_total}sn' https://example.com
80 端口应返回 301,443 端口应返回 200 且带有 HSTS 头。
第四步:验证证书信息与链长度。
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
确认 subject 中的域名、SAN 列表、notAfter 日期均符合预期。最后用 SSL Labs 或国内同类评级工具跑一次完整扫描,目标为 A 及以上;若出现“Certificate Chain Incomplete”或“TLS 1.0 enabled”提示,回到前面对应章节处理。
常见问题
没有区别。两者使用相同的 RSA/ECC 密钥与 TLS 协议,加密强度完全一致。差别在于身份核验级别(DV 不核验企业信息)、有效期长度(免费 90 天,付费最长 398 天)、赔付承诺和人工技术支持。
公共可信 TLS 证书单张最长 398 天,这是 CA/B 论坛自 2020 年 9 月起执行的规定。Let’s Encrypt 和腾讯云免费 DV 证书均为 90 天。因此必须按自动续期规划,不能按“一年一换”安排运维。
典型原因是证书链不完整。PC 浏览器可能缓存了中间证书或能自动补链,而 Android、iOS、微信内置浏览器不会。把中间证书合并进 fullchain.pem,用 openssl s_client -showcerts 确认至少下发两张证书即可修复。
页面里仍有 http:// 硬编码资源,被浏览器按混合内容拦截。用 grep 找出所有 http:// 引用改为 https 或相对协议,并在响应头添加 Content-Security-Policy: upgrade-insecure-requests 作为兜底。
不能。*.example.com 只匹配一级子域,如 a.example.com,不匹配 a.b.example.com。多级子域需单独申请 *.b.example.com,或把具体域名逐个加入 SAN 列表,签发时必须用 DNS-01 验证。
不需要。执行 nginx -t 校验通过后,用 systemctl reload nginx 即可平滑加载新证书,已有连接不受影响。只有修改了 listen 指令、端口等结构性配置时才需要 restart。