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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。