跳到主要内容
安装配置教程

HTTPS 证书安装怎么操作:Nginx/Apache 全流程、命令与排错指南

https证书安装 — HTTPS 证书安装怎么操作:Nginx/Apache 全流程、命令与排错指南
核心结论

HTTPS 证书安装的核心是把站点证书与中间证书按“服务器证书→中间证书”顺序合并为 fullchain,私钥设为 600,再在 Nginx/Apache 的 443 虚拟主机中配置证书与私钥并 reload;只上传 leaf 证书会触发 NET::ERR_CERT_AUTHORITY_INVALID。以 Nginx 1.24/1.26 为例,ssl_protocols 设为 TLSv1.2 TLSv1.3,ssl_certificate 指向 fullchain.pem,ssl_certificate_key 指向 privkey.pem,nginx -t 通过后 systemctl reload nginx。Certbot 2.10+ 可用 certbot --nginx -d example.com -d www.example.com --redirect 自动写入配置,续期用 certbot renew --dry-run 验证,systemd timer 通常每日运行两次。验证命令:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 应返回 Verify return code: 0 (ok) 与 Protocol: TLSv1.3。常见报错 unable to get local issuer certificate 多为证书链不完整;key values mismatch 用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 对比即可定位。

问题背景与根本原因:HTTPS 证书安装后为什么仍提示不安全?

证书装上了、Nginx 也重启了,浏览器还是红锁——先别急着怀疑证书本身,绝大多数情况是下面四类根因之一。据 RFC 5280 第 6 节,客户端验证证书时必须构建一条”站点证书(leaf) → 中间证书 → 本地受信任根”的路径;服务器只发送 leaf 证书时这条路径断裂,OpenSSL 报 unable to get local issuer certificate,Chrome/Edge 报 NET::ERR_CERT_AUTHORITY_INVALID。

根因一:信任链没闭合(最常见)。据 Let’s Encrypt 文档,Nginx 的 ssl_certificate 必须指向 fullchain.pem(站点证书 + 中间证书,通常 2 张),ssl_certificate_key 指向 privkey.pem;指向 cert.pem 就只发了 leaf。先数一下证书张数:

# Certbot 默认目录:/etc/letsencrypt/live/<域名>/
grep -c 'BEGIN CERTIFICATE' /etc/letsencrypt/live/example.com/fullchain.pem
# 期望 >= 2;输出 1 说明链不完整(中间证书缺失)

# Nginx 正确写法(版本:Nginx 1.15+,ssl 模块默认编译)
server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 不是 cert.pem
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols       TLSv1.2 TLSv1.3;   # 参考 Mozilla SSL 配置生成器
}

