跳到主要内容
ssl证书按装

站点 SSL 证书配置 HTTPS 全流程实战:CSR 生成、Nginx/Apache 部署与证书链排错

站点 SSL 证书配置 HTTPS 全流程实战:CSR 生成、Nginx/Apache 部署与证书链排错 — 站点 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 续期成功后自动触发。

内容审核

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