ZeroSSL SSL 证书 Nginx 安装部署教程:fullchain.pem 配置、排错与验证
问题背景与根因:为什么浏览器正常,curl/Java 却报证书错误
ZeroSSL 提供 90 天免费 DV 证书(网页流程或 ACME)以及付费 OV/EV。把证书部署到 Nginx 时,Nginx 需要 PEM 格式的 fullchain.pem 和私钥文件。最常见的根因不是证书没签发,而是只上传了叶子证书,缺少中间证书。浏览器会通过缓存或 AIA 补链,所以看起来正常;但 curl、Java、微信小程序、Python requests 等严格校验证书链的客户端会报 unable to get local issuer certificate。
另一个根因是有效期与续期认知过时。公共信任 TLS 证书单张最长有效期自 2026-03-15 起为 200 天,此前才是 398 天;ZeroSSL 免费 DV 仍为 90 天,截至 2026-05,Let’s Encrypt 默认也是 90 天。免费证书必须自动化续期,否则 90 天后就会出现 certificate has expired。本文按“准备文件 → 配置 → 校验 → 排错 → 验证”的顺序给出可直接执行的命令。
先确认现象:执行 openssl s_client -connect example.com:443 -servername example.com,如果输出 Verify return code: 21 (unable to verify the first certificate),基本就是链不完整;如果是 code 10 (certificate has expired),则检查续期任务和 Nginx 是否 reload。
准备证书文件:fullchain.pem、私钥、权限与目录
在 ZeroSSL 控制台下载“Nginx / PEM”包,通常包含 certificate.crt、ca_bundle.crt 和私钥。Nginx 的 ssl_certificate 应指向“站点证书 + 中间证书”的合并文件,顺序是叶子证书在前、中间证书在后:
sudo mkdir -p /etc/nginx/ssl
cd /path/to/zerossl
cat certificate.crt ca_bundle.crt | sudo tee /etc/nginx/ssl/example.com_fullchain.pem >/dev/null
sudo install -m 600 example.com.key /etc/nginx/ssl/example.com.key
sudo chown root:root /etc/nginx/ssl/example.com_fullchain.pem /etc/nginx/ssl/example.com.key
sudo chmod 644 /etc/nginx/ssl/example.com_fullchain.pem
检查文件内容与有效期:
grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com_fullchain.pem
openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -subject -issuer -dates
openssl rsa -in /etc/nginx/ssl/example.com.key -check -noout
openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -modulus | openssl md5
openssl rsa -in /etc/nginx/ssl/example.com.key -noout -modulus | openssl md5
两个 md5 必须一致;如果使用 ECC 私钥,用 openssl ec -in example.com.key -check -noout 并比较公钥。fullchain 中证书数量通常为 2 或 3,少于 2 说明中间证书没合并。私钥权限建议 600,不要让 Nginx 以外的用户读取。
完整实操步骤:上传、校验、reload 与回滚
先备份旧配置和证书,再上传新文件。以下命令在服务器上执行,示例域名为 example.com:
sudo cp /etc/nginx/conf.d/example.com.conf /etc/nginx/conf.d/example.com.conf.bak.$(date +%F)
sudo scp local_fullchain.pem root@server:/etc/nginx/ssl/example.com_fullchain.pem
sudo scp local_example.com.key root@server:/etc/nginx/ssl/example.com.key
sudo nginx -v
sudo nginx -t
nginx -t 返回 syntax is ok 和 test is successful 后才能 reload;失败时不要执行 reload,先按报错修配置。重载命令优先用 systemd:
sudo systemctl reload nginx
sudo systemctl status nginx --no-pager
sudo nginx -T | grep -E 'ssl_certificate|ssl_certificate_key|listen 443'
Nginx 1.25.1 起,listen 443 ssl http2; 中的 http2 参数已弃用,应改为 listen 443 ssl; 加 http2 on;。如果 reload 后仍是旧证书,检查是否有多个 server 块、include 顺序、容器内挂载路径,以及是否 reload 了错误的 Nginx 实例。回滚只需恢复备份并再次 nginx -t && systemctl reload nginx。
Nginx 配置示例:TLS 1.2/1.3、HSTS 与 301 跳转
下面配置只保留生产常用项,证书路径按实际域名替换。HSTS 首次上线建议先用较短 max-age,确认全站 HTTPS 后再加长。
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
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-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;
add_header Strict-Transport-Security 'max-age=31536000' always;
add_header X-Content-Type-Options 'nosniff' always;
location / {
root /var/www/example.com;
index index.html;
}
}
如果 Nginx 低于 1.25.1,删除 http2 on;,把 listen 443 ssl; 改为 listen 443 ssl http2;。不要把 ssl_certificate 指向 certificate.crt;也不要在 ssl_certificate 中只写中间证书。配置修改后执行 sudo nginx -t,成功再 sudo systemctl reload nginx。
证书格式与部署方式对比表格
ZeroSSL 下载包和不同服务器需要的格式不同,选错格式会出现“文件存在但加载失败”。下表用于快速判断:
| 项目 | 格式/方式 | 适用场景 | 注意点 |
|---|---|---|---|
| Nginx 证书 | PEM fullchain | Nginx、OpenResty | 叶子证书+中间证书合并,不能只放叶子 |
| Nginx 私钥 | PEM key | 与 fullchain 配对 | 权限 600,模数/公钥必须匹配 |
| Apache | PEM crt + chain | httpd 2.4 | SSLCertificateChainFile 指向中间证书 |
| Tomcat/Java | PKCS#12 或 JKS | Java 应用 | 用 keytool 导入,注意别名和密码 |
| Windows/IIS | PFX | IIS | 包含私钥,导入后绑定 443 |
| ZeroSSL 网页申请 | DV 90 天 | 新手单站 | 到期手动续,适合验证流程 |
| ZeroSSL ACME | ACME 自动签发 | 多站、自动化 | 用 acme.sh 或 certbot 配置续期钩子 |
有效期方面:ZeroSSL 免费 DV 为 90 天;公共信任 TLS 证书单张最长 200 天(2026-03-15 起,取代 398 天);Let’s Encrypt 默认 90 天。不要把“200 天”当成免续期理由,自动化续期仍是必须项。部署方式上,单站可先用网页下载,多站和频繁续期建议 ACME,并在续期后执行 systemctl reload nginx。
常见错误排查:真实报错与修复命令
报错 1:nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX() failed。原因多为路径错误、文件不是 PEM、或把 PFX 当 PEM。用 file /etc/nginx/ssl/example.com_fullchain.pem 和 openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -text 验证。
报错 2:SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。说明证书与私钥不配对。执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两个值必须一致。
报错 3:curl: (60) SSL certificate problem: unable to get local issuer certificate。这是链不完整,不是浏览器缓存问题。检查 ssl_certificate 是否指向 fullchain,并执行 openssl s_client -connect example.com:443 -servername example.com -showcerts 查看返回证书数量。只有 1 张证书就要重新合并中间证书。
报错 4:nginx: [emerg] unknown directive 'http2'。Nginx 低于 1.25.1 不支持 http2 on;,改用 listen 443 ssl http2;。报错 5:ERR_SSL_VERSION_OR_CIPHER_MISMATCH。检查 ssl_protocols 是否包含 TLSv1.2/1.3,以及客户端是否只支持旧协议。最后看日志:sudo tail -n 50 /var/log/nginx/error.log。
效果验证:openssl、curl 与 SSL Labs
部署后不要只看浏览器地址栏。先验证证书链和有效期:
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep 'Verify return code'
curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:'
期望看到 Verify return code: 0 (ok),并且 subject 是站点域名、issuer 是 ZeroSSL 的中间 CA。再验证协议:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | grep 'Protocol'
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null 2>/dev/null | grep 'Protocol'
ss -lntp | grep ':443'
最后用 SSL Labs 或 testssl.sh 检查评级、链、协议和 HSTS。若 curl 成功但 Java 仍报 PKIX path building failed,重点检查 fullchain 顺序和中间证书是否缺失;若 Verify return code 为 0 但浏览器提示过期,检查系统时间和证书 notAfter。
常见问题
ZeroSSL 免费 DV 证书有效期为 90 天;公共信任 TLS 证书单张最长有效期自 2026-03-15 起为 200 天,此前为 398 天。Let’s Encrypt 截至 2026-05 默认仍为 90 天,建议用 ACME 自动续期。
certificate.crt 通常只是站点叶子证书;fullchain.pem 是叶子证书加中间证书。Nginx 的 ssl_certificate 必须用 fullchain,否则 curl、Java、小程序可能报 unable to get local issuer certificate。
先确认配置路径指向新文件,再执行 nginx -t 和 systemctl reload nginx;用 nginx -T | grep ssl_certificate 检查实际加载配置。容器环境要确认挂载的是新文件,多实例要逐台 reload。
RSA 证书比较模数:openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,结果一致即匹配;ECC 证书比较公钥。不匹配时重新下载或重新签发。
建议 301 跳转,避免 HTTP 明文。若使用 ACME HTTP-01 验证,要确保 /.well-known/acme-challenge/ 可访问,或在 Nginx 中为该路径放行;也可改用 DNS-01 验证。