跳到主要内容
ssl证书按装

SSL 证书申请、部署与 HTTPS 排障实战:从 DV 选型到 Nginx 配置

SSL 证书申请、部署与 HTTPS 排障实战:从 DV 选型到 Nginx 配置 — SSL 证书申请、部署与 HTTPS 排障实战:从 DV 选型到 Nginx 配置

问题背景与根因:HTTPS 不是“装个证书”就结束

很多站点在启用 HTTPS 后出现“浏览器能打开、微信小程序请求失败”“安卓正常、iOS 报错”“curl 报 certificate verify failed”。根因通常不是证书没买,而是证书链、域名匹配、443 端口与 TLS 配置不一致。微信小程序要求 request 合法域名使用 HTTPS,且证书必须被系统信任;iOS ATS 同样校验证书链。按 CA/Browser Forum 现行规则,公开信任 TLS 证书单张有效期上限为 398 天,Let’s Encrypt 默认有效期为 90 天,因此“一年一装、装完不管”必然导致过期事故。

常见根因包括:1) 只部署叶子证书,未带中间证书,形成 incomplete chain,典型报错为 curl: (60) SSL certificate problem: unable to get local issuer certificate;2) 私钥与证书不匹配,Nginx 报 SSL_CTX_use_PrivateKey_file() failed;3) ECS 安全组或系统防火墙未放行 443;4) 只监听 80,缺少 301 跳转;5) 页面内仍引用 http:// 资源,触发 mixed content;6) 多域名场景未使用 SAN 或通配符,证书与域名不匹配。下面按申请、部署、验证、排障给出可执行流程。

证书类型与选型:DV、OV、EV 与单域名、多域名、通配符

按验证等级,常用证书分为 DV、OV、EV。DV 只验证域名控制权,通常几分钟签发,适合个人站、API、小程序后端和大多数企业官网;OV 需要验证企业身份,通常 3-5 个工作日,适合企业门户、B2B 平台;EV 审核更严,但现代 Chrome、Edge、Firefox 已取消地址栏绿色公司名展示,组织信息只在证书详情中可见,不要为了“地址栏显示公司名”购买 EV。按覆盖范围,单域名证书只保护一个 FQDN;多域名证书通过 SAN 扩展保护多个域名;通配符证书 *.example.com 只覆盖一级子域,不覆盖 a.b.example.com。

类型 验证内容 典型签发时长 适用场景 注意点
DV 域名控制权 分钟级 个人站、API、小程序后端 需完整证书链与自动续期
OV 域名+组织 3-5 个工作日 企业门户、B2B 需营业执照等材料
EV 严格组织审核 5-10 个工作日 金融、电商 现代浏览器不再显示绿色公司名
通配符 域名控制权 分钟到天 多子域 只覆盖一级子域
多域名 SAN 域名控制权/组织 分钟到天 多主域、多品牌 注意 SAN 数量上限

选型建议:个人博客、下载站、内部测试用 DV 或 Let’s Encrypt;小程序、公众号、企业官网优先 DV 即可满足大部分需求;涉及企业资质展示、招投标可考虑 OV;金融、电商若合规要求明确再上 EV。不要盲目追求高等级,证书链完整、私钥安全、续期可靠比等级更重要。

申请前准备:域名、TXT 验证、CSR 与 443 端口

申请前先确认三件事:域名管理权限、验证方式、服务器环境。DV 常用 DNS-01 或 HTTP-01 验证。DNS-01 需要在域名解析中添加 TXT 记录,例如 _acme-challenge.example.com;HTTP-01 需要外网可访问 http://example.com/.well-known/acme-challenge/。购买商业证书时,CA 会要求提交 CSR,CSR 包含公钥和域名信息,私钥必须留在本地,绝不能上传。生成私钥与 CSR 的命令如下:

openssl genrsa -out example.com.key 2048
openssl req -new -key example.com.key -out example.com.csr -subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'

