跳到主要内容
ssl证书按装

SSL 证书选型与 HTTPS 配置实战:从 CSR 生成到泛域名证书部署与排错

SSL 证书选型与 HTTPS 配置实战:从 CSR 生成到泛域名证书部署与排错 — SSL 证书选型与 HTTPS 配置实战:从 CSR 生成到泛域名证书部署与排错

一、问题背景与根因:HTTP 站点为什么必须升级 HTTPS

原文只罗列了“HTTPS 的六大好处”,却没有讲清根因。HTTP 是明文协议,请求与响应在公网上以明文传输,既没有身份校验,也没有完整性校验,任何中间节点(运营商、公共 Wi-Fi、透明代理)都能读取、插入甚至整段替换内容。所谓“网站被镜像、被插广告、被劫持”,本质都是缺少 TLS 提供的机密性与完整性保护。

更现实的压力来自平台强制要求:微信小程序的 wx.request 只允许 https:// 且要求 TLS 1.2 及以上,域名还必须在小程序后台“服务器域名”中登记;iOS 的 ATS 默认禁止明文 HTTP;Chrome、Edge 对含密码或支付表单的 HTTP 页面直接标记“不安全”。

判断站点当前状态,先跑这两条命令:

curl -sI http://www.example.com | head -n 5
openssl s_client -connect www.example.com:443 -servername www.example.com &1 | head -n 20

第一条若返回 200 且没有 301 跳转,说明仍在明文提供页面;第二条若报 connect: Connection refused 或 tlsv1 alert protocol version,说明 443 未监听,或只支持已被淘汰的 TLS 1.0/1.1(RFC 8996 已于 2021 年正式弃用这两个版本)。

典型线上现象:小程序后台提示 request:fail url not in domain list;浏览器地址栏显示“您的连接不是私密连接 NET::ERR_CERT_COMMON_NAME_INVALID”。这些多数不是“证书买错了”,而是证书链不完整、域名覆盖范围不对或协议版本过低,后文逐条给出排查方法。

二、证书类型与域名覆盖:DV/OV/EV 与单域名、多域名、通配符怎么选

按验证强度分三类。DV(域名验证)只校验域名控制权,通过 DNS TXT 记录、HTTP 文件或 WHOIS 邮箱验证,通常 10 分钟内签发;OV(组织验证)额外核验企业名称、地址、电话,需 1–3 个工作日;EV(扩展验证)验证最严,但必须修正一个过时说法——Chrome 77 起已取消 EV 证书的“绿色地址栏”,现在只能在证书详情里看到组织名,所谓“买 EV 就有绿栅”已不成立。

按覆盖范围分三类,这是最容易踩坑的地方:

覆盖类型 示例 可保护域名 不覆盖
单域名 www.abc123.com 仅 www.abc123.com abc123.com、app.abc123.com
多域名(SAN) 一张证书写多个域名 SAN 列表内任意域名 列表之外的域名
通配符(泛域名) *.abc123.com www、app、api 等全部一级子域 abc123.com 本身、a.b.abc123.com

另一个必须记住的规则:自 2020 年 9 月 1 日起,所有公有信任 CA 签发的 SSL/TLS 证书最长有效期被限制为 398 天;Let’s Encrypt 免费证书为 90 天。这意味着“一次配置管三年”的时代彻底结束,必须建立自动续期机制,否则到期当天全站不可访问。

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

证书申请从密钥对开始。推荐 RSA 2048 位或 ECC P-256;RSA 2048 在 398 天有效期内仍然安全,新项目建议直接用 ECC,握手更快、包体更小。

RSA 方式:
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key

ECC 方式:
openssl ecparam -genkey -name prime256v1 -out example.com.key

生成 CSR 时把主域名写进 CN,把全部需要保护的域名写进 SAN(现代浏览器只看 SAN,不看 CN):
openssl req -new -key example.com.key -out example.com.csr -subj “/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Technology Co.,Ltd/CN=example.com” -addext “subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com”

提交前务必自查,确认 SAN 列表完整:
openssl req -noout -text -in example.com.csr | grep -A2 “Subject Alternative Name”

如果是通配符证书,CN 与 SAN 都写 *.abc123.com;若还要同时保护裸域,SAN 写成 DNS:*.abc123.com,DNS:abc123.com。

证书签发下来后第一件事是核对证书与私钥是否配对,避免上线时 Nginx 直接起不来:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两条输出必须完全一致;ECC 证书改用 openssl x509 -noout -pubkey 与 openssl pkey -pubout 比对公钥。

四、实操步骤二:Nginx 与 Apache 配置示例

关键点只有三个:证书文件必须是“服务器证书 + 中间证书”拼接的 fullchain;私钥权限 600;HTTP 一律 301 跳到 HTTPS。

Nginx(/etc/nginx/conf.d/example.conf):

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
    ssl_prefer_server_ciphers off;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 1d;
    ssl_stapling        on;
    ssl_stapling_verify on;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
    root /var/www/example;
    index index.html;
}

Apache(httpd-ssl.conf):
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3

改完先做语法检查再 reload,不要直接 restart 造成连接中断:
nginx -t && nginx -s reload
apachectl configtest && systemctl reload httpd

注意 ssl_trusted_certificate 与 ssl_certificate 指向不同文件:前者是纯中间证书(不含服务器证书),后者是 fullchain。两者混用会让 OCSP Stapling 静默失效,日志里看不出明显错误。

五、实操步骤三:398 天有效期下的自动续期与到期监控

398 天上限意味着任何手工续期方案都不可靠。免费方案首选 Let’s Encrypt(90 天)+ acme.sh 或 certbot,付费证书同样建议用脚本监控到期时间。

