跳到主要内容
ssl证书按装

SSL/TLS 证书申请与 HTTPS 部署完整指南(含 Nginx/Apache 配置、真实报错排查)

SSL/TLS 证书申请与 HTTPS 部署完整指南(含 Nginx/Apache 配置、真实报错排查) — SSL/TLS 证书申请与 HTTPS 部署完整指南(含 Nginx/Apache 配置、真实报错排查)

一、问题背景:为什么你的网站仍被标记“不安全”

Chrome 68 起,所有未加密的 HTTP 页面地址栏都会显示“不安全”;Chrome 90 起地址栏默认隐藏 http:// 前缀,Firefox、Edge、Safari 同步跟进。更关键的是,浏览器只在 HTTPS 下启用 HTTP/2、Service Worker、地理位置、剪贴板等 API,纯 HTTP 站点在现代 Web 中已经处于明显劣势。很多站长以为“部署 SSL 就是把证书传上去”,实际排查下来,绝大多数失败案例的根因集中在四类:

  • 只监听 80 端口:Nginx/Apache 从未配置 443 server 块,DNS 解析正常但 TLS 握手直接失败。
  • 证书链不完整:只部署了站点证书(domain.crt),没带中间证书(intermediate),桌面浏览器能“补链”,但 Android、Java 客户端、curl 直接报错。
  • 域名不匹配:证书只签了 example.com,用户访问 www.example.com 触发 NET::ERR_CERT_COMMON_NAME_INVALID。
  • 混合内容:页面本身是 HTTPS,但引用了 http:// 的图片、JS、CSS,浏览器仍显示“不安全”或锁标志带警告。

另外,证书有效期规则已经变化:CA/Browser Forum 规定自 2020-09-01 起,公有信任 SSL/TLS 证书最长有效期不得超过 398 天;并已通过分阶段缩短方案——2026-03-15 起降至 200 天,2027-03-15 起降至 100 天。这意味着“一年一续”的老习惯必须改成自动化续期。Let’s Encrypt 免费证书有效期固定 90 天,更适合配合 cron/systemd timer 做全自动轮转。本文按“申请 → 部署 → 排错 → 验证”的顺序给出可直接执行的命令。

二、申请前的准备:私钥、CSR 与域名验证

正式提交申请前先确定三件事:域名范围(单域名 / 多域名 SAN / 通配符 *.example.com)、验证方式(HTTP-01 文件验证、DNS-01 TXT 记录验证、部分 CA 支持邮箱验证)、密钥算法(RSA 2048 起步,或 ECDSA P-256,后者握手更快但需确认老客户端兼容)。CSR(证书签名请求)在你自己服务器上生成,私钥绝不出本机。

# 1. 生成 2048 位 RSA 私钥 + CSR(含 SAN 扩展,一次覆盖主域名和 www)
openssl req -new -newkey rsa:2048 -nodes 
  -keyout /etc/nginx/ssl/example.com.key 
  -out /etc/nginx/ssl/example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

# 2. 校验 CSR 内容,确认域名、SAN、密钥长度无误
openssl req -in /etc/nginx/ssl/example.com.csr -noout -text | grep -A2 "Subject Alternative Name"

# 3. 私钥权限收敛,只有 root 可读
chmod 600 /etc/nginx/ssl/example.com.key
chown root:root /etc/nginx/ssl/example.com.key

拿到 CA 签发的证书后,务必确认压缩包里包含站点证书 + 中间证书。多数商业 CA 会提供 fullchain.crt(或 ca-bundle.crt 需手动拼接)。拼接顺序是“站点证书在前,中间证书在后”,顺序反了同样会报链错误:

cat example.com.crt intermediate.crt > fullchain.crt
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.crt
# 期望输出:fullchain.crt: OK

如果选择 DNS-01 验证申请通配符证书,需在域名 DNS 服务商添加 _acme-challenge.example.com 的 TXT 记录,TTL 建议设为 60 秒以便快速生效。验证通过后 CA 才会签发,整个过程通常 1-10 分钟。

三、免费证书实操:用 Certbot 申请 Let’s Encrypt 证书

Let’s Encrypt 通过 ACME v2 协议签发 90 天有效期的 DV 证书,完全免费且支持自动续期,是个人站和中小项目的最优解。以 Ubuntu 22.04 + Nginx 为例:

# 安装 certbot 及 Nginx 插件
apt update && apt install -y certbot python3-certbot-nginx

# 方式 A:Nginx 插件自动改写配置(最省事,会自动加 443 server 块和 80 跳转)
certbot --nginx -d example.com -d www.example.com --redirect 
  --agree-tos -m admin@example.com --no-eff-email

# 方式 B:webroot 模式,不动现有配置,只把验证文件写进站点根目录
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com

