跳到主要内容
Nginx

ZeroSSL SSL 证书 Nginx 安装部署实战:fullchain、自动续期与报错排查

问题背景与根因

很多 ZeroSSL 教程只让把 certificate.crt 配到 Nginx,结果浏览器能打开,但 curl、Java、小程序或旧 Android 报证书链错误。根因不是 ZeroSSL 证书无效,而是 Nginx 的 ssl_certificate 必须指向「叶子证书 + 中间证书」合并后的 fullchain.pem;只配叶子证书时,服务器不会自动补中间证书。另一个高频根因是证书与私钥不匹配、私钥权限不对、续期后配置仍指向旧文件。先复现链问题:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,如果输出里只有一张证书,或 Verify return code 不是 0,就要检查 fullchain。有效期事实也要更新:公网可信 TLS 证书的 398 天上限已经过时,CA/B Forum 新规下 2026-03-15 起新签发证书最长 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天;ZeroSSL 免费 DV 常见 90 天,Let’s Encrypt 常见默认 90 天并推进 6 天短周期证书,实际以 CA 签发和 ACME 客户端为准。不要把旧教程里的 398 天当成现行上限。

准备证书文件与格式校验

ZeroSSL 控制台下载「Nginx / PEM」包后,常见文件是 certificate.crt、ca_bundle.crt、private.key,文件名以实际下载为准。Nginx 需要 PEM 格式,且 fullchain 顺序必须是站点叶子证书在前、中间证书在后;根证书通常不需要放入 fullchain。执行以下命令建立目录并合并:

sudo install -d -m 700 /etc/nginx/ssl
unzip zerossl-example.com.zip -d /tmp/zerossl
cat /tmp/zerossl/certificate.crt /tmp/zerossl/ca_bundle.crt | sudo tee /etc/nginx/ssl/example.com_fullchain.pem >/dev/null
sudo cp /tmp/zerossl/private.key /etc/nginx/ssl/example.com.key
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo chmod 644 /etc/nginx/ssl/example.com_fullchain.pem

校验证书主题、签发者、有效期和链数量:openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -subject -issuer -dates;grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com_fullchain.pem 一般应为 2 或更多。再核对证书与私钥是否匹配,RSA 和 ECDSA 都可用公钥哈希:openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -pubkey | openssl sha256 与 openssl pkey -in /etc/nginx/ssl/example.com.key -pubout | openssl sha256 的输出必须一致。若不一致,不要改 Nginx,重新下载或重新签发,避免把私钥和证书配错。

Nginx 完整配置步骤

先确认 Nginx 版本和 SSL 模块:nginx -v、nginx -V 2>&1 | grep -o with-http_ssl_module。Nginx 1.25.1 及以上建议写 http2 on;;旧版用 listen 443 ssl http2;,不要同时写两种。把配置放到 /etc/nginx/conf.d/example.com.conf,示例:

server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com;
    ssl_certificate     /etc/nginx/ssl/example.com_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;
    location / { root /var/www/html; index index.html; }
}
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

改完必须先生成校验:sudo nginx -t,看到 syntax is ok 和 test is successful 再执行 sudo systemctl reload nginx。如果报 nginx: [emerg] cannot load certificate,优先查路径、权限和文件是否 PEM;如果报 key values mismatch,回到上一节核对公钥哈希。不要在 443 的 server 里只写 ssl on; 这类旧指令,现代 Nginx 用 listen 443 ssl; 即可。

配置示例:TLS 参数、OCSP 与 HSTS 模板

在 443 server 内补充安全参数。OCSP stapling 可减少客户端查询 CA 的延迟,但要求 fullchain 含中间证书且 CA 支持 OCSP;不支持时 Nginx 会告警,可先关闭。模板:

ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com_fullchain.pem;
resolver 223.5.5.5 1.1.1.1 valid=300s;
resolver_timeout 5s;
ssl_ecdh_curve X25519:secp256r1;
add_header Strict-Transport-Security 'max-age=31536000' always;

HSTS 不要一开始就加 includeSubDomains 和 preload,确认所有子域都上 HTTPS 后再加,否则回退困难。TLS 1.3 的套件不由 ssl_ciphers 控制,ssl_ciphers 主要影响 TLS 1.2。验证协议与 OCSP:openssl s_client -connect example.com:443 -servername example.com -status </dev/null 2>/dev/null | grep -E 'Protocol|Cipher|OCSP response|Verify return code'。若出现 ssl_stapling ignored, issuer certificate not found,检查 ssl_trusted_certificate 是否指向完整链,或临时去掉 stapling 相关三行。最后再跑一次 sudo nginx -t && sudo systemctl reload nginx。

ZeroSSL、Let’s Encrypt 与付费证书对比

选型不要只看价格,要看验证类型、自动化能力、有效期和客户端兼容性。下表按 2026 年常见情况整理,实际以 CA 控制台和 ACME 客户端为准:

方案 典型有效期 验证类型 自动化 适用场景
ZeroSSL 免费 DV 常见 90 天 域名验证 网页或 ACME 个人站、测试、小型业务
Let’s Encrypt 常见默认 90 天,推进 6 天短周期 域名验证 ACME 成熟 自动化优先、容器与批量站点
ZeroSSL 付费 OV 受新规上限约束,2026-03-15 起最长 200 天 组织验证 部分支持 ACME/API 企业官网、需要组织信息
ZeroSSL 付费 EV 受新规上限约束 扩展验证 通常人工审核 金融、支付等高信任场景
自签名证书 自定义 无公共信任 脚本生成 内网测试,不能用于公网

