专业 HTTPS 配置与 SSL 证书部署实战:CSR 生成、Nginx/Apache/IIS/Tomcat 配置与全站强制跳转
一、问题背景与根因:证书买回来了,为什么浏览器还是提示不安全
把网站从 HTTP 迁移到 HTTPS,表面上是“装个证书”,实际交付时的失败率远高于预期。最常见的四类现场现象是:地址栏显示红色“不安全”,点开证书详情报 NET::ERR_CERT_AUTHORITY_INVALID;微信、Android 内置浏览器打不开,桌面 Chrome 却正常;首页 HTTPS 正常,进入内页后图片、CSS 全部加载失败,控制台刷出 Mixed Content;搜索引擎结果里仍是 http:// 版本,收录权重被拆分到两个域名。
逐一定位,根因基本落在下面五点:
- 证书链不完整。服务器只下发了站点证书(leaf),没有携带中间证书(intermediate)。桌面 Chrome 会尝试通过 AIA 扩展自动补链,所以“本机测试正常”;而 Android、微信、部分 Java 客户端不会补链,直接判定不受信任。这是 HTTPS 部署第一大坑。
- 域名不匹配。CSR 中的 CN 与用户实际访问的域名不一致,或只申请了
example.com未包含www.example.com。现代浏览器早已忽略 CN,只认 SAN(subjectAltName)扩展,证书里没写的域名一律报ERR_CERT_COMMON_NAME_INVALID。 - 配置未真正生效。改了 nginx.conf 但没有
nginx -t校验,reload 失败却无人发现;或云服务器安全组只放行了 80,443 被拦截,表现为“连接超时”而不是证书错误。 - 混合内容。HTML、CSS、JS 里硬编码了
http://资源地址,浏览器按“降级”处理,锁形图标上出现黄色警告。 - 跳转配置错误。用 301 跳转 POST 请求会导致请求体丢失,接口报 502 或参数为空,应改用 308 保留请求方法。
还有一条必须纠正的过时认知:“一次配置管三年”已经不存在。自 2020 年 9 月 1 日起,公有 CA 签发的 SSL/TLS 证书最长有效期被压缩至 398 天;Let’s Encrypt 免费证书固定 90 天,官方建议在剩余 30 天时续期。CA/Browser Forum 已通过 SC-081 提案,计划把上限逐步缩短到 200 天、100 天,最终 47 天。因此证书自动化续期与到期监控,必须和“装证书”一起交付,否则一年后站点必然再次“变不安全”。
二、部署前准备:私钥、CSR 与证书文件的规范生成
无论最终是 Nginx、Apache、IIS 还是 Tomcat,源头都是同一套材料:私钥 + CSR + 签发回来的证书链。这一步做错,后面全是无用功。
生成 RSA 2048 位私钥与 CSR(OpenSSL 1.1.1 及以上支持用 -addext 写入 SAN):
openssl req -new -newkey rsa:2048 -nodes
-keyout example.com.key -out example.com.csr
-subj "/C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com"
如果服务端支持 ECDSA(Nginx 1.11+、Apache 2.4.8+、主流 CDN 均支持),优先使用 P-256,握手更快、证书更小:
openssl ecparam -genkey -name prime256v1 -out example.com.key
注意:多数商业 CA 会忽略 CSR 中的 SAN,以订单里填写的域名为准;但自签或内部 CA 场景必须写全。CSR 提交前先自检:
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
openssl req -in example.com.csr -noout -verify
拿到证书后,第一件事是确认私钥与证书配对,不配对会在 reload 时报 key values mismatch:
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两个 md5 必须完全一致。接着拼接完整链(顺序:站点证书在前,中间证书在后,根证书不要放):
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -untrusted intermediate.crt example.com.crt
文件格式对照:.crt/.pem/.cer 是 Base64 的 PEM 文本;.key 是私钥;.csr 是请求文件,部署时用不到;.pfx/.p12 是带密码的二进制容器(IIS、Java 常用);.jks 是 Java 专用密钥库。IIS 与 Tomcat 需要转换:
openssl pkcs12 -export -out example.com.pfx
-inkey example.com.key -in fullchain.pem -passout pass:YourPass123
最后提醒:私钥权限设为 chmod 600、属主为运行用户,并且绝不要把 .key 文件放在 Web 根目录下。
三、Nginx 配置示例:443 监听、TLS 1.2/1.3 与 301 全站跳转
Nginx 是当前最主流的入口层,一份可直接执行的完整配置如下(文件路径按实际替换):
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+ 写法;旧版用 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/nginx/ssl/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; # 仅中间证书,供 OCSP 校验
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 $scheme;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
几个容易踩坑的参数说明:ssl_protocols 中删掉 TLSv1 与 TLSv1.1,它们已被所有主流浏览器弃用,保留只会拖低 SSL Labs 评级;ssl_prefer_server_ciphers off 是为了让客户端优先选择 ChaCha20,移动端表现更好;http2 on; 是 Nginx 1.25.1 之后的新语法,老版本继续写 listen 443 ssl http2;,混写会报 duplicate listen options。反向代理场景下,如果后端应用需要识别 HTTPS,必须传 X-Forwarded-Proto $scheme,否则 PHP 的 $_SERVER['HTTPS'] 为空,会导致无限重定向。
保存后务必先校验再重载:
nginx -t
systemctl reload nginx # 或 nginx -s reload
systemctl status nginx --no-pager
如果 nginx -t 通过但浏览器仍打不开,优先检查防火墙与安全组:firewall-cmd --add-service=https --permanent && firewall-cmd --reload,云主机还需在控制台放行 443 入方向。
四、Apache、IIS 与 Tomcat 配置示例
Apache(httpd 2.4):
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
注意:Apache 2.4.8 之后 SSLCertificateChainFile 已废弃,推荐直接把中间证书拼到 SSLCertificateFile 指向的文件末尾。校验命令为 httpd -t 或 apachectl configtest,重载用 systemctl reload httpd。
IIS(Windows Server 2012 R2 及以上):先在“中间证书颁发机构”存储中导入中间证书,再到“个人”存储导入 .pfx(勾选“允许导出私钥”),然后在站点绑定中添加 https、端口 443、选择证书。IIS 8 及以上默认未启用 TLS 1.2,需要改注册表:在 HKLMSYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocolsTLS 1.2Server 下新建 DWORD Enabled=1、DisabledByDefault=0,重启生效。全站跳转需安装 URL Rewrite 模块后添加规则。
Tomcat 9/10:把 PKCS12 密钥库放到 conf/ 下,修改 conf/server.xml:
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
maxThreads="200" SSLEnabled="true" scheme="https" secure="true"
keystoreFile="conf/example.com.p12" keystoreType="PKCS12"
keystorePass="YourPass123" SSLProtocol="TLSv1.2,TLSv1.3" />
若只有 JKS,可用 keytool -importkeystore -srckeystore old.jks -destkeystore example.com.p12 -deststoretype PKCS12 转换。Tomcat 的全站强制 HTTPS 在 conf/web.xml 末尾添加 <security-constraint> + <user-data-constraint><transport-guarantee>CONFIDENTIAL</transport-guarantee></user-data-constraint>,由容器自动 302 到 443。
五、四类 Web 服务器 HTTPS 配置要点对比
| 对比项 | Nginx | Apache | IIS | Tomcat |
|---|---|---|---|---|
| 证书文件格式 | PEM(crt + chain 合并) | PEM | .pfx / .p12 | .p12(推荐)或 .jks |
| 链证书写法 | 合并进 ssl_certificate |
2.4.8 前用 ChainFile,之后合并 | 导入“中间证书颁发机构”存储 | 打包进密钥库 |
| 协议控制 | ssl_protocols |
SSLProtocol |
注册表 SCHANNEL | SSLProtocol 属性 |
| HTTP 跳转 | return 301 |
Redirect permanent |
URL Rewrite 模块 | web.xml security-constraint |
| 配置校验 | nginx -t |
httpd -t |
appcmd list site |
启动日志 |
| 重载方式 | systemctl reload nginx |
systemctl reload httpd |
iisreset /restart | 重启 Tomcat |
| 最常见坑 | 忘拼中间证书 | 2.4.8+ 仍写 ChainFile | 私钥未导入/不可导出 | Alias 名不匹配 |
选型建议:面向公网、并发高的站点用 Nginx 或 Nginx + 后端应用;传统企业内网多为 IIS;Java 单体应用直接上 Tomcat 的 443 Connector,前面再加一层 Nginx 做卸载更灵活。无论哪种,“证书链是否完整”和“协议是否只保留 TLS 1.2/1.3”是必须逐项确认的两个验收点。
六、常见错误与真实报错排查
1)nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied)——文件不存在或权限不足。检查 ls -l,SELinux 开启时还需 chcon -t httpd_config_t 或 setsebool -P httpd_can_network_connect 1。
2)PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)——文件不是 PEM 格式,或误把 .key/.pfx 当成证书。用 file fullchain.pem 与 head -1 确认首行是 -----BEGIN CERTIFICATE-----。
3)SSL_CTX_use_PrivateKey() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)——私钥与证书不配对,回到第二节的 modulus 对比重新核对。
4)curl: (60) SSL certificate problem: unable to get local issuer certificate——典型的链不完整。用 openssl s_client -connect example.com:443 -servername example.com -showcerts 数一数返回了几张证书,只有 1 张就是缺中间证书。
5)curl: (35) error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure——客户端与服务端协议或加密套件不交集,常见于服务端只留 TLS 1.3 而老客户端只支持 TLS 1.0。用 nmap --script ssl-enum-ciphers -p 443 example.com 确认实际支持的套件。
6)Apache:AH01909: RSA certificate configured for example.com:443 does NOT include an ID which matches the server name——证书 SAN 与 ServerName 不一致,需重签或补 SAN。AH02559: The SSLCertificateChainFile directive is deprecated 则是版本升级后的告警,合并文件即可消除。
- HTTPS配置 · SSL证书安装服务(各种服务器)
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
7)Tomcat:java.io.IOException: Invalid keystore format / Alias name [tomcat] does not exist——密钥库类型写错(PKCS12 却声明 JKS),或 keyAlias 与实际别名不符,用 keytool -list -v -keystore example.com.p12 -storetype PKCS12 查看真实别名。
8)IIS 绑定报 0x80070520——证书未导入“个人”存储,或私钥不可被 IIS 服务账户读取,重新导入并勾选“允许导出私钥”。
9)浏览器报 NET::ERR_CERT_DATE_INVALID——证书已过期或服务器时间偏差过大,先 date -u 校时再续期。
10)控制台 Mixed Content: The page at 'https://example.com' was loaded over HTTPS, but requested an insecure element 'http://cdn.example.com/a.js'. This request has been blocked——进入下一节的混合内容治理。
七、全站强制 HTTPS 与混合内容治理
“单独访问 HTTPS”和“全站强制 HTTPS”是两种交付形态。前者只保证 443 可用,用户仍可访问 http;后者要求所有入口都收敛到 https,并让浏览器记住这个决定。
第一步,把 80 端口统一跳转。跳转状态码要区分场景:GET 页面用 301(永久,利于 SEO 权重合并),涉及 POST 表单与 API 的用 308(保留方法与请求体)。Nginx 写法:
if ($request_method = POST) { return 308 https://$host$request_uri; }
return 301 https://$host$request_uri;
第二步,开启 HSTS。首次上线建议先用短 max-age 观察:add_header Strict-Transport-Security "max-age=300" always;,稳定两周后再改为 max-age=31536000; includeSubDomains。加 preload 前务必确认所有子域名都已支持 HTTPS,否则一旦进入浏览器预加载列表,回退极其困难。
第三步,治理混合内容。定位方法:Chrome DevTools → Console 过滤 Mixed Content,或在命令行批量扫描:
curl -s https://example.com | grep -oE "http://[^"''' ]+" | sort -u
数据库与模板中的存量地址,用 SQL 批量替换(先备份):
UPDATE wp_posts SET post_content = REPLACE(post_content, 'http://example.com', 'https://example.com');
WordPress 还需在 wp-config.php 固定 define('WP_HOME','https://example.com'); define('WP_SITEURL','https://example.com');,否则后台会反复跳回 http。作为兜底,可下发 CSP 指令 Content-Security-Policy: upgrade-insecure-requests,让浏览器自动把 http 子资源升级为 https 请求。第三方接口若不支持 HTTPS,只能改为服务端代理转发。
第四步,交付后立即修改服务器远程登录密码、禁用密码登录改用密钥、关闭 80 端口的非跳转用途,这是“一对一远程部署服务”中容易被忽略的安全收尾动作。
八、效果验证与交付检查清单
配置完成后不要只看浏览器绿锁,用命令逐项验证才可交付。
1)证书信息与有效期:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
2)证书链完整性:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| grep -E "Verify return code|depth="
输出必须为 Verify return code: 0 (ok),且 depth 至少到 1(存在中间证书)。
3)跳转与 HSTS 头:
curl -sI http://example.com | head -3 # 期望 301 + Location: https://...
curl -sI https://example.com | grep -i strict-transport-security
4)协议与套件:
nmap --script ssl-enum-ciphers -p 443 example.com
确认列表中不出现 TLSv1.0 / TLSv1.1 / RC4 / 3DES。也可用 curl --tlsv1.0 --tls-max 1.0 https://example.com 反向验证应握手失败。
5)到期监控脚本(建议加入 crontab 每日执行):
END=$(echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
DAYS=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ $DAYS -lt 21 ] && echo "证书剩余 $DAYS 天,请立即续期" | mail -s "SSL 告警" ops@example.com
6)交付验收清单:证书链完整(curl 60 错误消失)/SAN 覆盖所有在用域名(含 www、m、api)/仅启用 TLS 1.2 与 1.3/80 端口 301 或 308 到 443/HSTS 头存在/混合内容清零/SSL Labs 评级 A 及以上/续期任务与到期告警已配置/服务器远程密码已修改。全部通过,才算真正完成一次“HTTPS 配置与 SSL 证书部署”。
常见问题
SSL 证书最长有效期是多久?过期会怎样?
公有 CA 签发的证书最长有效期为 398 天(2020 年 9 月 1 日起生效),Let’s Encrypt 固定 90 天并建议剩余 30 天时续期。证书过期后浏览器会报 NET::ERR_CERT_DATE_INVALID 并显示全屏警告,用户几乎无法继续访问,因此必须配置自动续期与到期告警。
单域名、多域名和通配符证书该怎么选?
只用一个域名选单域名证书;需要同时覆盖 example.com、www.example.com、api.example.com 等多个不同名称,选多域名(SAN)证书;需要覆盖数量不定的二级子域名,选通配符 *.example.com。注意通配符只匹配一级,*.example.com 不包含 a.b.example.com,也不包含裸域 example.com,通常需要“通配符 + 裸域”组合。
证书部署完成后需要重启服务器吗?
不需要重启整台服务器。Nginx 用 nginx -t && systemctl reload nginx 热加载,Apache 用 httpd -t && systemctl reload httpd,Tomcat 需重启实例,IIS 用 iisreset /restart 或直接重新绑定。但出于安全,部署服务后应立即修改远程登录密码、改用密钥登录并检查 443 以外的管理端口是否暴露在公网。
为什么 HTTPS 首页正常,内页图片和样式却不显示?
这是混合内容(Mixed Content)问题。页面本身通过 HTTPS 加载,但内部资源仍写死 http://,浏览器会阻止或降级加载。排查方式:DevTools Console 搜索 Mixed Content,或用 curl -s https://example.com | grep -oE "http://[^"''' ]+" 批量定位,然后把数据库、模板、CDN 配置中的地址统一替换为 https 或协议相对地址,并下发 Content-Security-Policy: upgrade-insecure-requests 兜底。
免费 Let’s Encrypt 证书和付费证书有什么区别?
加密强度没有区别,都是同一套 TLS 协议与 2048 位密钥体系。差异在于:有效期(90 天 vs 最长 398 天)、是否提供 OV/EV 组织验证、是否含商业保险与人工技术支持、是否支持通配符以外的多域名灵活组合。个人站与内部系统用免费证书 + 自动续期完全够用;涉及支付、金融、政企合规场景通常需要 OV 及以上证书。
301 跳转到 HTTPS 会不会导致 SEO 权重丢失?
不会。301 是永久重定向,搜索引擎会把原 http 页面的权重传递到对应的 https 页面。需要做的是:确保跳转是一对一映射(不要全部跳到首页)、在 Search Console 与百度站长平台提交 https 站点、更新 sitemap 中的地址为 https、保留 301 至少一年以上,不要短期内反复切换。