# 方式 C:DNS-01 通配符(以 Cloudflare 插件为例)
apt install -y python3-certbot-dns-cloudflare
certbot certonly --dns-cloudflare 
  --dns-cloudflare-credentials /root/.secrets/cloudflare.ini 
  -d "example.com" -d "*.example.com"

签发成功后证书固定存放在 /etc/letsencrypt/live/example.com/,其中:

  • fullchain.pem:站点证书 + 中间证书,Nginx 的 ssl_certificate 必须指向它;
  • privkey.pem:私钥,对应 ssl_certificate_key;
  • chain.pem:仅中间证书,用于 OCSP Stapling 的 ssl_trusted_certificate;
  • cert.pem:仅站点证书,不要单独用于部署。

续期由 certbot.timer 自动触发(每天两次),手动验证续期链路是否通畅一定要用 dry-run,避免触发 Let’s Encrypt 的重复签发速率限制(每域名每周 5 张重复证书):

systemctl list-timers | grep certbot
certbot renew --dry-run          # 只做模拟,不真正签发
certbot renew --deploy-hook "systemctl reload nginx"

注意 --dry-run 走的是 staging 环境,成功不代表生产一定能过;如果站点有 CDN 或 WAF,需确保 /.well-known/acme-challenge/ 路径不被拦截。

四、部署配置示例:Nginx 与 Apache

下面是一份生产可用的 Nginx 配置,包含 HTTP 强制跳转、TLS 1.2/1.3、现代加密套件、OCSP Stapling、HSTS 与安全响应头。请先备份原配置,改完必须执行 nginx -t。

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

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;                                  # Nginx 1.25.1+ 写法;旧版本用 listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;

    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;
    resolver 223.5.5.5 1.1.1.1 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.html;
}

Apache 2.4 对应配置(a2enmod ssl headers rewrite 后启用):

<VirtualHost *:80>
    ServerName example.com
    RewriteEngine On
    RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
</VirtualHost>

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com
    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/example.com/privkey.pem
    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
    SSLHonorCipherOrder     off
    Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"
</VirtualHost>

两点提醒:HSTS 一旦下发就无法撤销,先用 max-age=300 试运行一周,确认全站 HTTPS 与子域都没问题后再调到 31536000;ssl_stapling 依赖 resolver 能解析 OCSP 地址,内网无外网出口时先关闭,否则首字节延迟反而变高。

五、证书类型与部署方案对比

选型不是“越贵越好”,而是按验证强度、域名数量和运维能力匹配。下表为当前常见证书类型的横向对比:

类型 验证内容 签发时长 典型价格 浏览器展示 适用场景
DV 域名型 仅验证域名控制权(DNS/HTTP) 1-10 分钟 免费 ~ 200 元/年 小锁 博客、API、内部工具
OV 企业型 营业执照 + 电话核验 1-3 工作日 800-3000 元/年 小锁(详情含企业名) 电商、SaaS 官网
EV 增强型 严格企业身份核验 3-7 工作日 2000-8000 元/年 小锁(绿色地址栏已取消) 金融、支付

注意:Chrome 自 2019 年(v77)起移除 EV 绿色地址栏,EV 的营销价值已大幅下降,多数场景 OV 足够。再对比部署方式:

方案 有效期 续期方式 通配符 运维成本 适用
Let’s Encrypt + Certbot 90 天 自动(systemd timer) 支持(DNS-01) 低 绝大多数站点
商业 DV/OV 证书 最长 398 天 手动或 ACME 支持 中 需要商业支持与赔付
云厂商托管证书 90-398 天 控制台一键续期 视产品而定 低 已上云的负载均衡/CDN
自签证书 自定义 手动 支持 中 仅内网测试,公网不可用

成本之外还要算“故障成本”:免费证书一旦续期失败,90 天后站点直接全站不可访问;商业证书虽然周期长,但 398 天上限同样要求建立到期提醒。建议无论选哪种,都在监控系统里挂一条“证书剩余天数 < 21 天”的告警。

六、常见错误排查(附真实报错)

下面这些报错在部署现场出现频率最高,按“报错原文 → 根因 → 处理”逐条对照:

1. nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied)
根因:Nginx worker 以 www-data 运行,读不到 600 权限或 root 属主的私钥目录。处理:chmod 644 fullchain.pem && chmod 600 privkey.pem,并确认 /etc/letsencrypt/live 与 /etc/letsencrypt/archive 目录对 worker 可执行(x 权限)。

2. SSL_CTX_use_PrivateKey_file("...privkey.pem") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
根因:证书与私钥不配对,常见于重新签发后忘了换 key。处理:分别计算模数比对,两行 md5 必须一致:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem   | openssl md5

3. curl: (60) SSL certificate problem: unable to get local issuer certificate
根因:服务端没下发中间证书,证书链不完整。处理:确认 ssl_certificate 指向 fullchain.pem 而非 cert.pem,用 openssl s_client -connect example.com:443 -servername example.com -showcerts 检查返回了几张证书(正常 ≥2 张)。

