跳到主要内容
Nginx

JoySSL SSL 证书 Nginx 安装部署实战:PEM 证书链、TLS 1.3 与排错验证

本文面向在 Nginx 上部署 JoySSL 签发 SSL 证书的运维与开发人员,覆盖文件准备、完整命令、配置示例、格式对比、真实报错排查与验证闭环。文中命令可直接执行,示例域名 example.com 请替换为实际域名。

问题背景与根因:为什么 Nginx 部署 SSL 证书容易失败

JoySSL 是国产 CA,提供免费 DV 与价格亲民的付费证书,中文审核流程与本地化支持对国内用户友好。把 JoySSL 签发的证书部署到 Nginx 时,Nginx 只认 PEM 格式,且必须使用 fullchain.pem(站点证书加中间证书)与私钥 .key。很多旧教程只上传叶子证书,浏览器可能因缓存或 AIA 补链正常,但 curl、Java、小程序、Android 旧版本会报证书链不完整。根因通常有四类:文件放错或权限不足;证书链不完整;证书与私钥不匹配;改完配置未 reload。另一个过时点是有效期:自 2020-09-01 起,公有 TLS 证书最长有效期 398 天,Let’s Encrypt 证书有效期为 90 天,建议提前 30 天续期。旧教程中的 TLSv1、TLSv1.1、SHA1 套件应淘汰,生产配置至少启用 TLSv1.2 与 TLSv1.3。排查前先确认 Nginx 编译参数:nginx -V 查看是否带 --with-http_ssl_module,openssl version 查看 OpenSSL 版本;若 Nginx 不支持 TLSv1.3,需要升级 Nginx 或 OpenSSL 后重新编译。理解这些根因后,后续步骤按“准备文件、校验匹配、配置、重载、验证”执行,才能避免反复重启仍不生效。

完整实操步骤(一):准备证书文件与私钥

在 JoySSL 控制台选择 Nginx/PEM 下载包,通常得到 fullchain.pem 与 example.com.key;不要只取站点证书 leaf.pem。上传前建立目录并限制权限:

sudo install -d -m 700 /etc/nginx/ssl
sudo install -m 600 fullchain.pem /etc/nginx/ssl/example.com_fullchain.pem
sudo install -m 600 example.com.key /etc/nginx/ssl/example.com.key
ls -l /etc/nginx/ssl

随后做三项硬校验。第一,看证书主题、签发者、有效期和 SAN:

openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

第二,确认链中不止一张证书:

grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com_fullchain.pem

正常应大于等于 2;只有 1 说明是叶子证书。第三,核对证书与私钥模数 MD5 一致。RSA 证书执行:

openssl x509 -noout -modulus -in /etc/nginx/ssl/example.com_fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/ssl/example.com.key | openssl md5

两条输出必须相同。若使用 ECDSA 证书,改用 openssl ec -noout -text 检查公钥,不能套用 RSA modulus 命令。证书最长有效期 398 天,Let’s Encrypt 为 90 天,部署时把到期日写入监控,提前 30 天续期,避免续期后忘记替换文件。

完整实操步骤(二):上传、校验、启用与重载 Nginx

以下命令可直接按顺序执行,示例域名 example.com 请替换。先上传文件到临时目录,再安装到 /etc/nginx/ssl:

scp fullchain.pem example.com.key root@server:/tmp/
ssh root@server
sudo install -d -m 700 /etc/nginx/ssl
sudo install -m 600 /tmp/fullchain.pem /etc/nginx/ssl/example.com_fullchain.pem
sudo install -m 600 /tmp/example.com.key /etc/nginx/ssl/example.com.key
sudo rm -f /tmp/fullchain.pem /tmp/example.com.key

备份原配置并写入新站点配置。若使用 Debian/Ubuntu,可放到 /etc/nginx/sites-available/example.com.conf 并软链到 sites-enabled;若使用 CentOS/RHEL,可放到 /etc/nginx/conf.d/example.com.conf。写入后先做语法检查:

sudo nginx -t

输出 nginx: configuration file /etc/nginx/nginx.conf test is successful 才继续。然后平滑重载:

sudo systemctl reload nginx
sudo systemctl status nginx --no-pager
sudo nginx -T | grep -E 'ssl_certificate|ssl_protocols|server_name'

确认 443 已监听:

sudo ss -tlnp | grep ':443'
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload

若使用 ufw,执行 sudo ufw allow 443/tcp。注意 reload 只重读配置,不重新加载系统信任库;续期后若文件路径未变但内容已替换,reload 即可生效;若路径变化,必须确认 nginx -T 中显示的是新文件。最后不要忘记 80 端口跳转,否则用户访问 http 仍会明文或 404。

Nginx 配置示例:443、HTTP/2、TLS 1.2/1.3 与 80 跳转

下面配置同时覆盖 443 主站和 80 跳转。Nginx 1.25.1 及以上推荐使用 http2 on;;旧版本可继续在 listen 中写 http2。不要启用 TLSv1 与 TLSv1.1:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl http2;
    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;
    ssl_session_tickets off;
    add_header Strict-Transport-Security max-age=31536000 always;
    root /var/www/example.com;
    index index.html;
}

说明:fullchain.pem 必须包含站点证书与中间证书;私钥权限 600、属主 root。若站点挂 CDN,HSTS 先在低 max-age 测试,避免回滚困难。若使用 ECDSA 证书,ssl_ciphers 中 ECDHE-ECDSA 套件需与证书类型匹配。配置中不要写 ssl on;,该指令已废弃。改完执行 sudo nginx -t 与 sudo systemctl reload nginx。验证配置最终值:sudo nginx -T | grep -E 'ssl_certificate|ssl_protocols|listen 443'。若出现 duplicate listen options for 0.0.0.0:443,检查是否在同一 server 或 upstream 重复写 http2。

证书格式与部署方式对比表:PEM、PFX、JKS 与常见 Web 服务器

JoySSL 控制台通常提供多种格式下载,选错格式会导致 Nginx 启动失败。Nginx 使用 PEM:fullchain.pem 加私钥 .key;Apache 使用 CRT/KEY 或 PEM;Tomcat、Java 使用 JKS 或 PKCS12;IIS 使用 PFX。下表用于快速判断:

格式/文件 典型文件 适用环境 Nginx 是否可直接用 关键注意点
PEM 证书链 fullchain.pem Nginx、Apache、HAProxy 是 必须含中间证书,不能只放叶子证书
PEM 私钥 example.com.key Nginx、Apache 是 权限 600,勿泄露
PKCS12 example.com.pfx Windows IIS、Java 否,需转换 包含证书与私钥,需密码
JKS example.com.jks Tomcat、Java 应用 否 需 keytool 导入,注意别名
DER/CER example.com.cer 部分设备、旧系统 否,需转 PEM 二进制格式,openssl x509 -inform der 转换

转换示例:PFX 转 PEM 可执行 openssl pkcs12 -in example.com.pfx -clcerts -nokeys -out cert.pem 与 openssl pkcs12 -in example.com.pfx -nocerts -nodes -out key.pem,再合并链。有效期方面,公有 TLS 证书最长 398 天,Let’s Encrypt 为 90 天;免费 DV 适合测试和个人站点,OV/EV 适合企业品牌与合规场景。无论哪种证书,Nginx 侧只认 PEM 链加私钥,格式不对时先转换再部署,不要直接改扩展名。

常见错误排查:真实报错与逐条修复

报错一:nginx: [emerg] cannot load certificate /etc/nginx/ssl/example.com_fullchain.pem: PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)。原因是文件不存在、权限不足或内容不是 PEM。执行 ls -l /etc/nginx/ssl 与 openssl x509 -in /etc/nginx/ssl/example.com_fullchain.pem -noout -text;若提示 no start line,重新下载 Nginx/PEM 包,不要使用 DER 或 PFX 改后缀。