注意两点:第一,现代浏览器已不再普遍为 EV 证书显示绿色地址栏,EV 的价值更多在组织审核和合规流程;第二,公网 TLS 证书最长有效期正在缩短,2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天,因此自动续期和 reload 比手工下载更重要。ZeroSSL 免费 DV 适合新手网页申请,Let’s Encrypt 更适合纯 ACME 自动化;如果业务要求 OV/EV,按 CA 审核材料准备营业执照、电话回拨等。

常见错误排查(含真实报错)

先看 Nginx 错误日志 tail -n 50 /var/log/nginx/error.log,再按报错定位。高频问题如下:

  • 证书文件加载失败:nginx: [emerg] cannot load certificate "/etc/nginx/ssl/example.com.crt": PEM_read_bio_X509_AUX() failed。原因多为路径不存在、权限不足、文件不是 PEM 或误传 DER。用 openssl x509 -in 文件 -noout -subject 验证,权限建议私钥 600、证书 644。
  • 证书与私钥不匹配:nginx: [emerg] SSL_CTX_use_PrivateKey(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。用上一节的公钥 SHA256 对比,不一致就重新下载证书和私钥。
  • 链不完整:curl: (60) SSL certificate problem: unable to get local issuer certificate,Java 报 PKIX path building failed: unable to find valid certification path to requested target。这通常不是浏览器问题,而是只配了叶子证书;把 ssl_certificate 改成 fullchain,并用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 检查是否返回中间证书。
  • 续期后仍旧证书:systemctl reload nginx 未执行、配置指向旧路径,或 CDN/负载均衡仍缓存旧证书。检查 openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -enddate 与线上 openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -enddate 是否一致。

若出现 nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate,先确认 fullchain 含中间证书;仍告警就关闭 stapling。排查顺序固定为:文件存在 → PEM 可读 → 证书链完整 → 公钥匹配 → nginx -t → reload → 线上验证。

自动化续期与 reload

手工下载不适合 90 天甚至更短周期。ZeroSSL 支持 ACME,可用 acme.sh 申请并安装证书。先安装并显式指定 ZeroSSL,避免默认 CA 变化:

curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --set-default-ca --server zerossl
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/example.com_fullchain.pem --reloadcmd 'systemctl reload nginx'

--reloadcmd 很关键:续期成功后自动 reload,否则磁盘证书更新、内存里仍旧证书。检查定时任务:systemctl list-timers | grep acme 或 crontab -l | grep acme。验证续期后文件时间与线上证书:stat -c '%y %n' /etc/nginx/ssl/example.com_fullchain.pem、openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -enddate。reload 与 restart 的区别:reload 会平滑加载新配置和新证书,通常足够;只有 reload 失败、进程异常或模块变更时才用 systemctl restart nginx。若使用 Docker/Kubernetes,把证书挂载为 Secret,并在更新后滚动重启或触发 reload。

效果验证与验收清单

部署完成后不要只看浏览器。依次执行:curl -sI http://example.com | grep -E 'HTTP/|Location' 应看到 301 和 https://;curl -sI https://example.com | grep -i strict-transport-security 应看到 HSTS 头;openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | grep 'Verify return code' 应为 0 (ok)。检查协议:openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>/dev/null | grep Protocol。检查链数量:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE' 应为 2 或更多。最后用 SSL Labs 或 curl -vI https://example.com 复核。

验收项 命令/检查点 通过标准
HTTP 跳转 curl -sI http://example.com 301 且 Location 为 HTTPS
证书链 openssl s_client -showcerts 叶子+中间证书,Verify 0
协议 openssl s_client -tls1_3 TLS 1.3 或至少 TLS 1.2
HSTS curl -sI https://example.com 有 Strict-Transport-Security
续期 acme.sh 定时任务与 reloadcmd 新证书自动加载

若验收失败,按「Nginx 配置 → 证书文件 → 链 → 私钥 → 进程 reload → CDN」顺序回查,不要直接重装 Nginx。

常见问题

ZeroSSL 免费 DV 常见为 90 天,但公网 TLS 证书上限已缩短:2026-03-15 起新签发最长 200 天,2027-03-15 起 100 天,2029-03-15 起 47 天。实际以控制台或 ACME 签发结果为准,别再按 398 天规划续期。

是。Nginx 的 ssl_certificate 应指向叶子证书加中间证书的 fullchain.pem;只配叶子证书时,curl、Java、小程序常报 unable to get local issuer certificate 或 PKIX path building failed。根证书通常不需要放入 fullchain。

先执行 nginx -t,通过后用 systemctl reload nginx 即可平滑加载新证书;只有 reload 失败、进程异常或更换模块时才用 restart。续期脚本里要写 –reloadcmd ‘systemctl reload nginx’,否则磁盘更新而内存仍旧证书。

比较公钥 SHA256:openssl x509 -in fullchain.pem -noout -pubkey | openssl sha256 与 openssl pkey -in example.com.key -pubout | openssl sha256,两条输出一致才匹配。RSA、ECDSA 都适用,不要只看文件大小或文件名。

优先查证书链是否完整。用 openssl s_client -connect example.com:443 -servername example.com -showcerts 看是否返回中间证书,并确认 Nginx 的 ssl_certificate 指向 fullchain.pem 而不是单张 certificate.crt。补全链后 reload 再测。

检查 install-cert 是否配置 –reloadcmd、配置路径是否指向新文件,并执行 systemctl reload nginx;再看 CDN、负载均衡或容器 Secret 是否仍缓存旧证书。用 openssl s_client 对比线上证书 enddate 与磁盘文件 enddate。

内容审核

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