站点 SSL 证书配置 HTTPS 全流程实战:CSR 生成、Nginx/Apache 部署与证书链排错
一、问题背景与根因:HTTPS 为什么总是“看起来配好了、实际却报错”
浏览器地址栏的“不安全”提示、HTTP/2 与 Service Worker 强制要求安全上下文、Cookie 的 Secure 属性、以及搜索排名因素,都让 HTTPS 从可选项变成必选项。但在实际部署中,绝大多数失败并不是证书本身有问题,而是以下几个根因。
- 证书链不完整:只上传了服务器证书(server.crt),漏掉中间证书。桌面浏览器会通过 AIA 自动补链,看起来“正常”,但 curl、Java 客户端、老版本 Android、微信内置浏览器会直接报
unable to get local issuer certificate。 - 私钥与证书不匹配:CSR 与最终签发的证书不是同一对密钥,或上传时把 .key 与 .crt 弄混,Nginx 启动即失败。
- 对 SNI 的认知过时:老教程写“SSL 证书只能安装在独立服务器上,不能安装在虚拟主机”,这是 TLS 1.2 之前“单 IP 单证书”时代的结论。如今 SNI(Server Name Indication)已是主流浏览器、Nginx、Apache 2.2.12+、IIS 8+ 的标配,虚拟主机和共享主机同样能部署证书,前提是主机商开放 443 端口并支持 SNI。
- 有效期规则变化:自 2020 年 9 月起,公有 CA 签发的 TLS 证书最长有效期被限制为 398 天;Let’s Encrypt 免费证书固定 90 天,官方建议每 60 天续期一次。仍按“买三年、装一次”的思路运维,必然出现批量过期事故。
- 域名覆盖不全:只签了 example.com,却让用户访问 www.example.com,触发
NET::ERR_CERT_COMMON_NAME_INVALID。
先用一条命令定位问题在哪一层:openssl s_client -connect example.com:443 -servername example.com -showcerts。输出里若只有一张证书而没有中间证书,就是链不完整;若握手直接失败,则多半是端口、协议或私钥问题。
二、前置准备:私钥、CSR 与 SAN 扩展的正确生成方式
证书申请的第一步是生成私钥和 CSR(证书签名请求)。私钥建议在本地或跳板机生成,再把 CSR 提交给 CA,绝不要把私钥发给任何人。RSA 2048 位仍然通用,但 ECDSA P-256 在同等安全强度下握手更快、证书更小,是现代部署的首选。
# 方案 A:ECDSA P-256(推荐)
openssl ecparam -genkey -name prime256v1 -out example.com.key
# 方案 B:RSA 2048(兼容性兜底)
openssl genrsa -out example.com.key 2048
# 生成 CSR,关键是把裸域和 www 一起写进 SAN
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"
# 校验 SAN 是否写对(CA 只认 SAN,不认 CN)
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
签发完成后,务必做两项一致性校验:私钥权限必须为 600,且私钥与证书必须配对。注意 RSA 证书可以用 modulus 比对,ECDSA 证书没有 modulus,要用公钥摘要比对:
chmod 600 example.com.key
# RSA 场景
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
# ECDSA 场景(两条输出必须完全一致)
openssl pkey -in example.com.key -pubout -outform der | openssl sha256
openssl x509 -in example.com.crt -pubkey -noout -outform der | openssl sha256
另外要拼接 fullchain:cat example.com.crt intermediate.crt > example.com.fullchain.crt。顺序是“服务器证书在前、中间证书在后”,顺序颠倒同样会报链错误。根证书不要拼进去,服务端下发根证书会让握手包变大且无意义。
三、完整实操步骤:上传证书、启用 443 与自动续期
以下步骤以 Nginx + Linux 为例,命令可直接执行。核心原则是“先备份、再改配置、最后 reload”,不要用 restart 打断在线连接。
# 1. 备份现有站点配置
cp -a /etc/nginx/conf.d/example.conf /root/example.conf.bak.$(date +%F)
# 2. 建立证书目录并设置严格权限
install -d -m 700 /etc/nginx/ssl
install -m 644 example.com.fullchain.crt /etc/nginx/ssl/
install -m 600 example.com.key /etc/nginx/ssl/
# 3. 语法检查通过后再热加载(-t 失败时不要 reload)
nginx -t && nginx -s reload
# 4. 放行 443 端口(firewalld 与 ufw 二选一)
firewall-cmd --permanent --add-service=https && firewall-cmd --reload
ufw allow 443/tcp
如果使用 Let’s Encrypt 免费证书,可直接用 certbot 一条命令完成申请、写入配置和 301 跳转,并自动安装 systemd 定时器实现续期:
apt-get update && apt-get install -y certbot python3-certbot-nginx
certbot --nginx -d example.com -d www.example.com
--agree-tos -m ops@example.com --redirect --keep-until-expiring
# 确认续期定时器存在,并做一次演练
systemctl list-timers | grep certbot
certbot renew --dry-run
续期后需要让 Nginx 重新读取证书,可在 /etc/letsencrypt/renewal-hooks/deploy/reload.sh 中写入 nginx -s reload 并 chmod +x。注意 Let’s Encrypt 的 90 天有效期与 HTTP-01 验证要求 80 端口可达;若站点已全站强制跳转 HTTPS,需放行 /.well-known/acme-challenge/ 路径,否则续期会失败在 Invalid response from ... 404。
四、配置示例:Nginx 与 Apache 的推荐参数
只写 ssl_certificate 和 ssl_certificate_key 能跑通,但拿不到 A 级评分。下面的 Nginx 配置开启了 TLS 1.3、OCSP Stapling、HSTS,并关闭了会话票据。
server {
listen 80;
server_name example.com www.example.com;
location /.well-known/acme-challenge/ { root /var/www/certbot; }
location / { return 301 https://$host$request_uri; }
}
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+ 写法;旧版写 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/example.com.fullchain.crt;
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:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384;
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/example.com.chain.crt;
resolver 223.5.5.5 119.29.29.29 valid=300s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options nosniff always;
root /var/www/example;
}
Apache 2.4 的等价配置如下。注意 SSLCertificateChainFile 在 2.4.8 之后已废弃,只要 SSLCertificateFile 指向 fullchain 即可。
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
SSLSessionTickets off
Header always set Strict-Transport-Security "max-age=31536000"
DocumentRoot /var/www/example
</VirtualHost>
HSTS 有“不可逆”特性:一旦下发 max-age=31536000,浏览器在一年内只走 HTTPS。上线前先确认所有子域都支持 HTTPS,否则先不要加 includeSubDomains,更不要急着提交 preload 列表。
五、对比表格:证书类型、域名覆盖与部署形态
选型时先看验证级别,再看域名覆盖范围,最后看运维方式。需要说明的是,EV 证书地址栏的绿色公司名展示已被 Chrome 77+ 及主流浏览器取消,现在 EV 与 OV 在浏览器 UI 上几乎没有区别,其价值主要体现在合规审计和证书详情中的企业信息,不必为此支付高溢价。
| 验证级别 | 核验内容 | 签发时长 | 浏览器表现 | 典型场景 |
|---|---|---|---|---|
| DV 域名验证 | 仅验证域名控制权 | 分钟级 | 锁标,无组织信息 | 博客、API、内部系统 |
| OV 组织验证 | 核验企业工商信息 | 1-3 个工作日 | 锁标,证书详情显示企业名 | 企业官网、电商 |
| EV 扩展验证 | 严格身份与法律实体核验 | 3-7 个工作日 | 锁标,无绿色地址栏 | 金融、政企合规要求 |
| 域名覆盖 | 示例 | 能否覆盖 www | 能否覆盖二级子域 |
|---|---|---|---|
| 单域名 | example.com | 否 | 否 |
| 多域名 SAN | example.com + www.example.com + api.example.com | 是 | 需逐个列出 |
| 通配符 | *.example.com | 是 | 仅一级,a.b.example.com 不覆盖 |
有效期方面:公有 CA 签发的 TLS 证书最长 398 天,Let’s Encrypt 为 90 天,商业 CA 通常按 1 年售卖并在到期前 30 天提醒续签。运维上强烈建议统一走 ACME 自动化,把“人工记到期日”彻底去掉。
六、常见错误排查:真实报错与对应处置
下面这些报错在排障中出现频率最高,可直接按报错信息对号入座。
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)—— 私钥与证书不匹配。用第二节的 modulus/公钥摘要比对,重新配对文件。curl: (60) SSL certificate problem: unable to get local issuer certificate—— 缺中间证书。把 fullchain 换成“服务器证书 + 中间证书”的拼接文件。NET::ERR_CERT_COMMON_NAME_INVALID—— 访问的域名不在 SAN 列表中。补签 www 或改用多域名/通配符证书。curl: (7) Failed to connect to example.com port 443: Connection refused—— 服务未监听或防火墙未放行。检查ss -lntp | grep 443与云厂商安全组。nginx: [emerg] unknown directive "http2"—— Nginx 版本低于 1.25.1,改回listen 443 ssl http2;。AH01909: RSA certificate configured for example.com:443 does not include an ID which matches the server name—— Apache 的 ServerName 与证书域名不一致,或ServerAlias漏写。SSL_do_handshake() failed (SSL: error:14094416:SSL routines:ssl3_read_bytes:sslv3 alert certificate unknown)—— 客户端不信任该证书链,多见于自签证书或链中混入了错误根证书。certificate is not yet valid或certificate has expired—— 服务器时间漂移或证书确实过期。执行timedatectl set-ntp true校时,并检查续期定时器。
排查顺序建议固定为:DNS 解析 → 端口连通性 → 证书链完整性 → 私钥配对 → 域名匹配 → 协议与套件。按这个顺序走,通常 5 分钟内能定位到唯一根因。
七、效果验证:命令行、浏览器与在线检测三件套
配置完成不等于交付完成,必须做可复核的验证。以下命令可在任意一台能访问外网的机器上执行。
# 1. 状态码、跳转与 HSTS 头
curl -I https://example.com
curl -sI https://example.com | grep -i strict-transport-security
# 2. 证书主题、签发者、有效期(-servername 保证走 SNI)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 3. 快速取到期时间,用于监控脚本
end=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
echo "到期时间: $end, 剩余天数: $(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))"
# 4. 协议与套件枚举
nmap --script ssl-enum-ciphers -p 443 example.com
混合内容是“锁标已出但仍提示不安全”的最常见原因。用一条命令扫出页面里的 http:// 资源:curl -s https://example.com | grep -o 'http://[^"]*' | sort -u | head -20,把图片、JS、CSS、字体全部改成相对协议或 https 地址。此外还需确认 Content-Security-Policy 中未放行 http 源。
最后在 SSL Labs 跑一次完整评估:目标 A 及以上。拿不到 A 的典型扣分项是支持 TLS 1.0/1.1、启用 RC4/3DES、未开启 HSTS、证书链不完整。把剩余天数接入监控告警(阈值 21 天),HTTPS 才算真正“配置完成”。
常见问题
可以。原文“只能装独立服务器”的说法已过时。现代虚拟主机通过 SNI 在同一 IP 上区分域名,cPanel、宝塔、Plesk 等面板都支持上传或一键申请证书。前提是主机商开放 443 端口且支持 SNI;若确实不支持,再考虑 VPS 或前置 CDN。
公有 CA 签发的 TLS 证书最长 398 天,Let’s Encrypt 免费证书固定 90 天并建议每 60 天续期。商业 CA 多按 1 年售卖。运维上应使用 ACME 自动化续期,并设置到期前 21 天的监控告警,避免人工记日期导致过期。
能,但必须把两个域名都写进 SAN 扩展。CA 只校验 SAN,不再看 CN 字段。申请 CSR 时用 -addext “subjectAltName=DNS:example.com,DNS:www.example.com” 声明,或用 *.example.com 通配符证书一并覆盖。
先看证书是否有效、域名是否匹配,再排查混合内容。用 curl 抓取页面并过滤 http:// 资源,把图片、脚本、样式、字体改为 https 或相对协议;同时检查 CSP 是否放行 http 源。锁标正常但提示不安全,九成是混合内容。
不能。*.example.com 只匹配一级子域,如 www.example.com、api.example.com;a.b.example.com 不在覆盖范围内。若需要多级覆盖,要单独申请 *.b.example.com,或改用多域名 SAN 证书逐个列出。
不需要重启,执行 nginx -s reload 即可热加载新证书,不会中断现有连接。更稳妥的做法是在 /etc/letsencrypt/renewal-hooks/deploy/ 下放置可执行的 reload 脚本,让 certbot 续期成功后自动触发。