报错二:nginx: [emerg] SSL_CTX_use_PrivateKey_file(/etc/nginx/ssl/example.com.key) failed (SSL: error:0B080074:x509 certificate routines::key values mismatch)。这是证书与私钥不匹配。分别执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 和 openssl rsa -noout -modulus -in example.com.key | openssl md5,两个 MD5 必须一致;不一致说明上传了旧私钥或另一张证书的私钥。

报错三:curl: (60) SSL certificate problem: unable to get local issuer certificate。浏览器正常但 curl、Java、小程序失败,通常是链不完整。执行 openssl s_client -connect example.com:443 -servername example.com -showcerts 查看输出证书数量,应至少包含站点证书和中间证书;Nginx 的 ssl_certificate 必须指向 fullchain.pem。Java 还可能报 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target,需把中间证书链补全,并确认 Java 信任库包含对应根证书。

报错四:改完配置访问仍是旧证书。执行 sudo nginx -T | grep ssl_certificate 确认加载路径,再 sudo systemctl reload nginx;若用了容器或负载均衡,还要 reload 容器内 Nginx 或更新证书挂载。续期后不生效,检查是否只替换了 /tmp 文件而配置仍指向旧路径。

效果验证:openssl、curl、浏览器与 SSL Labs 四层检查

第一层看握手与链:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep 'Verify return code'

Verify return code 应为 0 (ok)。若为 20 或 21,分别查链不完整与证书过期。第二层用 curl 验证主机名与信任链:

curl -I https://example.com
curl -vI https://example.com 2>&1 | grep -E 'SSL certificate verify|subject:|issuer:'

应出现 SSL certificate verify ok。第三层看协议与端口:

sudo ss -tlnp | grep ':443'
sudo nginx -T | grep -E 'ssl_certificate|ssl_protocols|listen 443'
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null

最后一条应失败,说明 TLSv1.1 已禁用。第四层用浏览器开发者工具看 Security 面板,再用 SSL Labs 或 Qualys 扫描,目标至少 A 级;若使用 CDN,扫描到的是 CDN 边缘证书,需在源站和 CDN 两端分别确认。最后把到期日写入监控:openssl x509 -in fullchain.pem -noout -enddate,建议提前 30 天续期。JoySSL 免费 DV 与付费证书均按此流程验证,区别主要在审核材料与信任展示。

常见问题

以下问题按 Nginx 部署 JoySSL 证书的高频场景整理,答案可直接用于排查与选型。

可以用于个人站点、测试环境和一般 HTTPS 加密。免费 DV 只验证域名控制权,不展示组织信息,有效期通常较短;涉及支付、API、企业品牌时建议选 OV/EV,并设置到期前 30 天续期提醒。


因为浏览器和客户端需要中间证书补齐信任链。只传叶子证书时,部分浏览器会缓存或 AIA 补链而正常,但 curl、Java、小程序和旧 Android 常报 unable to get local issuer certificate。fullchain.pem 应至少包含站点证书和中间证书。


RSA 证书分别执行 openssl x509 -noout -modulus -in fullchain.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两个 MD5 必须一致。ECDSA 证书不能用 modulus,应改用 openssl ec 检查公钥,并确认没有混用旧私钥。


先执行 nginx -T | grep ssl_certificate 确认配置指向的路径,再检查新证书是否真的覆盖到该路径。若使用容器、CDN 或负载均衡,还需更新挂载或边缘证书。浏览器缓存可换无痕窗口或 curl -I 验证。


生产环境建议只启用 TLSv1.2 与 TLSv1.3,禁用 TLSv1.0/1.1。Nginx 配置写 ssl_protocols TLSv1.2 TLSv1.3;,并配合现代 ECDHE 套件。若 Nginx 或 OpenSSL 版本过旧,先升级再启用 TLS 1.3。

内容审核

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