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。