SSL证书配置与全站HTTPS加密实操指南:Nginx/Apache/Tomcat/IIS
问题背景与根因:全站 HTTPS 不只是安装一张证书
网站从 HTTP 迁移到 HTTPS,本质是让客户端通过 TLS 校验服务器身份并协商会话密钥。旧文章只强调配置安装 SSL 证书,但实际故障通常来自五个根因:私钥与证书不匹配、证书链不完整、域名未写入 SAN、服务器仍开放 TLS 1.0/1.1、HTTP 资源造成混合内容。公开可信 CA 签发的 TLS 证书最长有效期按 CA/B Forum 规则为 398 天,Let’s Encrypt 免费证书为 90 天,因此必须把续期纳入运维。另一个根因是 SNI:同一台服务器绑定多个域名时,Nginx/Apache/IIS 依赖 SNI 选择证书,旧客户端或不支持 SNI 的客户端会拿到默认站点证书并报域名不匹配。全站 HTTPS 还要求 80 端口可跳转、443 安全组放行、页面内图片/JS/CSS 全部改为 https 或协议相对地址,否则浏览器地址栏仍显示不安全。证书安装成功不等于 HTTPS 合格,必须验证证书链、协议版本、HSTS、OCSP Stapling 与自动续期。常见误区是把 CSR 当证书、只部署 leaf 证书不部署中间证书、用通配符证书保护裸域,结果在 Android、Java、curl 等客户端出现 trust anchor 或 hostname 错误。下面按申请、配置、加固、排查、验证的顺序给出可直接执行的命令。
证书类型与选型:单域名、通配符、多域名及 DV/OV/EV
SSL证书购买前先确定保护范围。单域名证书只保护一个 FQDN,例如 shop.example.com;example.com 与 www.example.com 是两个不同域名,默认不能互相覆盖,需要在申请时把两者都加入 SAN,或购买多域名证书。通配符证书申请时域名填 *.example.com,可保护 www.example.com、api.example.com 等同一级子域名,但不保护裸域 example.com,也不保护 a.b.example.com;裸域需额外加入 SAN,多级子域需 *.b.example.com 或单独证书。多域名/SAN 证书可在一张证书里放多个 FQDN,适合主站、www、API、管理后台混合场景。DV 只验证域名控制权,签发快;OV/EV 增加组织验证,适合有合规或品牌展示需求的单位,但浏览器对 EV 的 UI 差异已弱化,应按实际合规要求选择。免费 DV 证书方面,Let’s Encrypt 有效期为 90 天,阿里云免费 DV 证书有效期以控制台为准,常见为 3 个月,均需自动续期。下表用于快速选型:
| 证书类型 | 保护范围 | 典型场景 | 注意点 |
|---|---|---|---|
| 单域名 | 一个 FQDN | 单站个人站 | 裸域与 www 需两个 SAN |
| 通配符 | *.example.com 一级子域 | 多子域业务 | 不保护 example.com 本身 |
| 多域名/SAN | 多个指定 FQDN | 主站+API+后台 | 可混合裸域和 www |
| DV/OV/EV | 验证级别不同 | 个人/企业/合规 | 按合规需求选,不盲目追 EV |
选型时还要确认私钥算法:RSA 2048/3072 兼容性最好,ECDSA P-256 性能更好但需确认旧客户端兼容性。证书链必须包含服务器证书和中间证书,根证书不要放入服务器链文件。购买或申请后应核对证书的 SAN、有效期、签发者与密钥用法,避免上线后才发现域名漏配。
申请与签发:CSR、HTTP-01/DNS-01 与 certbot 命令
SSL证书申请的核心是生成私钥和 CSR,再由 CA 签发证书。私钥必须保存在服务器安全目录,权限建议 600。生成 RSA 私钥与 CSR 的可执行命令如下:
openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com/O=Example/C=CN'
如果使用 Let’s Encrypt,可直接用 certbot 完成申请和 Nginx 自动配置。Ubuntu/Debian 可执行:
sudo apt update
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com --agree-tos -m admin@example.com --redirect
sudo certbot renew --dry-run
通配符证书必须使用 DNS-01 验证,因为 CA 要验证 *.example.com 的控制权。可执行:
sudo certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com'
按提示在 DNS 添加 _acme-challenge.example.com 的 TXT 记录,等待生效后继续。HTTP-01 验证要求 80 端口可达,且 /.well-known/acme-challenge/ 路径不能被重写或鉴权拦截。阿里云免费 DV 证书可在控制台申请,签发后下载 Nginx/Apache/Tomcat/IIS 对应格式;注意免费证书有效期通常为 3 个月,Let’s Encrypt 为 90 天,均远短于付费证书的 398 天上限,必须配置自动续期。签发完成后用 openssl x509 -in fullchain.pem -noout -subject -dates 核对域名和到期时间,并确认 fullchain.pem 中包含中间证书。
Nginx SSL 证书配置完整步骤与示例
Nginx 是最常见的 SSL证书安装环境。将证书文件放到 /etc/nginx/ssl/ 或使用 certbot 生成的 /etc/letsencrypt/live/example.com/ 路径。关键参数是 ssl_certificate 指向 fullchain.pem,ssl_certificate_key 指向 privkey.pem;只写 leaf 证书会导致部分客户端链不完整。以下配置同时处理 80 跳转、ACME 验证目录和 443 站点:
server {
listen 80;
server_name example.com www.example.com;
location ^~ /.well-known/acme-challenge/ { root /var/www/html; }
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
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;
add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains' always;
location / { root /var/www/html; index index.html; }
}
保存后执行 sudo nginx -t 检查语法,再 sudo systemctl reload nginx 平滑加载。用 sudo ss -lntp | grep ‘:443’ 确认监听,用 curl -I http://example.com 确认返回 301,用 curl -I https://example.com 确认 200。若使用 certbot –nginx,它会自动写入证书路径和跳转,但仍需人工检查 ssl_protocols、HSTS 和证书链。多域名站点要确保每个 server_name 都有对应证书或使用包含全部 SAN 的证书,否则 SNI 不匹配会报 ERR_CERT_COMMON_NAME_INVALID。Nginx 旧版本不支持 listen 443 ssl http2 写法时,可改为 listen 443 ssl 并单独开启 http2。
Apache、Tomcat、IIS 配置示例与关键差异
Apache 需要启用 ssl、headers、rewrite 模块,并在 VirtualHost 中指定 fullchain.pem 与私钥。旧版 Apache 若 fullchain 不含中间证书,还需 SSLCertificateChainFile 指向 chain.pem。示例:
sudo a2enmod ssl headers rewrite
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
# 检查并重载
sudo apachectl configtest
sudo systemctl reload apache2
Tomcat 使用 JKS/PKCS12,需要把 fullchain.pem 和 privkey.pem 合成 PKCS12:
- HTTPS证书申请 · SSL证书安装部署 · 证书续费
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -out example.com.p12 -name tomcat -CAfile chain.pem -caname root -password pass:ChangeIt
在 server.xml 的 Service 内配置 443 Connector,certificateKeystoreFile 指向 p12,certificateKeystorePassword 填 ChangeIt,certificateKeystoreType 填 PKCS12。IIS 则通过 certlm.msc 将 PFX 导入本地计算机的个人存储,把中间证书导入中间证书颁发机构存储,在站点绑定中新增 https/443 并勾选 SNI。三者差异如下表:
| 环境 | 证书格式 | 关键配置 | 常见坑 |
|---|---|---|---|
| Nginx | PEM fullchain+key | ssl_certificate/ssl_certificate_key | 只配 leaf 导致链不完整 |
| Apache | PEM fullchain+key | SSLCertificateFile/KeyFile | 旧版缺 ChainFile |
| Tomcat | PKCS12/JKS | Connector+SSLHostConfig | 密码错或别名错 |
| IIS | PFX | 443 绑定+SNI | 中间证书未导入 |
HTTP 跳转 HTTPS、HSTS、OCSP Stapling 与 TLS 加固
全站HTTPS加密不仅是 443 可访问,还要让 HTTP 自动 301 到 HTTPS,并对敏感站点启用 HSTS。HSTS 头建议先用较短 max-age 观察,例如 max-age=300,确认全站资源无混合内容后再提升到 31536000。Nginx 可加 add_header Strict-Transport-Security ‘max-age=31536000; includeSubDomains’ always;Apache 用 Header always set。注意 includeSubDomains 会影响所有子域,若子域尚未 HTTPS 不要加。OCSP Stapling 可减少客户端回源验证,Nginx 需配置 ssl_stapling on、ssl_stapling_verify on、ssl_trusted_certificate 指向 chain.pem,并确保 resolver 可用;否则日志会出现 ssl_stapling_init_cert 相关错误。TLS 协议应禁用 TLS 1.0/1.1,只保留 TLS 1.2/1.3;密码套件优先 ECDHE+AEAD。验证命令:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
nmap --script ssl-enum-ciphers -p 443 example.com
若 nmap 仍显示 TLSv1.0,检查是否还有旧 server 块或默认配置未覆盖。HSTS 一旦下发,浏览器会在 max-age 内强制 HTTPS,回退困难,因此上线前必须确认所有子域和接口均支持 HTTPS。混合内容排查可在浏览器 DevTools Console 查看 Mixed Content 报错,或使用 curl -I 检查页面资源。OCSP Stapling 失败不会阻断访问,但会降低性能,应结合日志修复。
常见错误排查:真实报错与修复命令
第一类报错是 nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed (SSL: error:0A00009C:SSL routines::no start line)。根因是路径错误或文件不是 PEM 证书,可能误把 CSR、私钥当证书。用 openssl x509 -in fullchain.pem -noout -subject -dates 验证,输出 subject 才说明是证书。第二类是 nginx: [emerg] SSL_CTX_use_PrivateKey(…) failed (SSL: error:0A00018A:SSL routines::key values mismatch),即证书与私钥不匹配。分别执行 openssl x509 -noout -modulus -in cert.pem | openssl md5 和 openssl rsa -noout -modulus -in privkey.pem | openssl md5,两个 md5 必须一致。第三类是 curl: (60) SSL certificate problem: unable to get local issuer certificate,通常是缺中间证书,改用 fullchain.pem,并用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 检查链。第四类浏览器报 ERR_CERT_COMMON_NAME_INVALID 或 ERR_CERT_AUTHORITY_INVALID,检查 SAN 是否包含当前域名、证书是否自签或 CA 不受信。第五类 Let’s Encrypt HTTP-01 返回 403/404,检查 80 端口安全组、location ^~ 优先级、目录权限 755,以及 CDN/WAF 是否拦截 .well-known。第六类 Apache 日志出现 AH02032 或证书链告警,确认 SSLCertificateFile 使用 fullchain,旧版补 SSLCertificateChainFile。Tomcat 报 Keystore was tampered with, or password was incorrect 时核对 p12 密码与 Connector 密码。IIS 在 Android 上报链错误时,把中间证书导入中间证书颁发机构存储后重新绑定。
效果验证与自动化续期监控
配置完成后至少做四层验证。第一层看证书主体、签发者、有效期:openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates。第二层看 HTTP 跳转:curl -I http://example.com 应返回 301 且 Location 为 https;curl -I https://example.com 应返回 200。第三层看协议与套件:nmap –script ssl-enum-ciphers -p 443 example.com,确认只出现 TLSv1.2/1.3,无 TLSv1.0/1.1。第四层看 HSTS 和链:curl -I https://example.com | grep -i strict-transport-security,以及 openssl s_client -showcerts 检查是否返回服务器证书和中间证书。续期方面,Let’s Encrypt 证书 90 天,certbot 通常由 systemd timer 自动续期,执行 systemctl list-timers | grep certbot 查看下一次执行,执行 sudo certbot renew –dry-run 做演练。监控可用 openssl x509 -in /etc/letsencrypt/live/example.com/fullchain.pem -noout -checkend 2592000,返回 0 表示 30 天内不过期,返回 1 应告警。生产环境建议在到期前 30 天、14 天、7 天分级告警,并记录证书 SAN、签发者、部署路径,避免多节点漏更新。
常见问题
默认不能。单域名证书只匹配一个 FQDN,example.com 与 www.example.com 是两个域名;应在申请时把两者都加入 SAN,或使用多域名证书。通配符 *.example.com 只覆盖 www.example.com,不覆盖裸域 example.com。
Let’s Encrypt 证书有效期为 90 天。使用 certbot 安装后通常由 systemd timer 自动续期,可用 systemctl list-timers | grep certbot 查看,并用 sudo certbot renew –dry-run 验证续期流程,生产环境应提前 30 天监控到期。
不能。*.example.com 只匹配同一级子域名,如 www.example.com、api.example.com,不匹配 a.b.example.com,也不匹配裸域 example.com。多级子域需申请 *.b.example.com 或把具体域名加入 SAN。
优先使用 fullchain.pem,它包含服务器证书和中间证书;Apache 旧版需配置 SSLCertificateChainFile 指向 chain.pem;IIS 需把中间证书导入中间证书颁发机构存储。不要放入根证书,并用 openssl s_client -showcerts 验证链。
依次检查 443 安全组和防火墙、Nginx/Apache 是否 listen 443 ssl、证书路径与权限、SELinux 上下文,以及 CDN/WAF 是否只回源 80。用 curl -v https://example.com 和 openssl s_client -connect example.com:443 定位握手失败点。
把续期自动化并加监控:certbot renew –dry-run 演练,systemctl list-timers 查看定时器,openssl x509 -checkend 2592000 检查 30 天阈值,到期前 30/14/7 天分级告警,多节点部署要同步更新证书文件并重载服务。