Nginx HTTPS 证书配置与 SSL 证书申请、续费全流程实战(含 398 天规则)
问题背景与根因:小程序、iOS 下载和广告劫持都绕不开 HTTPS
微信小程序、iOS 应用下载页、H5 支付页和现代浏览器都要求 HTTPS。小程序服务器域名必须是已备案域名并启用 HTTPS,TLS 版本需 1.2 及以上,证书链必须完整;自签名证书、域名不匹配、缺中间证书都会触发 request:fail ssl hand shake error。HTTP 明文传输还可能被中间人插入广告或下载劫持,HTTPS 加 HSTS 能显著降低这类风险,但它不是广告拦截插件,不能替代业务侧风控。
证书配置失败通常不是 Nginx 本身,而是根因集中在五处:证书文件用了 leaf 证书而非 fullchain、私钥权限或密码错误、域名 SAN 不匹配、安全组未放行 443、证书过期未续费。尤其要注意有效期规则已变化:公共可信 TLS 证书最长有效期为 398 天,Let’s Encrypt 免费证书为 90 天,原文“默认一年证书”的说法已过时;EV 证书也不再在主流浏览器地址栏绿色显示公司名,只在证书详情中体现组织信息。排查现有证书可执行:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates -subject -issuer
若输出 enddate 已过或 issuer 异常,应先续费或替换证书。ECS 还要确认安全组 443 端口对公网开放,80 端口用于 HTTP-01 验证和 301 跳转;若只用 DNS-01 验证,80 可按业务关闭。本文按“申请→验证→Nginx 部署→301→排错→验证→续费监控”给出可执行流程。
证书选型与申请前准备:DV、OV、EV 与单域名、SAN、通配符
常用证书按验证等级分为 DV、OV、EV。DV 只验证域名控制权,几分钟可签发,适合个人站点、小程序后端、iOS 下载页;OV 需 3-5 个工作日审核企业身份;EV 审核更严,但浏览器地址栏不再展示公司名,金融、电商应结合合规要求选择,不要为“绿色地址栏”购买 EV。按域名覆盖分为单域名、多域名 SAN、通配符:通配符 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com;多域名证书要把所有域名写入 SAN。
申请前准备:域名管理权限,能添加 TXT 或配置 HTTP 文件;服务器操作系统和 Web 版本;443 安全组规则;80 端口可用于 ACME。先检查环境:
nginx -v
openssl version
ss -lntp | grep ':443'
ufw allow 443/tcp
firewall-cmd --add-service=https --permanent && firewall-cmd --reload
云上还需在安全组放行 TCP 443,例如 AWS CLI:
aws ec2 authorize-security-group-ingress --group-id sg-xxxx --protocol tcp --port 443 --cidr 0.0.0.0/0
商业证书可先生成私钥和 CSR,CSR 的 CN 写主域名,SAN 写全部域名:
mkdir -p /etc/nginx/ssl
openssl req -new -newkey rsa:2048 -nodes -keyout /etc/nginx/ssl/example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
chmod 600 /etc/nginx/ssl/example.com.key
将 CSR 提交 CA,按提示添加 TXT 记录,例如 _dnsauth.example.com;下载证书时选择 Nginx 格式,得到 fullchain 与 key。若用 Let’s Encrypt,可跳过 CSR,直接进入下一节 acme.sh 流程。
完整实操步骤一:SSL 证书申请与域名验证命令
方案 A 是 Let’s Encrypt 加 acme.sh,有效期 90 天,适合自动续费。安装并签发:
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
mkdir -p /etc/nginx/ssl
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem --reloadcmd 'systemctl reload nginx'
使用 webroot 时,Nginx 必须能把 http://example.com/.well-known/acme-challenge/ 映射到 /var/www/html,且目录可读。若 80 端口不可用,改用 DNS-01:
~/.acme.sh/acme.sh --issue --dns -d example.com --yes-I-know-dns-manual-mode-enough-go-ahead-please
# 按提示添加 TXT 后执行续期
~/.acme.sh/acme.sh --renew -d example.com --yes-I-know-dns-manual-mode-enough-go-ahead-please
验证 TXT 是否生效:
dig TXT _acme-challenge.example.com +short
方案 B 是商业 DV/OV/EV:上一节生成 CSR 后提交 CA,完成 DNS TXT 或 HTTP 文件验证,下载 fullchain 与 key。无论哪种方案,部署前必须检查文件:
grep -c 'BEGIN CERTIFICATE' /etc/nginx/ssl/example.com.fullchain.pem
openssl x509 -noout -subject -issuer -dates -ext subjectAltName -in /etc/nginx/ssl/example.com.fullchain.pem
openssl rsa -check -noout -in /etc/nginx/ssl/example.com.key
fullchain 至少应包含站点证书和中间证书两个 BEGIN CERTIFICATE;只有一个通常说明缺中间证书。key 权限设为 600,属主为 root。商业证书续费时不能简单改日期,必须重新签发并替换 fullchain 与 key,建议提前 30 天操作。
完整实操步骤二:Nginx 安装证书、HTTP 301 与 TLS 优化
先确保 HTTP 站点保留 ACME 验证目录并做 301,HTTPS 站点加载 fullchain 和 key。修改 /etc/nginx/conf.d/example.com.conf:
server {
listen 80;
server_name example.com www.example.com;
location /.well-known/acme-challenge/ { root /var/www/html; }
location / { 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-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384';
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
root /var/www/html;
index index.html;
}
Nginx 1.25.1 及以上推荐 listen 443 ssl; 再写 http2 on; 旧版本可用 listen 443 ssl http2; 混用可能报 unknown directive。HSTS 要确认全站及子域都已 HTTPS 后再开 includeSubDomains,否则回滚困难。执行:
nginx -t && systemctl reload nginx
ss -lntp | grep ':443'
curl -I http://example.com
curl -I https://example.com
第一条应返回 301 且 Location 指向 https,第二条应返回 200。若使用 CDN 或负载均衡,回源协议要设 Full/Strict,否则 Cloudflare Flexible 模式会造成 301 循环。源站只监听内网时,安全组可只放行负载均衡地址,不要直接暴露 443。
配置示例:Nginx、Apache、Tomcat、IIS 关键片段
Nginx 完整片段见上一节,核心是 ssl_certificate 指向 fullchain,ssl_certificate_key 指向私钥,TLS 只开 1.2/1.3。Apache 2.4.8 及以上用 SSLCertificateFile 指向 fullchain,不再单独配链文件:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
</VirtualHost>
Tomcat 建议用 PKCS12,先转换:
openssl pkcs12 -export -out /opt/tomcat/conf/example.com.p12 -inkey /etc/nginx/ssl/example.com.key -in /etc/nginx/ssl/example.com.fullchain.pem -name example.com
server.xml 中配置:
<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true' keystoreFile='/opt/tomcat/conf/example.com.p12' keystoreType='PKCS12' keystorePass='强密码' SSLProtocol='TLSv1.2,TLSv1.3'/>
IIS 在“服务器证书”中导入 PFX,站点绑定 https 443,多站点勾选 SNI;命令行可用 certutil -importPFX 导入。所有平台都要部署 fullchain,而不是仅站点证书。转换后检查 SAN:
- Wildcard 通配符 SSL 证书安装部署续费申请
- SSL证书申请 · SSL证书购买 · SSL证书安装配置
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
openssl x509 -noout -text -in /etc/nginx/ssl/example.com.fullchain.pem | grep -A1 'Subject Alternative Name'
若 SAN 缺少 www 或子域,浏览器会报证书名称不匹配。Tomcat 的 keystorePass 不要写默认 changeit,PFX 文件权限设为 600。
对比表格:证书类型、有效期与续费策略
| 类型 | 验证方式 | 签发时间 | 有效期规则 | 浏览器展示 | 适用场景 | 续费策略 |
|---|---|---|---|---|---|---|
| DV | DNS TXT、HTTP 文件、DNS API | 几分钟到数小时 | Let’s Encrypt 90 天;商业 DV 不超过 398 天 | 锁标识,不展示组织 | 个人站、小程序后端、iOS 下载 | 90 天自动续;商业提前 30 天 |
| OV | 域名控制权加企业资料审核 | 3-5 个工作日 | 不超过 398 天 | 锁标识,详情含组织 | 企业官网、门户 | 提前 30-45 天重新签发 |
| EV | 严格企业身份与法律资料 | 更长,通常 5-10 个工作日 | 不超过 398 天 | 主流浏览器不再绿色地址栏展示公司名 | 金融、电商合规场景 | 提前 45 天续签并更新合规材料 |
按域名覆盖对比:单域名只保护一个 FQDN;多域名 SAN 可把 example.com、www.example.com、api.example.com 写入同一张证书;通配符 *.example.com 只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。小程序合法域名通常需要主域名和 www 或 API 子域,建议用 SAN 一次覆盖。续费时注意:Let’s Encrypt 90 天证书可在到期前 30 天续期,acme.sh 默认自动 cron;商业证书最长 398 天,不是永久一年,必须在到期前替换文件并 reload。不要等到浏览器报 NET::ERR_CERT_DATE_INVALID 才处理。
常见错误排查:真实报错与修复命令
1)nginx: [emerg] PEM_read_bio_X509_AUX(‘/etc/nginx/ssl/example.com.crt’) failed (SSL: error:0480006C:PEM routines::no start line:Expecting: TRUSTED CERTIFICATE)。原因多为文件为空、路径错、把 CSR 或私钥当证书。执行 head -n 2 文件确认有 BEGIN CERTIFICATE,Nginx 改用 fullchain.pem。
2)nginx: [emerg] cannot load certificate key … PEM_read_bio_PrivateKey … bad password read。私钥被加密或权限不对。执行 openssl rsa -in key -out key.unencrypted 去掉密码,chmod 600,属主 root。
3)curl: (60) SSL certificate problem: unable to get local issuer certificate。缺中间证书,浏览器有时能补链,小程序和 curl 不会。必须部署 fullchain,包含站点证书和中间 CA。
4)SSL_ERROR_BAD_CERT_DOMAIN。访问域名不在 SAN 中,或通配符层级不匹配。用 openssl x509 -noout -ext subjectAltName -in fullchain.pem 核对,重新签发包含该域名的证书。
5)微信小程序 request:fail ssl hand shake error。检查 TLS 是否 1.2 以上、证书链是否完整、域名是否备案、是否使用自签名。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null 查看链。
6)443 连接超时。执行 ss -lntp | grep ‘:443’、ufw status、telnet example.com 443;云上检查安全组入方向 TCP 443。Nginx 未监听或安全组未放行都会超时。
7)ACME 验证 403/404。检查 http://example.com/.well-known/acme-challenge/test 是否能访问,webroot 是否指向 /var/www/html,Nginx location 是否被伪静态拦截;DNS-01 用 dig TXT _acme-challenge.example.com +short 确认生效。
8)301 循环。常见于 CDN Flexible SSL 或反代未传 X-Forwarded-Proto。源站只对 http 做跳转,CDN 回源改 Full (strict),Nginx 可用 map 判断 $http_x_forwarded_proto 再跳转。
效果验证与续费监控:命令、HSTS 与到期检查
部署后先验证证书链、SAN、有效期:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates -ext subjectAltName
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt /etc/nginx/ssl/example.com.fullchain.pem
curl -I http://example.com
curl -I https://example.com
curl -I https://example.com | grep -i strict-transport-security
预期:verify 返回 OK;http 返回 301 且 Location 为 https;https 返回 200;响应头含 Strict-Transport-Security。再验证旧 TLS 已禁用:
openssl s_client -connect example.com:443 -tls1
openssl s_client -connect example.com:443 -tls1_1
两条应握手失败。若成功,说明 ssl_protocols 仍包含旧协议。证书到期检查:
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/example.com.fullchain.pem || echo '证书将在30天内过期'
openssl x509 -enddate -noout -in /etc/nginx/ssl/example.com.fullchain.pem
Let’s Encrypt 用户确认自动续期:acme.sh 安装后会写入 cron,执行 acme.sh –cron 测试,systemctl status cron 查看任务;certbot 用户用 systemctl list-timers | grep certbot。商业证书 398 天也要建立日历和监控,续费后替换 fullchain/key 并 nginx -t && systemctl reload nginx。最后用 SSL Labs 或浏览器开发者工具 Security 面板确认链完整、无混合内容;页面中 http:// 图片、脚本会破坏锁标识,需改为 https:// 或协议相对。
常见问题
Let’s Encrypt 证书只有 90 天,是否不稳定?
90 天是正常策略,配合 acme.sh 或 certbot 自动续期即可。关键是保留 80 端口 HTTP-01 或配置 DNS API,并监控 –cron 是否执行。商业证书最长 398 天,也不是永久。
通配符证书能覆盖二级子域吗?
*.example.com 只覆盖 a.example.com 这类一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com。需要把主域名写入 SAN,或为更深层级单独签发。
为什么浏览器正常,小程序仍报 SSL 握手失败?
小程序对证书链和 TLS 版本更严格。检查是否部署 fullchain、是否 TLS 1.2 以上、域名是否备案、是否使用自签名或 IP。用 openssl s_client -showcerts 查看链是否完整。
Nginx 配置后 443 超时怎么办?
先 ss -lntp | grep ‘:443’ 确认监听,再查 ufw、firewalld 和云安全组入方向 TCP 443。若使用负载均衡,还要检查后端端口和健康检查。
证书续费后需要重启 Nginx 吗?
替换证书文件后执行 nginx -t 检查语法,再 systemctl reload nginx 平滑加载。只改文件不 reload,进程仍可能使用旧证书。