跳到主要内容
SSL证书安装配置

HTTPS 证书实战:从 CSR 申请、CA 证书链配置到 Nginx 部署与排错

HTTPS 证书实战:从 CSR 申请、CA 证书链配置到 Nginx 部署与排错 — HTTPS 证书实战:从 CSR 申请、CA 证书链配置到 Nginx 部署与排错

一、问题背景与根因:没有 HTTPS 的站点正在被浏览器判为不安全

2017 年 Chrome 56 开始把带密码或支付表单的 HTTP 页面标记为“不安全”,2018 年 Chrome 68 起对所有 HTTP 页面直接显示“不安全”。这套规则今天已经固化:微信小程序、公众号网页授权、支付宝开放平台、App 内嵌 H5 全部强制 HTTPS;HTTP/2、Service Worker、Geolocation、getUserMedia、Clipboard 等 API 只在安全上下文(Secure Context)下可用;Cookie 要设置 SameSite=None,必须同时带 Secure 属性。证书不再是“可选加分项”,而是域名能不能正常对外服务的必备条件。

根因在于明文 HTTP 的三个致命缺陷:无法验证服务端身份(DNS 劫持加中间人可冒充任意站点)、无法防篡改(运营商或代理可注入广告与脚本)、无法保密(Cookie、账号密码明文过网)。CA(Certificate Authority)体系用数字签名把“域名”和“公钥”绑定,浏览器内置根证书库(Mozilla CA Program、Chrome Root Store)作为信任锚,形成“站点证书 → 中间证书 → 根证书”的信任链,任一环缺失都会报错。

动手前必须先纠正两个流传很广的过时说法。第一,“买一张证书能用一年甚至三年”已不成立:CA/Browser Forum 规定自 2020-09-01 起,公共信任 TLS 证书单次签发有效期上限为 398 天(约 13 个月),Chrome 与 Safari 均强制执行,付费证书的“三年期”实际是三年订阅加每年重新签发。第二,“EV 证书能在地址栏显示公司名”也已作废:Chrome 77(2019)起移除 EV 指示,Firefox 同步取消,公司名称只能在证书详情里查看。

动手前先做两个 30 秒的现状检查:

curl -sI http://example.com | head -n 3
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

第一条若返回 200 且没有 Location 跳转,说明站点仍在用明文 HTTP;第二条若报 no peer certificate available,说明 443 端口上根本没有证书。

二、证书分级与覆盖范围:DV/OV/EV 到底差在哪

按验证强度,公共信任证书分为 DV、OV、EV 三档;按覆盖范围,分为单域名、多域名(SAN)、通配符三种。两者是正交维度,可以自由组合(例如“通配符 OV”)。

类型 CA 核验内容 签发时长 浏览器表现 典型场景
DV(Domain Validation) 仅验证域名控制权:DNS TXT、HTTP 文件或指定邮箱 1-10 分钟 锁图标 个人博客、API 网关、小程序后端、测试环境
OV(Organization Validation) 域名控制权 + 企业工商登记信息人工核验 1-3 个工作日 锁图标 企业官网、SaaS 门户、需向客户出示审计材料的业务
EV(Extended Validation) OV 全部内容 + 第三方电话回访、注册地址核验 3-7 个工作日 锁图标(Chrome 77+ 不再显示公司名) 金融、支付、政务,多为合规要求而非技术差异
覆盖范围 覆盖示例 不覆盖 备注
单域名 example.com www.example.com(除非 CA 赠送该 SAN) 最便宜,申请时务必确认是否含 www
多域名 SAN a.com、b.com、api.a.com 未列入 SAN 的任何域名 默认 3-5 个,可扩容至 100 个
通配符 *.example.com(覆盖 a.example.com) example.com 本身、a.b.example.com 通配符只匹配一级子域,裸域必须单独加进 SAN

选型结论很直接:加密强度与 DV/OV/EV 无关,三者都可以用 RSA 2048/4096 或 ECDSA P-256,TLS 握手强度取决于服务器配置而非证书等级。个人站点、内部系统、绝大多数业务后端选 DV 即可;只有招投标、支付通道接入、等保测评明确要求“企业型证书”时才需要 OV/EV。别为“地址栏显示公司名”多付钱,那个特性已经不存在了。

三、实操:生成私钥与 CSR 并提交 CA

CSR(Certificate Signing Request)包含公钥和主体信息,由私钥签名,可以公开传输;私钥绝不能离开服务器。以下命令可直接执行,先建目录并收紧权限:

mkdir -p /etc/ssl/example && cd /etc/ssl/example
umask 077
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
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'
chmod 600 example.com.key

关键点是 -addext subjectAltName:现代浏览器只看 SAN 扩展,完全忽略 CN 字段,只写 CN 会导致 hostname mismatch。需要 ECDSA 时改用:

openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'

