HTTPS 证书配置与 Nginx SSL 实战指南:从申请、部署到排查
问题背景与根因:为什么只加 https:// 不等于完成 HTTPS
SSL/TLS 主要提供三项服务:认证用户和服务器,确保数据发送到正确的客户机与服务器;加密数据,防止传输途中被窃取;维护数据完整性,确保内容不被篡改。浏览器出现锁形图标,只说明 TLS 握手和证书校验通过,并不代表页面内所有资源都走 HTTPS。常见根因包括:证书域名与访问域名不一致,缺少 www 或 SAN;只部署站点证书,未拼接中间 CA,导致链不完整;私钥与证书不匹配;Nginx 仍写 ssl on; 或只监听 80;云安全组、防火墙未放行 443;程序把图片、JS、CSS 写成 http://,触发 Mixed Content,表现为 HTTPS 页面错乱。证书有效期也要注意:公共 CA 签发的 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,必须做续期。排查时先执行 nginx -t、查看 /var/log/nginx/error.log,再用 openssl s_client 验证证书链,不要先改业务代码。
准备证书:CSR、Let’s Encrypt 与证书链文件
先确认域名解析到目标服务器,并开放 80/443。商业证书可用 OpenSSL 生成 CSR 和私钥:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
将 CSR 提交给 CA,下载站点证书和中间 CA。Nginx 的 ssl_certificate 应指向完整链文件,顺序是站点证书在前、中间 CA 在后,根证书通常不放。拼接命令:
cat example.com.crt ca_bundle.crt > fullchain.pem
sudo mkdir -p /etc/nginx/ssl
sudo cp fullchain.pem /etc/nginx/ssl/example.com.fullchain.pem
sudo cp example.com.key /etc/nginx/ssl/example.com.key
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo chown root:root /etc/nginx/ssl/example.com.fullchain.pem /etc/nginx/ssl/example.com.key
Let’s Encrypt 更简单,Ubuntu/Debian 可执行:
sudo apt update
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d example.com -d www.example.com
sudo certbot renew --dry-run
签发后检查有效期、域名和私钥匹配:
openssl x509 -noout -dates -subject -issuer -in /etc/nginx/ssl/example.com.fullchain.pem
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
两条 modulus 的 MD5 必须一致,否则会报 key values mismatch。
Nginx 完整实操步骤:从安装到 reload
先确认版本和目录。Nginx 1.25.1 及以上使用 http2 on;,1.18 至 1.24 可用 listen 443 ssl http2;。不要再写 ssl on;,该指令已废弃并在新版本移除。
nginx -v
sudo mkdir -p /etc/nginx/ssl
sudo cp fullchain.pem /etc/nginx/ssl/example.com.fullchain.pem
sudo cp example.com.key /etc/nginx/ssl/example.com.key
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo nginx -t
sudo systemctl reload nginx
如果使用 Ubuntu 防火墙,放行 Nginx Full;CentOS/RHEL 使用 firewalld:
sudo ufw allow 'Nginx Full'
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
云服务器还要在安全组放行 TCP 80 和 443。修改配置后必须先 nginx -t,成功再 reload;不要直接 restart,避免配置错误导致全站中断。若 certbot 自动改写配置,检查它是否把证书路径写成了 /etc/letsencrypt/live/example.com/fullchain.pem 与 privkey.pem。最后用 curl -I https://example.com 验证状态码和跳转。
配置示例:80 跳转 443 与安全参数
以下配置可直接放入 /etc/nginx/conf.d/example.com.conf,PHP 路径按实际版本调整。HSTS 建议在确认全站 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;
ssl_stapling on;
ssl_stapling_verify on;
resolver 1.1.1.1 8.8.8.8 valid=300s;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
add_header X-Content-Type-Options 'nosniff' always;
root /var/www/html;
index index.html index.php;
location / {
try_files $uri $uri/ =404;
}
location ~ [.]php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
}
说明:TLS 1.3 的套件不由 ssl_ciphers 控制;ssl_stapling 需要证书带 OCSP URL 且 resolver 可用;如果站点使用反向代理,把 location / 改为 proxy_pass http://127.0.0.1:8080; 并保留上述 SSL 参数。配置完成后执行 sudo nginx -t && sudo systemctl reload nginx。
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
证书类型与部署方式对比
选证书不要只看价格,先看验证级别、域名覆盖和续期方式。DV 适合博客与一般企业站,OV 适合需要组织信息核验的业务,EV 已不再显示绿色地址栏,但仍有较高审核要求。公共证书最长有效期 398 天,Let’s Encrypt 为 90 天。
| 类型 | 验证内容 | 签发速度 | 适用场景 | 有效期 |
|---|---|---|---|---|
| DV | 仅验证域名控制权 | 分钟级 | 博客、测试、普通企业站 | 最长 398 天 |
| OV | 域名 + 组织信息 | 1 至 3 天 | 电商、企业官网、支付入口 | 最长 398 天 |
| EV | 严格组织核验 | 数天 | 金融、高信任场景 | 最长 398 天 |
| Let’s Encrypt | 域名控制权 | 分钟级 | 自动化部署、个人站 | 90 天 |
| 自签名 | 自行签发 | 即时 | 内网测试,不适合公网 | 自定义 |
部署方式上,Certbot 适合有 shell 权限的 Nginx 服务器,可自动续期;商业证书适合需要 OV/EV 和人工支持的业务;自签名只用于内网联调。若使用 CDN,证书要同时部署在源站和 CDN,并确认回源协议为 HTTPS,否则仍可能出现混合内容或证书告警。
常见错误排查(含真实报错)
1)nginx: [emerg] cannot load certificate "/etc/nginx/ssl/example.com.fullchain.pem": PEM_read_bio_X509_AUX() failed。多为路径错误、权限不足或文件不是 PEM。执行 ls -l /etc/nginx/ssl、openssl x509 -in 文件 -noout -text 检查。2)SSL_CTX_use_PrivateKey("/etc/nginx/ssl/example.com.key") failed: key values mismatch。证书和私钥不匹配,用前文 modulus 命令比对,重新下载匹配文件。3)浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID。证书未包含当前域名,检查 SAN:openssl x509 -noout -text -in fullchain.pem | grep -A1 ‘Subject Alternative Name’。4)页面错乱并报 Mixed Content: The page at ‘https://…’ was loaded over HTTPS, but requested an insecure resource ‘http://…’。这是程序硬编码 http 链接,不是证书安装失败,改 CMS 站点地址、图片、JS、CSS 和 CDN 地址。5)curl: (60) SSL certificate problem: unable to get local issuer certificate。证书链不完整,ssl_certificate 必须用 fullchain,不要只填站点证书。6)ERR_SSL_VERSION_OR_CIPHER_MISMATCH 或 SSL_ERROR_NO_CYPHER_OVERLAP。客户端与服务器协议不兼容,确认 ssl_protocols 至少包含 TLSv1.2,并用 openssl s_client -tls1_2 测试。7)nginx: [warn] the "ssl" directive is deprecated。删除 ssl on;,改为 listen 443 ssl;。排查顺序:nginx -t → tail -f /var/log/nginx/error.log → openssl s_client -connect example.com:443 -servername example.com。
效果验证:命令、浏览器与续期检查
先验证跳转和响应头:
curl -I http://example.com
curl -I https://example.com
curl -vI https://example.com
预期 http 返回 301,https 返回 200 或业务状态码,并出现 strict-transport-security。再验证证书链和有效期:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | openssl x509 -noout -dates -subject -issuer
ss -lntp | grep ':443'
sudo nginx -t
sudo systemctl status nginx
浏览器打开开发者工具 Security 面板,确认证书有效、无混合内容;再用 SSL Labs 或 testssl.sh 检查协议、套件和链。Let’s Encrypt 要执行 sudo certbot renew –dry-run,并确认 systemd timer 或 cron 已启用。最后检查日志:tail -f /var/log/nginx/error.log,观察是否有 SSL_do_handshake 或 upstream 错误。
常见问题
公共 CA 签发的 TLS 证书最长有效期为 398 天,Let’s Encrypt 为 90 天。到期前必须续期,否则浏览器会报证书过期。建议用 certbot renew –dry-run 验证自动续期,并监控到期时间。
填完整链文件 fullchain.pem,不是单独站点证书。该文件应包含站点证书和中间 CA,顺序为站点证书在前、中间 CA 在后。ssl_certificate_key 填对应私钥,权限设为 600,属主 root。
多数不是。常见原因是页面内图片、JS、CSS 或接口仍写 http://,触发 Mixed Content。应修改 CMS 站点地址、模板硬编码、CDN 和第三方资源为 HTTPS,再用浏览器开发者工具确认无混合内容。
执行 openssl s_client -connect example.com:443 -servername example.com -showcerts,检查输出是否包含站点证书和中间 CA;也可用 SSL Labs 或 testssl.sh。若 curl 报 unable to get local issuer certificate,通常就是链不完整。
安装 certbot 后执行 certbot renew –dry-run 测试续期。生产环境通常由 systemd timer 或 cron 每天运行 certbot renew。续期成功后需 reload Nginx,可加 deploy-hook 执行 systemctl reload nginx。