跳到主要内容
HTTPS小程序证书

HTTPS/SSL 证书安装配置全流程:CSR 申请、Nginx 部署、真实报错排查与 A+ 验证

HTTPS/SSL 证书安装配置全流程:CSR 申请、Nginx 部署、真实报错排查与 A+ 验证 — HTTPS/SSL 证书安装配置全流程:CSR 申请、Nginx 部署、真实报错排查与 A+ 验证

一、问题背景与根因:HTTP 明文传输究竟泄露了什么

原文只给出了“防止流量劫持、防止数据篡改、防止监听”的结论,没有说明根因。根因在于 HTTP 协议本身不提供机密性与身份认证:请求头、Cookie、表单内容都以明文在 TCP 上传输,链路上任何一跳(公共 Wi-Fi、透明代理、运营商节点)都能读取和改写。可以先自己复现一次:

# 服务端抓取 80 端口明文请求,直接看到 Cookie 与表单
sudo tcpdump -i any -A -s 0 'tcp port 80' | grep -Ei 'Cookie|passwd|username'
# 客户端侧观察明文交互
curl -v http://example.com/login

输出里能直接看到 Cookie: PHPSESSID=... 与 username=admin&passwd=...。中间人只需在响应中插入一段 <script> 即可完成挂马或广告劫持,这就是“流量劫持”的技术本质。SSL/TLS 解决三件事:机密性(加密)、完整性(HMAC/AEAD)、身份认证(X.509 证书链)。

术语必须纠正:SSL 是 Netscape 1990 年代的协议,SSL 3.0 已在 2015 年被 RFC 7568 明确废弃,TLS 1.0/1.1 也在 2021 年被 RFC 8996 废弃。今天说“安装 SSL 证书”,实际部署的是 TLS 1.2/1.3 握手。当前正确基线是:只启用 TLS 1.2 与 TLS 1.3,禁用 SSLv3、TLS 1.0/1.1、RC4、3DES 以及 SHA-1 签名的证书。

关于“提升搜索排名”:Google 自 2014 年起把 HTTPS 作为轻量正向排名信号,百度也优先收录 HTTPS 资源,但其权重远低于内容质量与站点结构,把 HTTPS 当 SEO 银弹是过时认知。真正的收益是:地址栏不再显示“不安全”、HTTP/2 与 HTTP/3 在主流浏览器中仅在 HTTPS 下可用、Service Worker、地理位置、剪贴板等 Web API 要求安全上下文(Secure Context)。

二、证书类型与有效期:DV/OV/EV 选型与 398 天规则

证书必须由受信任的 CA(Certificate Authority)签发,浏览器与操作系统通过内置根证书库(Mozilla CA Program、Microsoft Trusted Root、Apple Root Store)验证证书链。按验证强度分三类:

类型 验证内容 信任等级 浏览器展示 典型场景
DV SSL 仅验证域名控制权(DNS/HTTP/文件) 普通 锁形图标 个人站、博客、APP 后端、API
OV SSL 验证域名 + 企业工商信息 强 锁形图标(证书详情含企业名) 政府、企业官网、SaaS
EV SSL 严格身份审核 + 人工核验 最高 锁形图标(绿色地址栏已取消) 金融、支付、需合规审计的场景

必须修正原文的过时说法:EV 证书“激活绿色地址栏”已经不成立。Chrome 77(2019 年 9 月)起移除了 EV 的绿色地址栏标识,Firefox 与 Safari 同样只显示普通锁形图标,EV 身份只能在证书详情中查看。EV 今天的价值在于金融合规与责任保险,而非视觉差异。

有效期规则同样变了:CA/Browser Forum 规定 2020-09-01 起,公开信任 TLS 证书单张有效期上限为 398 天(此前 825 天);Let’s Encrypt 固定 90 天。CA/B 已通过分阶段缩短路线图:2026 年 3 月起 200 天、2027 年 3 月起 100 天、2029 年 3 月起 47 天。这意味着“一年一换、手动上传”的运维方式必须改为 ACME 自动化。