ECDSA 握手更快、包更小,但 Android 4.x 等老客户端不支持,面向国内大量老设备时优先 RSA 2048。提交前自检 CSR 内容是否正确:

openssl req -in example.com.csr -noout -subject -text | grep -A1 'Subject Alternative Name'
openssl req -in example.com.csr -noout -verify

把 CSR 粘贴到 CA 控制台后,会拿到两个文件:站点证书(example.com.crt)和中间证书(intermediate.crt 或 ca-bundle)。根证书不要下载、也不要装到服务器上,它已经在浏览器和操作系统里。

四、实操:域名验证、CAA 记录与备案前置条件

DV 证书的核心是证明“你能控制这个域名”。三种验证方式各有适用面:

  • DNS-01:在域名下添加 TXT 记录,是唯一支持通配符的方式,也不要求 80 端口可达。
  • HTTP-01:在 http://example.com/.well-known/acme-challenge/<token> 放置指定内容,必须保证 80 端口对公网开放且没有异常跳转。
  • 邮件验证:向 admin@example.com 等管理员邮箱发确认信,适合无法改 DNS 的场景。

以 Let’s Encrypt 通配符证书为例,用 certbot 走手动 DNS 验证:

certbot certonly --manual --preferred-challenges dns 
  -d 'example.com' -d '*.example.com' 
  --agree-tos -m ops@example.com

终端会给出形如 _acme-challenge.example.com 的 TXT 记录值,添加后用 dig 确认全球解析生效再回车:

dig +short TXT _acme-challenge.example.com @8.8.8.8
dig +short TXT _acme-challenge.example.com @223.5.5.5

如果域名配置了 CAA 记录,CA 会检查是否授权自己签发,未授权的 CA 会直接拒绝(报错 CAA record forbids issuance)。检查并放行:

dig +short CAA example.com
# 需要放行 Let's Encrypt 时,添加记录:
# example.com. 300 IN CAA 0 issue "letsencrypt.org"

国内业务还有一个与证书无关但会卡住上线的前置条件:服务器位于中国大陆时,域名必须完成 ICP 备案,否则 80/443 会被拦截,验证和访问都会失败;使用香港或海外服务器无需备案,但需接受延迟。另外,HTTP-01 验证失败最常见的原因是站点把 80 全量 301 到 443、或 CDN 回源规则拦截了 /.well-known/ 路径,验证前临时放行即可。

五、配置示例:证书链拼接与 Nginx / Apache / Tomcat 部署

部署前先拼好证书链:顺序必须是“站点证书 → 中间证书”,根证书不能放进来,否则部分客户端会握手失败。先合并,再校验:

cat example.com.crt intermediate.crt > fullchain.pem
cp intermediate.crt chain.pem
openssl verify -CAfile chain.pem -untrusted chain.pem example.com.crt
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5

两条 md5 输出必须一致,否则就是证书与私钥不匹配。Nginx 配置(http2 on; 需要 1.25.1+,旧版本写成 listen 443 ssl http2;):

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

    ssl_certificate         /etc/ssl/example/fullchain.pem;
    ssl_certificate_key     /etc/ssl/example/example.com.key;
    ssl_trusted_certificate /etc/ssl/example/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;
    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;

    location / { root /var/www/html; index index.html; }
}
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

Apache 对应指令:SSLCertificateFile /etc/ssl/example/fullchain.pem、SSLCertificateKeyFile /etc/ssl/example/example.com.key、SSLCertificateChainFile /etc/ssl/example/chain.pem(2.4.8+ 可省略,因为 fullchain 已包含中间证书),并把 SSLProtocol 设为 all -SSLv3 -TLSv1 -TLSv1.1。Tomcat 在 server.xml 的 Connector 里配置 <SSLHostConfig> 下的 certificateFile、certificateKeyFile、certificateChainFile,或把 PEM 转成 PKCS12 后只指定 certificateKeystoreFile 与 certificateKeystorePassword。改完先测再重载:

nginx -t && systemctl reload nginx
apachectl configtest && systemctl reload apache2

六、常见错误排查:从真实报错定位到根因

