跳到主要内容
HTTPS小程序证书

SSL 证书申请与 HTTPS 证书配置全流程指南:Nginx/Apache/IIS/Tomcat 安装排错

SSL 证书申请与 HTTPS 证书配置全流程指南:Nginx/Apache/IIS/Tomcat 安装排错 — SSL 证书申请与 HTTPS 证书配置全流程指南:Nginx/Apache/IIS/Tomcat 安装排错

问题背景与根因:为什么必须配置 SSL/TLS 证书

HTTP 明文传输会被运营商、代理和公共 Wi-Fi 劫持,浏览器会标记“不安全”,小程序、支付回调、API 网关也普遍强制 HTTPS。SSL 证书配置的本质是完成三件事:身份匹配(域名与 SAN)、信任链完整(叶证书+中间证书)、私钥匹配与协议安全。常见根因往往不是“证书买错了”,而是只配置了叶证书、未配置 fullchain、SNI 未命中、443/TCP 未放行、系统时间偏差、证书与私钥不匹配。公共可信 TLS 证书有效期受 CA/Browser Forum 与 Apple 策略约束:传统单张证书最长 398 天,2026 年起分阶段缩短至 200 天、100 天、47 天,Let’s Encrypt 默认 90 天。因此“一年一续”的手工模式已过时,必须用 certbot 或 acme.sh 自动化续期,并在续期后 reload 服务。证书按验证级别分为 DV、OV、EV,按覆盖范围分为单域名、多域名 SAN、通配符。排查顺序建议:先用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看证书链,再用 curl -Iv https://example.com 看握手,最后查 Nginx/Apache/Tomcat 日志。

SSL 证书申请与域名验证实操步骤

申请前准备:目标域名、DNS 管理权限、服务器操作系统与 Web 服务版本。先生成私钥和 CSR,SAN 必须包含所有实际访问域名:

openssl genrsa -out example.com.key 2048
openssl req -new -key 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'

通配符证书写 DNS:*.example.com,并单独加入 DNS:example.com,否则主域不生效。CA 常见验证方式为 DNS TXT、HTTP 文件、邮箱。DNS 验证可执行:

dig +short TXT _acme-challenge.example.com
curl -I http://example.com/.well-known/pki-validation/fileauth.txt

Let’s Encrypt 推荐 webroot 方式,证书通常落在 /etc/letsencrypt/live/example.com/:

sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
sudo certbot certificates

签发后重点文件:fullchain.pem 为叶证书+中间证书,privkey.pem 为私钥,chain.pem 为中间证书。私钥权限设为 chmod 600,不要放在 Web 根目录。DV 通常分钟级签发;OV 需营业执照、组织信息审核,约 3-5 个工作日;EV 审核更严,约 5-10 个工作日。若使用 CDN,应先在源站配好证书并验证回源 HTTPS,再开启 CDN 严格 SSL,避免出现 526。

Nginx HTTPS 证书安装配置示例

把 fullchain 与 key 放到 /etc/nginx/ssl/,配置 80 跳转和 443。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 '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;
    ssl_trusted_certificate /etc/nginx/ssl/chain.pem;
    add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
    root /var/www/html;
    index index.html;
}

执行 nginx -t 后 systemctl reload nginx。HSTS 仅在全部子域已启用 HTTPS 时加 includeSubDomains,否则会锁死 HTTP 子域。OCSP stapling 需要 chain.pem 为中间证书,且服务器可访问 CA 的 OCSP 地址。多域名场景 server_name 要与 SAN 一致;泛域名 *.example.com 不覆盖 example.com 本身,需在 SAN 中额外加入。配置后执行 nginx -T | grep ssl_certificate,确认加载的是 fullchain 而非单叶证书。

Apache、IIS 与 Tomcat 证书安装配置要点

Apache 启用 mod_ssl,在 VirtualHost 中指向 fullchain 与 key:

<VirtualHost *:443>
    SSLEngine on
    SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite HIGH:!aNULL:!MD5
</VirtualHost>

执行 apachectl configtest,再 systemctl reload httpd 或 systemctl reload apache2。IIS 把 PFX 导入“个人/证书”,把中间 CA 放入“中间证书颁发机构”,站点绑定 443 并勾选 SNI;可用 certutil -store My 核对指纹。Tomcat 9+ 可直接使用 PEM:

<Connector port='8443' protocol='org.apache.coyote.http11.Http11NioProtocol' SSLEnabled='true' scheme='https' secure='true'>
  <SSLHostConfig>
    <Certificate certificateFile='/opt/tomcat/conf/example.com.fullchain.pem'
                 certificateKeyFile='/opt/tomcat/conf/example.com.key'
                 type='RSA' />
  </SSLHostConfig>
</Connector>

若只有 PFX,先执行 openssl pkcs12 -in example.pfx -nodes -out example.pem 再拆分证书与私钥,但 certificateFile 仍建议使用 fullchain。IIS 绑定后浏览器仍报链错误,优先检查中间证书是否安装到“中间证书颁发机构”,而不是只导入 PFX。所有平台都要放行 443/TCP,并确保 NTP 时间同步,否则会出现“证书尚未生效/已过期”。

证书类型与选型对比表

选型先看验证级别,再看域名覆盖。DV 只验证域名控制权,适合个人站、API、测试;OV 验证组织身份,适合企业官网;EV 验证更严格,但现代浏览器已弱化地址栏企业名展示,不能把它当成“地址栏显示公司名”的万能方案。对比如下。