免费 DV 来源 有效期 ACME 通配符 备注
Let’s Encrypt 90 天 支持(v2) 支持,需 DNS-01 生态最成熟,有速率限制
ZeroSSL 90 天 支持 支持 带 Web 控制台
Google Trust Services 90 天 支持 支持 需 EAB 凭据
TrustAsia 免费 DV 通常 1 年 部分支持 一般不支持 多由云厂商代发

Let’s Encrypt 速率限制要记牢:同一注册域名每周 50 张、完全相同的域名集合每周 5 张、验证失败每小时 5 次。

三、实操:生成私钥与 CSR(OpenSSL 命令可直接执行)

向任何 CA 申请证书,第一步都是本地生成密钥对与 CSR(Certificate Signing Request)。私钥永远不要发给 CA。推荐 ECDSA P-256(更小更快),需兼容老旧客户端时用 RSA 2048/3072。

# 1) ECDSA P-256 私钥(推荐)
openssl ecparam -genkey -name prime256v1 -out example.com.key
# 或 RSA 2048:openssl genrsa -out example.com.key 2048
chmod 600 example.com.key && chown root:root example.com.key

# 2) 生成 CSR,SAN 必须写全(含不带 www 的主域名)
openssl req -new -key example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

# 3) 自检:SAN、公钥算法、签名
openssl req -in example.com.csr -noout -text | grep -A2 "Subject Alternative Name"
openssl req -in example.com.csr -noout -verify

三个高频坑:其一,CN 已不是身份依据,现代浏览器只看 SAN(RFC 6125),漏写 SAN 会直接报 NET::ERR_CERT_COMMON_NAME_INVALID;其二,-addext 需要 OpenSSL 1.1.1 及以上,CentOS 7 自带的 1.0.2 会报 unknown option -addext,此时改用配置文件或升级 OpenSSL;其三,-subj 里写中文会乱码,用英文或拼音。

拿到 CA 签发的证书后,务必验证私钥与证书是否配对(不匹配会在 Nginx 启动时报 key values mismatch):

# RSA:比对模数
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5
# ECDSA:比对公钥
openssl x509 -noout -pubkey -in example.com.crt | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
# 查看有效期、主体、签发者与 SAN
openssl x509 -in example.com.crt -noout -dates -subject -issuer -ext subjectAltName

若用 DNS 验证,记得 TXT 记录名是 _acme-challenge.example.com,值随每次申请变化,且要等 TTL 生效再点验证,否则会拿到 urn:ietf:params:acme:error:unauthorized。

四、Let’s Encrypt 自动化签发与续期(certbot 实操)

90 天有效期意味着续期必须自动化。以 Ubuntu 22.04/24.04 + Nginx 为例:

sudo apt update && sudo apt install -y certbot python3-certbot-nginx
# 方式 A:插件自动改 Nginx 配置(首次最省事)
sudo certbot --nginx -d example.com -d www.example.com 
  --agree-tos -m ops@example.com --no-eff-email --redirect
# 方式 B:webroot,只签证书不动配置(推荐,配置自己掌控)
sudo certbot certonly --webroot -w /var/www/html 
  -d example.com -d www.example.com --agree-tos -m ops@example.com
# 方式 C:通配符,必须 DNS-01
sudo certbot certonly --manual --preferred-challenges dns 
  -d '*.example.com' -d example.com
# 续期演练,不消耗速率限制
sudo certbot renew --dry-run

证书落在 /etc/letsencrypt/live/example.com/:fullchain.pem(叶子证书 + 中间证书)、privkey.pem、chain.pem、cert.pem。注意 live/ 下是软链接指向 archive/ 里的时间戳文件,不要把文件复制到别处再引用,否则续期后 Nginx 仍在用旧证书,表现为“续期成功但浏览器提示过期”。

# /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
#!/bin/sh
systemctl reload nginx
# 赋权并验证钩子
sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-nginx.sh
sudo certbot renew --dry-run --run-deploy-hooks
systemctl list-timers | grep certbot