4. 浏览器 NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN
根因:证书 SAN 里没有当前访问的域名,漏签了 www 或子域。处理:重新签发含 SAN 的证书,用 openssl x509 -in cert.pem -noout -text | grep DNS 核对。

5. Problem binding to port 80: Could not bind to IPv4 or IPv6.
根因:80 端口被 Nginx/Apache 占用,Certbot standalone 模式抢不到端口。处理:改用 --nginx 或 --webroot,或临时 systemctl stop nginx。

6. acme: error: 429 :: rateLimited :: too many certificates already issued for example.com
根因:触发 Let’s Encrypt 速率限制(每注册域名每周 5 张重复证书)。处理:等待一周,或调试期加 --server https://acme-staging-v02.api.letsencrypt.org/directory 走 staging 环境。

7. NET::ERR_CERT_DATE_INVALID
根因:证书已过期,或服务器系统时间漂移。处理:timedatectl status 校准 NTP,再 openssl x509 -noout -dates -in cert.pem 核对 notBefore/notAfter。

8. 锁标志正常但页面仍提示“不安全”
根因:混合内容。处理:F12 Console 过滤 “Mixed Content”,把所有 http:// 资源改 https://,并加 Content-Security-Policy: upgrade-insecure-requests。

七、部署效果验证与续期监控

配置 reload 之后不要只看浏览器小锁,用命令逐层验证:

# 1. 协议与套件:确认协商到 TLSv1.3 / TLSv1.2,且未开放 TLSv1.0/1.1
openssl s_client -connect example.com:443 -servername example.com -tls1_1
# 期望:握手失败(handshake failure)

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

# 3. HTTP 状态与跳转
curl -I http://example.com          # 期望 301 到 https://
curl -I https://example.com         # 期望 200,且响应头含 strict-transport-security

# 4. 全量体检(需外网)
docker run --rm -ti drwetter/testssl.sh --severity HIGH https://example.com

把上面几步固化成巡检脚本,配合 cron 每天跑一次,证书剩余天数低于阈值就告警:

#!/bin/bash
DOMAIN="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 ))
echo "$DOMAIN 证书剩余 $LEFT 天"
[ $LEFT -lt 21 ] && echo "WARN: 证书即将到期" | mail -s "SSL 到期告警" ops@example.com

续期后的 reload 一定要绑定到 deploy hook,否则新证书落盘但 Nginx 仍持有旧证书的内存句柄:

# /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
#!/bin/bash
nginx -t && systemctl reload nginx

验证标准:curl -I https://example.com 返回 200 且带 HSTS 头;openssl s_client 显示证书链 2 张以上、issuer 为中间 CA;SSL Labs 评级 A 及以上;浏览器地址栏小锁无警告、Console 无 Mixed Content 报错。

常见问题

加密强度完全一致,都是 RSA 2048 或 ECDSA P-256。区别在验证等级与保障:免费 DV 只验证域名控制权,有效期 90 天,无人工客服与赔付;付费 OV/EV 需核验企业资质,有效期最长 398 天,附带商业保险与技术支持。个人站、博客、API 用免费证书足够,电商金融建议 OV。

CA/Browser Forum 规定自 2020-09-01 起,公有信任 SSL/TLS 证书有效期上限为 398 天,所以“买一年”实际签发 398 天。后续还会继续缩短:2026-03-15 起降为 200 天,2027-03-15 起降为 100 天。务必建立自动续期与到期告警,不要依赖人工续费。

先执行 nginx -t 检查配置语法,再 ss -lntp | grep 443 确认端口在监听。若 443 未监听,多半是 ssl_certificate 路径错误导致 Nginx 启动失败,看 journalctl -u nginx -n 50 的具体报错。若前面有 CDN 或负载均衡,还要确认安全组放行 443 入站。

桌面 Chrome 会自动下载中间证书补链,看起来正常;但 Android 旧版本、Java 客户端、curl、Python requests 会直接报 unable to get local issuer certificate 而握手失败。正确做法是 ssl_certificate 指向 fullchain.pem(站点证书 + 中间证书),兼容性最好。

可以。用 SAN(Subject Alternative Name)扩展在一张证书里放多个域名,或申请通配符证书 *.example.com 覆盖所有一级子域。注意通配符只匹配一级(a.example.com 可以,a.b.example.com 不行),且 Let’s Encrypt 通配符必须用 DNS-01 验证,不能走 HTTP-01。

主流浏览器(Chrome、Firefox、Safari、Edge)均要求 HTTP/2 必须运行在 TLS 之上,纯 HTTP 站点只能用 HTTP/1.1。开启 HTTPS 后在 Nginx 中加 http2 on(1.25.1+)即可启用多路复用,静态资源加载通常提升 20%-50%。HTTP/3 基于 QUIC,同样强制加密。

内容审核

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