acme.sh 申请并自动部署,一次配置长期生效:
curl https://get.acme.sh | sh -s email=ops@example.com
acme.sh –issue -d example.com -d www.example.com –webroot /var/www/example
acme.sh –install-cert -d example.com –key-file /etc/nginx/ssl/example.com.key –fullchain-file /etc/nginx/ssl/fullchain.pem –reloadcmd “systemctl reload nginx”

certbot 方案:
certbot certonly –webroot -w /var/www/example -d example.com -d www.example.com
certbot renew –dry-run

证书更新后必须 reload 服务,否则 Nginx 仍使用内存里的旧证书——这是“证书明明续了,浏览器还报过期”的最常见原因。

监控脚本,crontab 每天 8 点执行,剩余不足 30 天即告警:
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -checkend 2592000 || echo “证书 30 天内到期” | mail -s “SSL 告警” ops@example.com

查看当前证书实际到期时间:
openssl x509 -in /etc/nginx/ssl/fullchain.pem -noout -subject -issuer -dates

六、常见错误排查:六类真实报错与修复方法

真实报错 根因 修复
NET::ERR_CERT_DATE_INVALID 证书过期或续期后未 reload nginx -s reload,核对 openssl x509 -dates
NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN SAN 不含该域名,通配符不覆盖裸域 重新签发并补 DNS:abc123.com
nginx: [emerg] SSL_CTX_use_PrivateKey_file(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 证书与私钥不匹配 用 -modulus 比对,替换为配对文件
curl: (60) SSL certificate problem: unable to get local issuer certificate 未部署中间证书 ssl_certificate 改为 fullchain.pem
微信小程序 request:fail ssl hand shake error TLS 版本过低或证书链不完整 开启 TLSv1.2/1.3,补齐中间证书
浏览器控制台 Mixed Content 警告 页面内仍引用 http:// 资源 改为相对协议或 https:// 绝对地址

排查顺序建议固定下来:先看服务端实际下发的证书,再看本地文件。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 观察返回几张证书,只有一张基本可以确定漏装中间证书。混合内容问题可用浏览器开发者工具 Console 面板直接定位到具体资源 URL,或用 curl -s https://example.com | grep -o "http://[^"]*" 批量扫出明文引用。

七、效果验证与上线检查清单

配置完成后逐条执行验证,不要只看浏览器是否出现小锁:

查看实际下发证书:
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates

验证证书链完整性,必须看到 Verify return code: 0 (ok):
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt &1 | grep “Verify return code”

验证旧协议已被禁用,应报 handshake failure 而非成功:
openssl s_client -connect example.com:443 -tls1_1 </dev/null

验证跳转与 HSTS 头:
curl -sI http://example.com | grep -i “location|HTTP/”
curl -sI https://example.com | grep -i strict-transport

检查项 命令/工具 通过标准
HTTP 强制跳转 curl -sI http://域名 返回 301 且 Location 为 https
证书链完整 openssl s_client -CAfile Verify return code: 0 (ok)
协议版本 openssl s_client -tls1_1 握手失败
HSTS curl -sI https://域名 存在 max-age 响应头
综合评级 Qualys SSL Labs A 及以上

最后提醒:若前面有 CDN 或负载均衡,证书要同时在 CDN 控制台上传更新,否则源站换了证书、边缘节点仍在用旧的,用户侧依旧报过期。

常见问题

不能。*.abc123.com 只匹配一级子域,裸域必须单独写入 SAN 或另购单域名证书。签发时把 CN 设为 *.abc123.com,并在 subjectAltName 追加 DNS:abc123.com,用 openssl req -noout -text 确认 SAN 列表,部署后再用 openssl s_client -connect abc123.com:443 -servername abc123.com 验证返回证书确实包含该域名。

自 2020 年 9 月 1 日起,公有信任 CA 签发的 SSL/TLS 证书最长有效期为 398 天;Let’s Encrypt 免费证书为 90 天。因此必须配置自动续期,例如 acme.sh 的 –install-cert 配合 –reloadcmd,或把 certbot renew 加入 crontab,并用 openssl x509 -checkend 做到期告警,不能依赖人工记忆。

先确认服务已 reload,Nginx 不 reload 不会加载新证书;再用 openssl x509 -in fullchain.pem -noout -dates 核对文件到期时间;最后用 openssl s_client -connect 域名:443 -servername 域名 查看实际返回的证书序列号是否为新证书。若前面有 CDN 或负载均衡,还需在控制台同步更新证书。

说明服务器只下发了站点证书,没有下发中间证书,客户端无法把链补全到根 CA。修复方法:把 CA 提供的中间证书与站点证书按“站点证书在前、中间证书在后”的顺序拼成 fullchain.pem,Nginx 的 ssl_certificate 指向该文件,再用 openssl s_client -showcerts 确认实际下发了两张以上证书。

取决于子域数量。子域超过 3 个时,一张 *.abc123.com 通配符证书通常比多张单域名证书更便宜、管理成本更低;但通配符不覆盖裸域和多级子域(如 a.b.abc123.com),这类场景应选多域名 SAN 证书,把不同层级的域名写进同一张证书的 SAN 列表。

小程序要求 HTTPS 且 TLS 1.2 以上、证书链完整、域名已在小程序后台登记。先用 openssl s_client -connect 域名:443 -tls1_2 测试握手,再确认 nginx 的 ssl_protocols 至少包含 TLSv1.2;若用免费证书,重点检查是否漏装中间证书,最后确认后台“服务器域名”中的域名不带端口号。

内容审核

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