跳到主要内容
ssl证书按装

HTTPS 证书配置与 Nginx SSL 实战指南:从申请、部署到排查

HTTPS 证书配置与 Nginx SSL 实战指南:从申请、部署到排查 — 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。

证书类型与部署方式对比

选证书不要只看价格,先看验证级别、域名覆盖和续期方式。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。

内容审核

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