根因二:私钥与证书不匹配。nginx -t 或 reload 时会直接报错:SSL_CTX_use_PrivateKey(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。用 OpenSSL 文档中的 modulus 对比法确认:

openssl x509 -in fullchain.pem -noout -modulus | openssl sha256
openssl rsa  -in privkey.pem  -noout -modulus | openssl sha256
# 两行哈希必须完全一致;不一致即证书与私钥来自不同签发请求(ECC 证书改用 -pubkey 比对)

根因三:域名覆盖不足。证书 SAN 里没有 www. 或 api. 子域时,只有那个域名报错:

openssl x509 -in fullchain.pem -noout -text | grep -A1 'Subject Alternative Name'
# 输出示例:DNS:example.com, DNS:www.example.com —— 需与实际访问域名逐字一致

根因四:TLS 在上游就被终止了。云负载均衡、CDN、WAF 已解密流量,源站 443 未放行或仍返回 HTTP:ss -lntp | grep ':443' 确认端口在监听,firewall-cmd --add-port=443/tcp --permanent 放行,安全组开 443/TCP,并让应用识别 X-Forwarded-Proto 以免重定向死循环。

根因 典型报错 一条命令定位
链不完整 unable to get local issuer certificate grep -c 'BEGIN CERTIFICATE' fullchain.pem
私钥不匹配 key values mismatch 两条 modulus 的 sha256 对比
SAN 未覆盖 ERR_CERT_COMMON_NAME_INVALID openssl x509 -text | grep -A1 'Alternative Name'
链路/回源 连接超时或 301 循环 ss -lntp | grep ':443'

时间与版本别忽略:Let’s Encrypt DV 证书有效期 90 天,官方建议剩余 30 天前完成续期;Certbot 2.10+ 只走 ACME v2,旧 ACME v1 端点已于 2019 年停用,继续用老客户端会报 acme-v01.api.letsencrypt.org 不可达。所以 https 证书安装 后仍不安全,先按”链 → 密钥 → 域名 → 链路”顺序排查,比反复重装证书快得多。

完整实操步骤:从证书文件到 443 端口生效(分步编号)

先说结论:把证书文件拷到服务器上并不等于装好,443 能否握手成功只看三件事——证书链是否完整、私钥是否匹配、配置有没有被进程真正加载。下面六步请按顺序执行,任何一步输出不符预期就停下来修,别往下走;这也是大多数 https证书安装 失败的真实原因,多半是跳过了第 2 步或第 6 步。

步骤 1 · 备份与校验。动手前先留退路,再用 OpenSSL 核对证书身份和有效期。

# 备份配置目录(Nginx)
cp -a /etc/nginx/conf.d /etc/nginx/conf.d.bak.$(date +%F)
# RHEL/CentOS 的 Apache
cp -a /etc/httpd/conf.d /etc/httpd/conf.d.bak.$(date +%F)

# 校验证书主体、签发者、有效期、SHA256 指纹
openssl x509 -in fullchain.pem -noout -subject -issuer -dates -fingerprint -sha256

输出中的 notBefore/notAfter 必须覆盖当前时间,可用 date -u 对比,注意是 UTC;SHA256 Fingerprint 要与 CA 后台显示的完全一致。据 OpenSSL 文档,-fingerprint -sha256 计算的是证书 DER 编码的摘要,所以要比对原始下发文件,别用被转码或复制粘贴过的副本。Let’s Encrypt 证书有效期 90 天,剩余不足 30 天应直接走续期流程。

步骤 2 · 合并证书链。顺序是硬性要求:站点证书在前,中间证书在后,根证书绝不能拼进来。

cat example.com.crt intermediate.crt > fullchain.pem

# 数证书张数:Let's Encrypt 常见为 2(叶子证书 + R1/R3 中间证书)
awk '/BEGIN CERTIFICATE/{n++} END{print n}' fullchain.pem

结果为 1 说明漏拼中间证书,客户端会报 unable to get local issuer certificate;为 3 及以上通常是把根证书也塞进去了,Android 与部分 Java 客户端会因此校验失败。RFC 8446 第 4.4.2 节明确要求 certificate_list 按“叶子 → 中间”顺序排列,且根证书由客户端自带。

步骤 3 · 放置文件并收紧权限。

# Nginx:目录 700,私钥 600,证书 644
install -d -m 700 /etc/nginx/ssl/example.com
cp fullchain.pem privkey.pem /etc/nginx/ssl/example.com/
chown root:root /etc/nginx/ssl/example.com/*
chmod 600 /etc/nginx/ssl/example.com/privkey.pem
chmod 644 /etc/nginx/ssl/example.com/fullchain.pem

# Apache(RHEL/CentOS 路径)
cp fullchain.pem /etc/pki/tls/certs/fullchain.crt
cp privkey.pem   /etc/pki/tls/private/privkey.key
chmod 600 /etc/pki/tls/private/privkey.key
restorecon -Rv /etc/pki/tls     # SELinux 为 enforcing 时必做

私钥 600 + root:root 是底线:Nginx master 进程以 root 读私钥后降权给 worker,因此 600 不影响启动;改成 644 就等于同机任何用户都能拷走私钥。RHEL 系漏掉 restorecon 的典型现象是 ls -l 权限看着没错,却报 cannot load certificate key ... Permission denied——那是 SELinux 上下文类型不对。

步骤 4 · 配置 Nginx 443。

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

    ssl_certificate     /etc/nginx/ssl/example.com/fullchain.pem;
    ssl_certificate_key /etc/nginx/ssl/example.com/privkey.pem;

    http2 on;                 # Nginx 1.25.1+ 写法
    # 旧版本只能写:listen 443 ssl http2;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_session_cache shared:SSL:10m;   # 默认 none
    ssl_session_timeout 1d;
}

据 Nginx 官方文档,1.25.1 起在 listen 行追加 http2 已废弃,会打印 the "listen ... http2" directive is deprecated 警告,需改用独立的 http2 on;;1.25.1 之前的版本则只能用旧的 listen 写法。

步骤 5 · 配置 Apache 2.4.8+。

a2enmod ssl                  # Debian/Ubuntu;RHEL 系用 dnf install -y mod_ssl

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile    /etc/pki/tls/certs/fullchain.crt
    SSLCertificateKeyFile /etc/pki/tls/private/privkey.key
    # 2.4.8 起中间证书直接拼在 SSLCertificateFile 中,
    # SSLCertificateChainFile 已被标记 deprecated,无需再写
</VirtualHost>

步骤 6 · 语法检查与平滑重载。这一步不做,前面五步等于白做。

nginx -t                    # 期望:syntax is ok / test is successful
systemctl reload nginx

apachectl configtest        # 期望:Syntax OK
systemctl reload httpd      # Debian/Ubuntu 服务名为 apache2

reload 是平滑加载,存量连接不断;只有新增模块、改 listen 端口这类必须重开 socket 的改动才用 restart。验证链是否真的生效:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 
  | grep -E 'Verify return code|s:|i:'
# 期望:Verify return code: 0 (ok),且 s: 出现两张证书
项目 Nginx Apache 2.4
证书存放目录 /etc/nginx/ssl/example.com/ /etc/pki/tls/certs(RHEL)或 /etc/ssl/certs(Debian)
私钥目录 同上(同目录) /etc/pki/tls/private
指定证书的指令 ssl_certificate SSLCertificateFile
指定私钥的指令 ssl_certificate_key SSLCertificateKeyFile
语法检查命令 nginx -t apachectl configtest
平滑重载 systemctl reload nginx systemctl reload httpd / apache2
私钥权限基线 600 root:root 600 root:root(httpd 由 root 读取)

完成以上六步后,一次成功的 https证书安装 就闭环了。若 curl -vI https://example.com 仍报 SSL certificate problem,先回头看第 2 步的证书张数,再查第 3 步的 SELinux 上下文,这两处占了实战排错的绝大多数。

配置/命令示例:Nginx、Apache、Certbot 与 OpenSSL 的具体写法

把证书文件放进服务器只是第一步,真正决定握手能否成功的是 Web 服务器里的 TLS 指令。下面按“参数文件 → 站点配置 → 签发 → 续期 → 验证 → 排错”的顺序给出可直接复制的写法。参数取值参考 Mozilla SSL Configuration Generator 的 intermediate 档位,该档位同时兼容 TLS 1.2 客户端与 TLS 1.3(RFC 8446)。

Nginx 1.24/1.26 的 TLS 参数应该写在哪、怎么写?

建议单独放 /etc/nginx/snippets/ssl-params.conf,再由各站点 include,避免每台虚拟主机重复维护。注意 ssl_session_tickets 在 Nginx 1.23.2 起默认值已改为 off,此处显式写出只是让配置自解释;ssl_session_timeout 默认 5m,调成 1d 可显著降低握手开销。

# /etc/nginx/snippets/ssl-params.conf
ssl_protocols TLSv1.2 TLSv1.3;                 # 关闭 TLSv1.0/1.1
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;                 # 默认 off,交给客户端选择更利于 TLS 1.3
ssl_session_cache shared:SSL:10m;              # 默认 none,10m 约可缓存 4 万个会话
ssl_session_timeout 1d;                        # 默认 5m
ssl_session_tickets off;                       # 1.23.2 起默认 off
add_header Strict-Transport-Security "max-age=31536000" always;  # 先别加 includeSubDomains

# /etc/nginx/conf.d/example.com.conf
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;      # 80 端口统一 301
}
server {
    listen 443 ssl;
    http2 on;                                  # 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;
    include snippets/ssl-params.conf;
    root /var/www/html;
}

改完执行 nginx -t && systemctl reload nginx;-t 通过再 reload,否则旧进程会继续持有失效配置。

Apache 2.4.58 对应写法是什么?

Apache 用 SSLProtocol 的“先清空再追加”语法(-all +TLSv1.2),与 Nginx 的白名单思路不同。Header 指令依赖 mod_headers,未启用会直接报 Invalid command 'Header'。

# 先确认模块:apache2ctl -M | grep -E 'headers|ssl'  (RHEL: httpd -M)
# 缺失则:a2enmod headers ssl  (RHEL: 在 conf.modules.d/00-base.conf 中确保 LoadModule headers_module ...)

# /etc/apache2/sites-available/example.com.conf
<VirtualHost *:80>
    ServerName example.com
    Redirect permanent / https://example.com/        # 或 RewriteRule ^ https://example.com%{REQUEST_URI} [R=301,L]
</VirtualHost>
<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile   /etc/letsencrypt/live/example.com/privkey.pem
    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite          ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384
    SSLHonorCipherOrder     off          # 默认 off
    SSLSessionTickets       off          # 默认 on
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
能力 Nginx 1.24/1.26 Apache 2.4.58 默认值差异
协议白名单 ssl_protocols TLSv1.2 TLSv1.3; SSLProtocol -all +TLSv1.2 +TLSv1.3 Apache 默认含 TLSv1.1
会话票据 ssl_session_tickets off; SSLSessionTickets off Nginx 1.23.2 起默认 off
HSTS 头 add_header ... always Header always set ... 均需显式配置

Certbot 一条命令能装完并自动跳转吗?

能。据 Let’s Encrypt 官方文档,Certbot 2.10+ 的 --nginx 插件会改写 443 站点并插入 80→443 跳转;certonly 则只签发不碰配置,适合已有自定义配置或负载均衡后端。

# 自动签发 + 安装 + 强制跳转(推荐先加 --dry-run 演练一次)
certbot --nginx -d example.com -d www.example.com --redirect --agree-tos -m ops@example.com

# 只签发,证书落在 /etc/letsencrypt/live/example.com/
certbot certonly --webroot -w /var/www/html -d example.com

ls -l /etc/letsencrypt/live/example.com/   # fullchain.pem 给 ssl_certificate,privkey.pem 给 key

怎么确认 90 天后续期不会翻车?

Ubuntu/Debian 的 certbot.timer 每天触发两次并带随机延迟,用 systemctl list-timers | grep certbot 查看下次运行时间;RHEL 9 需手动 systemctl enable --now certbot-renew.timer。加 --deploy-hook 让新证书落盘后自动 reload,否则 Nginx 会一直用旧证书直到手动重载。

certbot renew --dry-run                    # 用 staging 环境模拟,不消耗速率限制
certbot renew --deploy-hook 'systemctl reload nginx'   # 写入 /etc/letsencrypt/renewal-hooks/deploy/ 更规范
systemctl list-timers | grep certbot       # Debian/Ubuntu 应看到 certbot.timer

证书文件本身怎么验证?

按 OpenSSL 文档,verify 只校验链是否可信,rsa -check 校验私钥完整性,x509 -enddate 打印 notAfter。三者全过再谈握手。

openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt /etc/letsencrypt/live/example.com/fullchain.pem
# 期望输出:fullchain.pem: OK
openssl rsa -in /etc/letsencrypt/live/example.com/privkey.pem -check   # 期望:RSA key ok
openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -enddate

为什么跳转配完浏览器报 ERR_TOO_MANY_REDIRECTS?

因为 TLS 在负载均衡层就终止了,Nginx 看到的永远是 $scheme = http,于是无限 301。判断真实协议再决定是否跳转:

if ($http_x_forwarded_proto != "https") {
    return 301 https://$host$request_uri;   # 仅在请求确实来自 HTTP 时跳转
}

参数对比与方案选型表:Nginx、Apache、Certbot 与证书类型怎么选?

Nginx 和 Apache 到底该选哪个?先把四个方案的参数摊开对比

方案 证书文件 关键配置 检查命令 适用场景
Nginx 1.24 / 1.26 fullchain.pem + privkey.pem ssl_certificate / ssl_certificate_key nginx -t 高并发反向代理、静态站点
Apache 2.4.58 / 2.4.62 fullchain.crt + privkey.key SSLCertificateFile / SSLCertificateKeyFile apachectl configtest 传统 LAMP、虚拟主机
Certbot 2.10 –nginx /etc/letsencrypt/live/example.com/ 自动写入 443 server 块 certbot renew --dry-run 单机自动续期
云负载均衡(CLB/CDN) 控制台上传证书 监听器 443 + 后端协议 控制台健康检查 多实例、弹性伸缩

Nginx 必须指向 fullchain.pem(叶子证书 + 中间证书),只配 cert.pem 会让 Android 7 以下、部分 Java 客户端报 unable to get local issuer certificate——这是 https 证书安装后“浏览器正常、App 报错”最常见的原因。Apache 2.4.8 起 SSLCertificateChainFile 已废弃,链证书直接拼接进 SSLCertificateFile。

# Nginx 1.24/1.26 片段
server {
    listen 443 ssl;
    http2 on;                          # nginx 1.25.1+ 写法;1.24 及更早用 listen 443 ssl http2;
    server_name example.com;

    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;  # 含中间证书
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;    # 权限 600,属主 root

    ssl_protocols       TLSv1.2 TLSv1.3;   # 1.23.4 起默认值已不含 1.0/1.1,仍建议显式写死
    ssl_prefer_server_ciphers off;         # 1.11.0 起默认 off
}

# Apache 2.4.58/2.4.62 片段
<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile    /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
    SSLProtocol -all +TLSv1.2 +TLSv1.3      # mod_ssl 默认 SSLProtocol all,必须显式收窄
</VirtualHost>
nginx -t                    # 期望 syntax is ok / test is successful
apachectl configtest        # 期望 Syntax OK
certbot renew --dry-run     # 走 staging 环境演练续期,不消耗生产速率配额

免费 Let’s Encrypt 够用吗?DV、OV、EV 怎么选?

类型 验证方式 签发耗时 常见价格 适用
DV(含 Let’s Encrypt) 域名控制权(HTTP-01/DNS-01) 分钟级,Let’s Encrypt 有效期 90 天 免费 博客、API、内部系统
OV 组织主体核验 1–3 个工作日 500–2000 元/年 对外业务、需展示企业资质
EV 严格组织核验 3–7 个工作日 1500–5000 元/年 金融、合规审计要求

注意 EV 的“地址栏绿条 + 公司名”已被主流浏览器取消,如今只剩证书详情里的字段差异,除非合同或监管明确要求,否则不值得为它多付几倍成本。据 Let’s Encrypt 文档,其证书有效期 90 天、官方已公布逐步缩短至 45 天的路线图,因此自动续期比证书类型更值得投入精力;Certbot 默认在到期前 30 天触发续期,由 systemd timer 每日运行两次。

通配符证书能覆盖 example.com 吗?不能。*.example.com 只匹配一级子域,既不覆盖根域 example.com,也不覆盖 a.b.example.com。正确做法是把两者都写进 SAN:

# Let's Encrypt 通配符只能走 DNS-01,必须能改 _acme-challenge TXT 记录
certbot certonly --manual --preferred-challenges dns 
  -d "*.example.com" -d example.com    # 两条 -d 都要写,缺一不可
# --manual 无法自动续期;生产环境改用 certbot-dns-cloudflare 等插件

# 核对证书实际覆盖范围(OpenSSL 1.1.1+)
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -ext subjectAltName
# 期望:DNS:example.com, DNS:*.example.com

TLS 1.2 还留不留?据 RFC 8996,TLS 1.0/1.1 已被正式弃用,PCI DSS 也要求禁用;但 Windows 7 默认不支持 TLS 1.3,只支持 1.2,老旧内网终端未评估完就关掉 1.2 会直接中断业务。验证方式:

openssl s_client -connect example.com:443 -tls1_1 </dev/null
# 期望失败:alert protocol version 或 handshake failure

证书装在源站还是负载均衡?单机 Nginx/Apache 直接装证书控制力最强;用云 CLB/CDN 时在控制台上传证书、回源走 HTTP 更省事,但源站必须在应用层信任 X-Forwarded-Proto,否则后端仍以为请求是 HTTP,触发 301 重定向循环或混合内容告警;同时安全组要只放行 LB 的回源网段,避免别人绕过 HTTPS 直连源站 IP。

常见错误与真实报错排查:从 unable to load certificate 到重定向循环

为什么 Nginx 一启动就报 cannot load certificate ... BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)?

这个报错字面意思是”文件不存在”,但十次里有七次是路径拼错或某一级目录缺少执行(x)权限,而非文件真的不存在。先逐级看权限,再看属主:

# namei 会列出路径每一段的权限位与属主,缺 x 位的目录会直接标出来
namei -l /etc/nginx/ssl/example.com/fullchain.pem
# 查看 Nginx worker 实际以哪个用户运行(Ubuntu 包默认 www-data,RHEL 系默认 nginx)
ps -o user= -C nginx | sort -u
ls -l /etc/nginx/ssl/example.com/

关键点:私钥设成 600 root:root 是正确做法。Nginx master 进程以 root 启动并完成证书与私钥加载,worker 通过继承的文件描述符使用,并不需要自己读私钥——所以不要为了让 worker”能读”而把私钥改成 644。

报 SSL_CTX_use_PrivateKey ... key values mismatch 说明什么?

证书和私钥不是一对,常见于续期后只替换了其中一个文件。用模数哈希比对(RSA 证书):

# 两条命令输出的 sha256 必须完全一致
openssl x509 -in fullchain.pem -noout -modulus | openssl sha256
openssl rsa  -in privkey.pem  -noout -modulus | openssl sha256
# ECDSA 证书没有 modulus,改用公钥比对
openssl x509 -in fullchain.pem -noout -pubkey | openssl sha256
openssl pkey -in privkey.pem -pubout | openssl sha256

不一致就回 CA 后台重新下载匹配的证书与私钥文件,不要手工拼接。

浏览器报 NET::ERR_CERT_AUTHORITY_INVALID、curl 报 (60) unable to get local issuer certificate 怎么办?

服务器没发中间证书,或链的顺序反了。据 Let’s Encrypt 文档,cert.pem 只含叶证书,必须用 fullchain.pem(叶证书在前、中间证书在后)。验证方法:

# 数一数服务端实际下发的证书张数,正常 ≥ 2;同时看最后一行 Verify return code
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 
  | grep -c 'BEGIN CERTIFICATE'
openssl s_client -connect example.com:443 -servername example.com /dev/null 
  | grep 'Verify return code'   # 期望:0 (ok)

ERR_SSL_PROTOCOL_ERROR 或 curl: (35) ... handshake failure 从哪查?

多半是 443 端口上跑的根本不是 TLS,或协议/套件不交集、SNI 未命中默认 server 块。

ss -lntp | grep ':443'                       # 确认监听进程
nginx -T | grep -E 'listen|ssl_protocols'    # 确认 server_name 与协议版本
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | head -5
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null | head -5

ssl_protocols 在 Nginx 1.23.4 起的默认值是 TLSv1.2 TLSv1.3(更早版本默认含 TLSv1/1.1);Mozilla SSL Configuration Generator 也建议只保留这两项,老旧客户端握手失败属于预期行为。

Apache 报 AH02572: Failed to configure at least one certificate and key for example.com:443?

三类原因:SSLCertificateFile 路径错、文件里不含证书、SELinux 拒绝 httpd 读取私钥。

apachectl configtest                     # 先排除语法层错误
ls -lZ /etc/pki/tls/private              # 看安全上下文是否为 cert_t
restorecon -Rv /etc/pki/tls              # 修正被改乱的标签
ausearch -m avc -ts recent               # 有 denied 记录即确认是 SELinux

另外,Apache 2.4.8 起 SSLCertificateChainFile 已弃用,直接把完整链写进 SSLCertificateFile 即可。

浏览器报 ERR_TOO_MANY_REDIRECTS 是怎么形成的?

典型拓扑:云负载均衡已把 HTTPS 终止、以 HTTP 回源,源站 Nginx 又无条件 return 301 https://,于是无限跳转。用 map 依据回源头判断,避免二次跳转:

# 仅当请求不是经 LB 以 HTTPS 转发而来时才跳转
map $http_x_forwarded_proto $need_redirect {
    default 1;    # 直连 80 端口,无该头 → 跳转
    https   0;    # LB 已终止 TLS → 不再跳转,防止循环
}
server {
    listen 80;
    if ($need_redirect) { return 301 https://$host$request_uri; }
}

同时确认应用层配置:WordPress 若 siteurl 仍为 http://,会在应用内再跳一次,可用 wp option get siteurl 或查询 wp_options 表的 siteurl/home 两个字段核对。

报错关键字 根因 一条命令定位
BIO_new_file() failed 路径错 / 目录缺 x 权限 namei -l <证书路径>
key values mismatch 证书与私钥不配对 openssl x509 -noout -modulus | openssl sha256
unable to get local issuer certificate 缺中间证书或顺序错 openssl s_client -showcerts 数证书张数
ERR_SSL_PROTOCOL_ERROR 443 非 TLS / 协议不匹配 openssl s_client -tls1_2 与 -tls1_3 分别试
AH02572 路径错 / SELinux 拒绝 ausearch -m avc -ts recent
ERR_TOO_MANY_REDIRECTS LB 终止后源站重复跳转 curl -I http://example.com 看 Location 链

效果验证方法:如何确认 HTTPS 证书安装已生效?

浏览器出现小锁只说明“这一次握手成功了”,并不证明证书链完整、旧协议已关闭、跳转和 HSTS 已经到位。要判断 https 证书安装是否真正生效,按下面四层从本地命令行查到外部探针,每层都有明确的通过标准。

第一层:用 curl 看状态码和验证结果

# curl 7.52+ 在编译了 nghttp2 时默认协商 HTTP/2;8.x 的 -v 输出含 "SSL certificate verify ok."
curl -sI https://example.com | head -1
# 期望:HTTP/2 200(或 301,取决于站点是否做统一跳转)

curl -vI https://example.com 2>&1 | grep -E 'SSL connection|TLSv1.3|subject:'
# 期望三行:SSL connection using TLSv1.3 / ... 、subject: CN=example.com、SSL certificate verify ok.

如果出现 SSL certificate problem: unable to get local issuer certificate,通常不是本机 CA 库缺失,而是服务端只下发了叶子证书、漏发中间证书。据 Let’s Encrypt 文档,Nginx 的 ssl_certificate 必须指向 fullchain.pem,而不是 cert.pem。

第二层:用 openssl s_client 查看握手细节

# -servername 触发 SNI,必须带;否则可能连到该 IP 的默认站点证书
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | grep -E 'Verify return code|Protocol|Cipher'
# 期望:Verify return code: 0 (ok) / Protocol: TLSv1.3 / Cipher: TLS_AES_256_GCM_SHA384

返回码是关键信息:20 表示无法获取本地颁发者(证书链不完整),21 表示无法验证第一张证书,10 表示证书已过期,62 表示主机名不匹配。这些码值来自 OpenSSL 的 verify 手册页,比一句“证书有问题”更能定位问题。

第三层:协议边界——旧协议是否真的关闭

openssl s_client -connect example.com:443 -servername example.com -tls1_2 &1 | grep Protocol
# 期望:Protocol : TLSv1.2(应成功)

openssl s_client -connect example.com:443 -servername example.com -tls1_1 &1 | grep -iE 'no protocols|handshake failure|alert'
# 期望:sslv3 alert handshake failure 或 alert protocol version(服务端拒绝)

这里有个容易误判的地方:OpenSSL 3.0 起客户端侧默认 MinProtocol=TLSv1.2,如果报 no protocols available,失败可能来自你本机而不是服务端。区分办法是临时加 -cipher 'DEFAULT@SECLEVEL=0',或在 openssl.cnf 里下调 MinProtocol 后重测;只有看到服务端回的 alert,才说明 TLS 1.1 被服务端真正禁用。Mozilla SSL Configuration Generator 的 intermediate 档位默认只开 TLS 1.2 与 1.3(RFC 8446)。

验证项 命令 通过标准 失败含义
证书链 openssl s_client -showcerts Verify return code: 0 (ok) 20/21:缺中间证书
协议版本 -tls1_2 / -tls1_1 1.2 通、1.1 被拒 1.1 通:需改 ssl_protocols
到期时间 x509 -noout -enddate notAfter 剩余 > 30 天 剩余过短:续期任务未生效
跳转与 HSTS curl -sI 301 + max-age 无 301:HTTP 仍可明文访问

第四层:在线扫描、到期监控与 HSTS

# 到期时间(notAfter 为 UTC,注意服务器时间偏差会拖后或提前续期)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -enddate -issuer

# 外部探针:check_ssl_cert 1.100+(Debian/Ubuntu 包名 monitoring-plugins-check-ssl-cert)
check_ssl_cert -H example.com -w 30 -c 14   # 30 天告警,14 天严重

Qualys SSL Labs 打开 https://www.ssllabs.com/ssltest/analyze.html?d=example.com,重点看 Certificate 链是否完整、Protocols 是否只剩 TLS 1.2/1.3、HSTS 是否开启,目标 A/A+;单次扫描约 1–3 分钟,复测需先 Clear cache。Prometheus 侧可用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标设 30 天告警。

# 跳转与 HSTS:首次上线先把 max-age 设小,全站确认后再调大(RFC 6797)
curl -sI http://example.com | grep -iE '^HTTP|^location'      # 期望 301 + Location: https://example.com/
curl -sI https://example.com | grep -i strict-transport-security
# 期望:strict-transport-security: max-age=31536000; includeSubDomains

# nginx.conf(Nginx 1.25+)试水配置
add_header Strict-Transport-Security "max-age=300" always;

如果 Verify return code 不是 0,先别怀疑证书文件本身:用 openssl s_client -showcerts 数一数服务端到底发了几张证书,比反复重装 https 证书安装 更省时间。

一般不需要重启,执行 nginx -t 确认语法通过后 systemctl reload nginx 即可,reload 会平滑加载新证书且不断开现有连接。只有新增模块、修改 listen 端口或更换二进制时才用 systemctl restart nginx。

Nginx 建议放 /etc/nginx/ssl/example.com/,证书 644、私钥 600,属主 root:root;Apache 放 /etc/pki/tls/certs 与 /etc/pki/tls/private。RHEL/CentOS 还要执行 restorecon -Rv /etc/pki/tls,避免 SELinux 阻止 httpd 读取私钥。

个人站点、API、内部测试优先 Let's Encrypt DV,90 天有效、可自动续期、成本为 0;企业对外门户或需要组织验证时选 OV,常见价格 500-2000 元/年,验证 1-3 个工作日。EV 证书常见 1500-5000 元/年,浏览器 UI 优势已弱化,按合规要求选择即可。

多数是证书链不完整或顺序错误:把中间证书拼到站点证书后面,Nginx 的 ssl_certificate 指向 fullchain.pem,而不是只指向站点证书。用 openssl s_client -connect example.com:443 -servername example.com -showcerts

Nginx 在 80 端口的 server 块加 return 301 https://$host$request_uri;;Apache 用 Redirect permanent / https://example.com/ 或 RewriteRule 加 [R=301,L]。如果前面有云负载均衡,先用 $http_x_forwarded_proto 判断,避免源站再次跳转造成 ERR_TOO_MANY_REDIRECTS。

不能。*.example.com 只覆盖 a.example.com 这类一级子域,不覆盖 example.com,也不覆盖 a.b.example.com。申请时把 example.com 和 *.example.com 同时写入 SAN;Let's Encrypt 通配符证书必须使用 DNS-01 验证,需要能修改 _acme-challenge TXT 记录。

常见原因是仍开启 TLS 1.0/1.1、使用 RC4/3DES 套件、未启用 HSTS 或证书链包含根证书。按 Mozilla intermediate 配置只保留 TLSv1.2/1.3,移除根证书、启用 HSTS 后重新扫描,通常可回到 A/A+。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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