检查 DNS TXT 是否生效:dig +short TXT _acme-challenge.example.com 或 nslookup -type=TXT _acme-challenge.example.com。ECS 场景还要在安全组放行 443,系统防火墙同步放行:firewall-cmd --add-service=https --permanent && firewall-cmd --reload,Ubuntu 可用 ufw allow 443/tcp。最后确认 Web 服务版本,Nginx 用 nginx -v,Apache 用 httpd -v 或 apache2 -v,Tomcat 查看 catalina.sh version,不同版本配置参数不同。

完整实操:acme.sh 申请 Let’s Encrypt 证书并自动续期

以 Nginx 站点 example.com 和 www.example.com 为例,使用 acme.sh 通过 webroot 申请 Let’s Encrypt 证书。先安装并初始化:

curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
mkdir -p /var/www/html /etc/nginx/ssl
acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html

签发成功后安装证书,必须使用 --fullchain-file 输出叶子证书+中间证书,否则容易出现链不完整:

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 'nginx -s reload'

通配符证书需要 DNS API,例如阿里云 DNS:acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'。Let’s Encrypt 有效期 90 天,acme.sh 默认在到期前约 30 天自动续期,可用 crontab -l | grep acme 检查定时任务,用 acme.sh --list 查看到期时间。手动测试续期:acme.sh --renew -d example.com --force。注意 80 端口被关闭、TXT 记录未更新、CA 频率限制都会导致续期失败,建议配置到期前 30/14/7 天告警。

配置示例:Nginx、Apache、Tomcat 的 HTTPS 关键参数

Nginx 推荐将 80 端口 301 到 HTTPS,并只启用 TLS 1.2/1.3。Nginx 1.25.1 及以上使用 http2 on;,旧版本可用 listen 443 ssl http2;。示例:

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 HIGH:!aNULL:!MD5;
    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
    }
}

Apache 2.4.8 及以上使用 SSLCertificateFile 指向 fullchain 即可,不再单独配置 SSLCertificateChainFile:

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    Protocols h2 http/1.1
</VirtualHost>

Tomcat 需要将 PEM 转为 PKCS12/JKS:openssl pkcs12 -export -in fullchain.pem -inkey example.com.key -out example.p12 -name tomcat,再用 keytool -importkeystore -srckeystore example.p12 -srcstoretype PKCS12 -destkeystore example.jks -deststoretype JKS。IIS 场景将 fullchain 与私钥导出为 PFX,在站点绑定中新增 https/443 绑定并选择该证书。修改后执行 nginx -t && systemctl reload nginx 或 apachectl configtest,不要直接重启生产服务。

有效期、续期与证书链管理:398 天与 90 天怎么排班

公开信任 TLS 证书单张有效期上限为 398 天,Let’s Encrypt 默认 90 天,商业 CA 也普遍按 398 天上限签发。不要把“有效期一年”理解为自然年,更不要等到过期当天才处理。建议在到期前 30 天完成续期,至少保留 14 天回滚窗口。查看线上证书有效期与签发者:

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