调试时反复签发极易触发 too many certificates already issued for exact set of domains,务必先用 --dry-run 或 staging 环境(--server https://acme-staging-v02.api.letsencrypt.org/directory)。通配符证书走 DNS-01,需要 DNS 服务商 API 凭据(certbot 的 --dns-* 插件,或改用 acme.sh / lego)。多台服务器场景建议只在一台签发,通过配置管理分发 fullchain.pem 与 privkey.pem。

五、配置示例:Nginx 开启 TLS 1.2/1.3、HSTS 与 OCSP Stapling

# /etc/nginx/conf.d/example.com.conf
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
    return 301 https://$host$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_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/letsencrypt/live/example.com/chain.pem;
    resolver 223.5.5.5 119.29.29.29 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 Content-Security-Policy "upgrade-insecure-requests" always;

    root /var/www/html;
    index index.html;
}

关键参数解释:ssl_certificate 必须指向 fullchain(叶子 + 中间),只给叶子证书时 Android、Java、curl 会报 unable to get local issuer certificate;ssl_prefer_server_ciphers off 让客户端决定顺序,配合 TLS 1.3 是现代推荐;ssl_session_tickets off 牺牲少量性能换取前向安全;OCSP Stapling 需要能解析 ocsp.int-x3.letsencrypt.org,内网无 DNS 时 stapling 会持续失败但不影响握手。HSTS 的 includeSubDomains 意味着所有子域都必须能用 HTTPS,若存在 http://legacy.example.com 会直接不可访问,首次上线建议先用 max-age=300 观察一天。

Apache 对应写法:SSLEngine on、SSLCertificateFile fullchain.pem、SSLCertificateKeyFile privkey.pem、SSLProtocol -all +TLSv1.2 +TLSv1.3、Header always set Strict-Transport-Security "max-age=31536000"。改完执行 nginx -t && systemctl reload nginx(Apache 为 apachectl configtest)。别忘了修页面里的 http:// 硬链接,否则浏览器报混合内容(Mixed Content),在 DevTools Console 过滤 Mixed Content 定位。

六、常见错误排查:真实报错与修复对照

真实报错 根因 修复
curl: (60) SSL certificate problem: unable to get local issuer certificate 只下发叶子证书,缺中间证书 改用 fullchain.pem
NET::ERR_CERT_COMMON_NAME_INVALID SAN 未包含访问域名 重新签发并写全 SAN
NET::ERR_CERT_DATE_INVALID 证书过期、客户端时间/时区错误 续期;校准 NTP
NET::ERR_CERT_AUTHORITY_INVALID 自签名或链上挂了未知 CA 换受信 CA;检查是否误带根证书
ERR_SSL_PROTOCOL_ERROR / SSL_ERROR_RX_RECORD_TOO_LONG 443 端口跑的是明文 HTTP(端口配错、CDN 回源协议错) 核对 listen 与回源协议
nginx: [emerg] ... X509_check_private_key:key values mismatch 证书与私钥不配对 按第三节方法比对公钥
PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line) 文件是 DER 格式、为空或含 BOM openssl x509 -inform DER -in cert.der -out cert.pem
Problem binding to port 80: Could not bind to IPv4 or IPv6 standalone 模式 80 被 Nginx 占用 停服务或改用 webroot
urn:ietf:params:acme:error:unauthorized /.well-known/acme-challenge/ 被 301 或防火墙拦截 放行路径、关闭该路径跳转

证书链不完整是最高频问题(约占线上故障七成)。手工合并时顺序是“叶子在前、中间在后、绝不带根”:

cat example.com.crt intermediate.crt > fullchain.crt
# 验证服务端实际下发的链
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | grep -E 'i:|s:'

若 grep 结果里只有一条 s: 和一条 i:,说明没带中间证书;正确输出应有两级(叶子 + 中间)。排查顺序建议固定为:证书文件内容 → 证书链 → 域名匹配 → 有效期 → 协议与套件 → 应用层混合内容,逐层排除比盲目改配置快得多。

七、效果验证:从命令行到 SSL Labs A+ 评级