维度 DV OV EV
验证内容 DNS TXT、HTTP 文件或邮箱 组织营业执照、电话、地址 组织、法律、运营地址等扩展审核
签发时间 分钟至数小时 3-5 个工作日 5-10 个工作日
有效期 受 CA/B 限制,常见 90-398 天,2026 起分阶段缩短 同上 同上
浏览器表现 锁标 锁标,证书详情含组织 锁标,证书详情含组织;地址栏企业名展示已弱化
适用场景 博客、API、内部测试、小程序 企业官网、SaaS 金融、电商、高信任门户

按覆盖范围:单域名证书只保护一个 FQDN;多域名 SAN 可在一张证书中放多个域名;通配符 *.example.com 只覆盖一级子域,不覆盖 example.com 和 a.b.example.com,通常需把主域加入 SAN。子域数量多且层级固定时通配符更易管理;域名分散时多域名证书更合适。Let’s Encrypt 免费证书为 DV、90 天有效期,适合自动化;OV/EV 需商业 CA。公共可信 TLS 证书不存在“永久有效”,不要购买所谓永久证书。

常见错误排查与真实报错

先收集三组信息:浏览器报错、curl -Iv https://example.com、openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null。常见报错与处理如下:

  • NET::ERR_CERT_AUTHORITY_INVALID:证书自签或中间链缺失。用 fullchain 配置,并检查 ssl_certificate 是否只写了叶证书。
  • NET::ERR_CERT_COMMON_NAME_INVALID 或 SSL_ERROR_BAD_CERT_DOMAIN:SAN 未包含当前域名。重新签发,把 example.com、www.example.com 都写入 SAN。
  • curl: (60) SSL certificate problem: unable to get local issuer certificate:服务端未发送中间证书。执行 cat example.com.crt intermediate.crt > fullchain.pem 后 reload。
  • SSL_CTX_use_PrivateKey() failed ... key values mismatch:证书与私钥不匹配。比对模数:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5。
  • PEM_read_bio_X509_AUX ... no start line:文件格式错误或把 PFX 当 PEM。用 openssl x509 -in cert.pem -noout -subject 验证。
  • AH01909: RSA certificate ... does not include an ID which matches the server name:Apache vhost/SNI 不匹配,检查 ServerName 与证书 SAN。
  • Cloudflare 526:源站证书无效或链不完整,先在源站用 curl --resolve 验证,再开严格 SSL。

若握手失败但证书正常,检查 TLS 版本与 cipher:openssl s_client -connect example.com:443 -servername example.com -tls1_2,以及防火墙 443 是否放行。时间偏差超过证书有效期会直接报过期,用 timedatectl 检查 NTP。

效果验证与自动续期

配置完成后做四层验证:1)证书链:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null | openssl x509 -noout -dates -subject -issuer -ext subjectAltName;2)HTTP 跳转:curl -I http://example.com 应返回 301/308 到 https;3)HTTPS 状态:curl -I https://example.com 返回 200;4)协议与套件:nmap --script ssl-enum-ciphers -p443 example.com,确认只开 TLSv1.2/1.3。再用 openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem cert.pem 验证链。Let’s Encrypt 自动续期:

sudo certbot renew --dry-run
sudo certbot renew --quiet --deploy-hook 'systemctl reload nginx'

写入 cron:0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook 'systemctl reload nginx',或使用 systemctl list-timers | grep certbot 检查 systemd timer。商业证书到期前 30 天续签,续签后替换 fullchain 与 key 并 reload,不要直接覆盖正在使用的文件导致半更新。监控命令:openssl x509 -in fullchain.pem -noout -checkend 2592000,返回非 0 表示 30 天内到期。最后用 SSL Labs 或 testssl.sh 复查,目标为 A/A+,但不要为了评分关闭 TLSv1.2 兼容或滥用 HSTS。

常见问题

SSL 证书最长有效期到底是 398 天还是 90 天?

公共可信 TLS 证书受 CA/Browser Forum 与 Apple 等策略约束,传统上限为 398 天;2026 年起分阶段缩短至 200 天、100 天、47 天。Let’s Encrypt 默认 90 天。具体以 CA 签发为准,生产环境应自动化续期。

DV、OV、EV 证书怎么选?

个人站、API、小程序后端优先 DV;企业官网需要展示组织信息可选 OV;金融、电商等高信任场景可选 EV,但现代浏览器已弱化地址栏企业名展示,不要把它当唯一卖点。

通配符证书能覆盖多级子域吗?

不能。*.example.com 只覆盖 www.example.com 这一级,不覆盖 example.com 和 a.b.example.com。主域需额外加入 SAN;多级子域需分别签发或使用多域名证书。

为什么浏览器提示证书无效,但 curl 能访问?

常见原因是客户端信任库不同、SNI 未命中、系统时间偏差或链不完整。用 openssl s_client -servername 指定 SNI 检查,并确认服务端发送 fullchain。

更换证书后需要重启服务吗?

Nginx 用 systemctl reload nginx,Apache 用 apachectl graceful,IIS 重新绑定或重启站点,Tomcat 通常需重启 Connector。reload 前先执行 nginx -t 或 configtest。

Let’s Encrypt 90 天太短,能改成一年吗?

不能。90 天是 Let’s Encrypt 的固定策略,应使用 certbot/acme.sh 自动续期并配置 deploy-hook 重载服务,而不是手工换证。

内容审核

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