下面这些报错几乎覆盖了 90% 的部署故障,按顺序对照即可。

  • NET::ERR_CERT_AUTHORITY_INVALID / curl: (60) SSL certificate problem: unable to get local issuer certificate:缺中间证书,服务器只发了站点证书。用 fullchain.pem 替换 ssl_certificate 后重载即可。
  • SSL_ERROR_BAD_CERT_DOMAIN / curl: (60) no alternative certificate subject name matches target host name:SAN 不含该域名。用 openssl x509 -noout -text -in cert.pem | grep -A1 'Subject Alternative Name' 核对,通配符不覆盖裸域与二级子域。
  • NET::ERR_CERT_DATE_INVALID:证书过期或服务器时间漂移。用 date -u 与 openssl x509 -noout -enddate -in cert.pem 对比,容器环境常见时区/时钟未同步。
  • nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed:文件里混入了说明文字、HTML 或根证书,用 openssl x509 -in cert.pem -noout -subject 逐段验证,只保留 -----BEGIN CERTIFICATE----- 到 -----END CERTIFICATE----- 的内容。
  • Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...':页面里写死了 http 资源。改成相对协议或 https 绝对地址,必要时加 Content-Security-Policy: upgrade-insecure-requests。
  • SSL_ERROR_RX_RECORD_TOO_LONG:把 HTTP 端口当 HTTPS 访问,或 Nginx 用了 listen 443 却未加 ssl 参数。
  • nginx: [emerg] bind() to 0.0.0.0:443 failed (98: Address already in use):端口被 httpd、docker-proxy 或旧进程占用,用 ss -lntp | grep :443 定位。

排查时优先用 openssl 直连,绕开浏览器缓存与 CDN:openssl s_client -connect 1.2.3.4:443 -servername example.com -showcerts,输出的证书链条数就是服务器实际发送的内容。若 CDN 与源站证书不一致,问题通常在 CDN 侧的上传配置而非源站。

七、效果验证与自动化续期

部署完成后做三层验证:握手层、应用层、评级层。握手层直接看协议版本、证书链与到期时间:

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep -E 'Protocol|Cipher|Verify return code'
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject -dates

Verify return code: 0 (ok) 是唯一可接受的结果;返回 20 或 21 分别代表“无法获取本地签发者证书”和“证书链校验失败”。应用层用 curl 验证跳转与 HSTS 头:

curl -sI http://example.com | head -n 2
curl -sI https://example.com | grep -Ei 'strict-transport-security|HTTP/'
curl -s -o /dev/null -w '%{http_code} %{ssl_verify_result}n' https://example.com

评级层用 SSL Labs 或 testssl.sh,目标是 A 及以上;若出现 B,通常是仍支持 TLS 1.0/1.1 或缺少 HSTS。证书有效期只有 398 天上限,Let’s Encrypt 更是 90 天,人工续期必然出事故,必须自动化。certbot 的续期链路:

certbot renew --dry-run
systemctl list-timers | grep certbot
# 续期成功后自动重载服务
certbot renew --deploy-hook 'systemctl reload nginx'

非 certbot 场景可加一条 cron 做到期告警,剩余不足 30 天时退出码为 1,可直接触发监控:

openssl x509 -checkend 2592000 -noout -in /etc/ssl/example/fullchain.pem || echo 'CERT EXPIRING'

最后提醒一句:开启 HSTS 前先确认所有子域都已支持 HTTPS,否则 includeSubDomains 会让未适配的子系统在 max-age 周期内彻底无法访问,且无法通过回滚配置立刻恢复。

常见问题

SSL 证书的有效期到底是多久?

公共信任 TLS 证书单次签发最长 398 天,这是 CA/Browser Forum 的强制上限,Chrome、Safari、Firefox 都会校验。Let’s Encrypt 免费证书固定 90 天。付费证书的“三年期”卖的是多年订阅,实际仍每年重新签发一次,所以续期自动化是必选项而非可选项。

免费 DV 证书和付费 DV 证书有技术差别吗?

加密强度没有差别,同样的 RSA 2048/ECDSA P-256 与 TLS 1.2/1.3 配置下握手安全性一致。差别在保障赔付额度、签发有效期(90 天对 398 天)、是否支持多域名与通配符、OCSP/CRL 稳定性、老客户端兼容性以及是否有工单支持。对外经营的商业站点建议至少保留一条可快速响应的付费通道。

已经有 HTTPS 证书了,还需要域名备案吗?

需要。ICP 备案是服务器位于中国大陆时对网站主办者的行政管理要求,与 TLS 完全无关;未备案域名解析到大陆机房会被拦截,表现为证书正常但页面打不开。使用香港或海外服务器无需备案,代价是访问延迟和跨境链路抖动。

通配符证书能同时覆盖 example.com 和 www.example.com 吗?

不能。*.example.com 只匹配一级子域,例如 a.example.com,不匹配裸域 example.com,也不匹配 a.b.example.com。正确做法是申请时把裸域一并加入 SAN:-d example.com -d '*.example.com',多数 CA 允许在同一张证书里混用。

私钥泄露或证书需要紧急更换时怎么处理?

第一步在 CA 控制台吊销旧证书(走 OCSP/CRL,不要只删文件),第二步重新生成密钥对并签发新证书,第三步逐台节点替换 fullchain 与私钥并 reload,第四步用 openssl s_client 直连每台源站 IP 确认已生效,最后检查访问日志中的异常来源。如果之前开过 HSTS,替换必须在一小时内完成,否则用户侧会持续报证书错误。

内容审核

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