# 1) 证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates
# 2) 强制旧协议,应当握手失败
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null
# 3) 301 跳转与 HSTS 头
curl -sI http://example.com | head -3
curl -sI https://example.com | grep -i strict-transport-security
# 4) OCSP Stapling 是否生效
openssl s_client -connect example.com:443 -servername example.com -status </dev/null 
  | grep -A2 "OCSP Response Status"
# 5) 第三方评级(异步任务)
curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done" | head -40
# 6) 加密套件枚举
nmap --script ssl-enum-ciphers -p 443 example.com

A+ 的判定清单:仅启用 TLS 1.2/1.3、无 RC4/3DES/EXPORT 套件、无 SHA-1 签名证书、支持前向保密(ECDHE)、HSTS max-age 不少于 6 个月、证书链完整、无 POODLE/FREAK/Logjam 等降级漏洞、支持 TLS 1.3。注意 openssl s_client 默认不校验主机名,可能给出误导性结论,严谨验证要加 -verify_hostname example.com -verify_return_error。

CDN 场景还要检查回源段:源站与 CDN 之间若仍是 HTTP,攻击者可在回源链路劫持,应在 CDN 侧选择 Full(严格)模式并配置源站证书或受信 CA。最后做一次全站巡检:grep -rniE 'http://' /var/www/html --include=*.html 找出残留硬链接,并在浏览器 DevTools 的 Security 面板确认显示 “Connection is secure” 与有效证书链。

常见问题

Let’s Encrypt 免费证书与付费 DV 证书,浏览器信任度一样吗?

一样。两者都由浏览器内置根证书库信任,握手与锁形图标无差别,差别在有效期(90 天对 398 天内)、SLA、责任赔付、OCSP/CRL 可用性与是否支持自定义有效期。免费证书的隐性成本是必须做好自动化续期。

能不能一次签发多年期证书,省掉续期麻烦?

不能。公开信任 TLS 证书单张有效期上限为 398 天(2020-09-01 起生效),且 CA/B 论坛已确定分阶段缩短:2026 年 3 月 200 天、2027 年 3 月 100 天、2029 年 3 月 47 天。任何声称“买五年一次部署”的方案,要么是私有 CA,要么需要客户端手动信任,公网不可用。

通配符证书 *.example.com 能覆盖哪些域名?

只覆盖一级子域,如 a.example.com、b.example.com;不覆盖 example.com 本身(需在 SAN 里单独添加),也不覆盖 a.b.example.com(多级子域需另签 *.b.example.com)。通配符证书只能通过 DNS-01 验证签发,因此 DNS API 凭据的保管是关键安全边界。

部署完成后浏览器仍提示“不安全”,怎么定位?

先看提示文案:NET::ERR_CERT_DATE_INVALID 是过期或客户端时间错,NET::ERR_CERT_COMMON_NAME_INVALID 是 SAN 不含该域名,锁形图标带黄色三角多半是混合内容。在 DevTools Console 过滤 Mixed Content 可列出具体 http:// 资源,配合 Content-Security-Policy: upgrade-insecure-requests 可批量升级。

HSTS 开启后发现某个子域只有 HTTP,如何回退?

把 max-age 逐步调小(如 31536000 → 86400 → 0)并观察,浏览器会在下次收到响应后更新策略;但一旦提交到 hstspreload.org 预加载列表,移除需要数月且各浏览器版本节奏不同。因此首次上线建议先 max-age=300、不加 includeSubDomains,确认全站 HTTPS 后再逐步加严。

内网系统或测试环境必须用自签名证书,怎么让客户端不报错?

不要关闭校验,而是自建私有 CA:用 openssl req -x509 -newkey rsa:4096 -days 3650 -keyout ca.key -out ca.crt -subj "/CN=Internal CA" 生成根证书,签发服务器证书时把 SAN 写全,然后把 ca.crt 导入客户端/服务器的信任库(Linux 放 /usr/local/share/ca-certificates/ 后执行 update-ca-certificates;Java 用 keytool -importcert;浏览器走系统信任库)。测试环境也可用 mkcert 一键生成本地受信证书。

内容审核

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