第二条命令用于检查证书链,输出中应能看到叶子证书和至少一张中间证书;如果只有一张,说明链不完整。acme.sh 可用 acme.sh --list 查看所有证书到期时间,商业证书建议在监控系统添加 30/14/7 天三级告警。续期失败常见原因:DNS API 密钥过期、TXT 记录未刷新、80 端口被安全组关闭、CA 频率限制、私钥文件权限错误。私钥目录建议 chmod 700 /etc/nginx/ssl && chmod 600 /etc/nginx/ssl/*.key,并避免把私钥提交到 Git。若更换 CA 或重签证书,保持域名 SAN 列表一致,部署后立即做链验证和 301 验证。

常见错误排查:从真实报错到修复命令

排障先看三样:证书链、私钥匹配、端口监听。以下为常见真实报错与处理方式。

  • curl: (60) SSL certificate problem: unable to get local issuer certificate:多为未部署中间证书。用 openssl s_client -showcerts -connect example.com:443 -servername example.com </dev/null 检查,Nginx 的 ssl_certificate 改为 fullchain 文件。
  • nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不匹配。分别计算模数:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in example.com.key | openssl md5,两者必须一致。
  • ERR_SSL_VERSION_OR_CIPHER_MISMATCH:协议或加密套件不兼容。确认 ssl_protocols TLSv1.2 TLSv1.3;,不要只开 TLSv1.0/1.1。
  • curl: (7) Failed to connect to example.com port 443: Connection timed out:安全组、防火墙或监听问题。执行 ss -lntp | grep :443,再检查 ECS 安全组与 firewall-cmd --list-all。
  • Mixed Content: The page at https://... was loaded over HTTPS, but requested an insecure resource http://...:页面内仍有 HTTP 资源,改为 HTTPS 或协议相对地址,并检查 CDN 回源协议。
  • NET::ERR_CERT_COMMON_NAME_INVALID:域名不匹配。用 openssl x509 -in fullchain.pem -noout -ext subjectAltName 核对 SAN,通配符只覆盖一级子域。
  • x509: certificate has expired or is not yet valid:证书过期或服务器时间错误。用 date -u 与 timedatectl 校准 NTP。

效果验证:命令行、浏览器与小程序三端验收

部署后不要只看浏览器锁标,按以下顺序验收。第一步,检查监听与配置语法:ss -lntp | grep :443、nginx -t。第二步,检查 301 跳转:curl -I http://example.com,响应应为 301 Moved Permanently,且 Location: https://example.com/。第三步,检查 TLS 握手与证书链:curl -vI https://example.com 2>&1 | grep -E 'SSL|TLS|subject|issuer',以及 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null。第四步,检查证书 SAN 与有效期:openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -dates -subject -issuer -ext subjectAltName。

浏览器侧确认地址栏为 HTTPS、无 mixed content 警告,可用 SSL Labs 或 testssl.sh example.com 做等级评估,目标至少 A。微信小程序侧,在公众平台配置 request 合法域名,必须使用 HTTPS 域名,不能使用自签证书、IP 地址或未备案域名;配置后重新编译并清除缓存。若小程序仍报错,用开发者工具查看 network 面板的完整错误,再回到 openssl s_client 检查链。最后做一次过期演练:把监控告警阈值设为 30 天,确认续期任务、reload 命令和回滚包都可用,才算完成 HTTPS 交付。

常见问题

免费 Let’s Encrypt 证书能用于微信小程序吗?

可以。微信小程序要求 request 合法域名使用 HTTPS,证书需被系统信任;Let’s Encrypt 是公开信任 CA,只要域名匹配、证书链完整、未使用自签证书即可。但 Let’s Encrypt 有效期 90 天,必须配置自动续期和 reload,否则过期后小程序请求会失败。

证书最长有效期到底是 398 天还是一年?

公开信任 TLS 证书单张有效期上限为 398 天,不是自然年;Let’s Encrypt 默认 90 天。商业 CA 可能按 398 天上限签发,也可能提供更短周期。续期时应重新签发并部署 fullchain,不要只替换叶子证书而遗漏中间证书。

通配符证书能覆盖二级、三级域名吗?

不能。 *.example.com 只覆盖 a.example.com 这类一级子域,不覆盖 a.b.example.com。多级子域需要单独写入 SAN,例如 *.b.example.com,或为具体域名申请单域名/多域名证书。

为什么浏览器正常,小程序或 Android 却报证书错误?

常见原因是中间证书缺失、TLS 版本过低、SNI 未正确返回证书,或客户端根证书库差异。用 openssl s_client -showcerts -connect example.com:443 -servername example.com </dev/null 检查链,Nginx 的 ssl_certificate 必须指向 fullchain,而不是仅叶子证书。

443 端口已放行还是打不开,怎么查?

依次检查 ECS 安全组、系统防火墙、Web 服务监听和 SELinux。命令:ss -lntp | grep :443、firewall-cmd --list-all、ufw status、getenforce。若本机监听正常但外网超时,优先看安全组入方向规则和运营商/云防火墙。

EV 证书会在浏览器地址栏显示公司名吗?

不会。现代 Chrome、Edge、Firefox 已取消 EV 证书的绿色地址栏公司名展示,组织信息只在证书详情中可见。EV 的价值主要在审核严格和合规场景,不应以地址栏展示作为购买理由。

内容审核

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