跳到主要内容
Nginx

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 验证。

内容审核

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