SSL 证书安装与 HTTPS 部署配置全指南(Nginx/Apache/Tomcat/IIS 实测版)
问题背景:证书“装上了”为什么浏览器仍然报不安全
运维群里最常见的一类求助:证书已经上传到服务器、面板也显示“已部署”,但浏览器地址栏依然写着“不安全”;或者 PC 端正常,Android 客户端和 Java 服务却直接抛异常。HTTPS 从来不是“上传一个 crt 文件”就结束,它由四件套共同决定:私钥、叶子证书、中间证书链、协议与端口配置。任何一环缺失,都会以不同的报错形式暴露出来。
第一类根因是证书链不完整。CA 签发的服务器证书(叶子证书)本身不包含签发它的中间 CA 证书,客户端需要靠中间证书把叶子证书接到系统根证书库里的根 CA。只配了 example.com.crt 而没拼接中间证书时,桌面 Chrome 常常能通过 AIA 扩展自动补链,所以你会觉得“我这能打开”;但 Android 旧版本、Java、curl、Python requests 会直接失败。这类“部分客户端报错”几乎 100% 是链的问题。
第二类根因是私钥与证书不匹配:CSR 在 A 机器生成、证书在 B 机器申请,或者同名文件被覆盖。第三类是协议与端口:TLS 1.0/1.1 自 2020 年起被主流浏览器全面停用,仍启用老协议会直接握手失败;或者服务监听 8443 却用 443 访问;云服务器安全组只放行了 80 没放 443。第四类是域名与混合内容:证书 SAN 里只有 example.com,用户访问 www.example.com 就报 ERR_CERT_COMMON_NAME_INVALID;页面里还引着 http:// 的图片和 JS,锁标变灰甚至被拦截。
先用一条命令定位,看 issuer 与 subject 是否构成完整链:
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -subject -issuer -dates
如果输出的 issuer 与 subject 相同(自签证书),或者命令没有任何输出,说明 443 端口根本没跑 TLS 或证书链没配对,先解决这一层再谈优化。
证书类型、有效期规则与选型对比
按验证强度分为 DV、OV、EV;按覆盖范围分为单域名、多域名(SAN)、通配符。三者不是“加密强度”的差别,密码学强度完全一致,差别只在 CA 是否核验了申请者身份。
- DV(域名验证):只验证域名控制权,通过 DNS TXT、HTTP 文件或管理员邮箱验证,通常 10 分钟内签发,验证记录可在签发后删除。
- OV(组织验证):额外核验企业名称、地址、电话,需与工商公示信息一致,通常 1–3 个工作日。
- EV(扩展验证):最严格的主体核验。注意:Chrome 77(2019 年)起已移除 EV 证书的绿色地址栏,“绿栅”效果不复存在,EV 现在的价值是合规背书与责任保险,而不是界面差异。
- 通配符:
*.example.com只覆盖一级子域,不覆盖 example.com 本身,也不覆盖 a.b.example.com,需要额外加 SAN。
有效期规则是必须更新的常识:自 2020-09-01 起,公有 CA 签发的 TLS 服务器证书最长有效期被限制为 398 天;Let’s Encrypt 免费证书固定 90 天,官方明确要求用 certbot / acme.sh 自动续期。按 CA/B Forum 已通过的 SC-081 计划,2026-03-15 起上限降至 200 天,2027-03-15 降至 100 天,2029-03-15 降至 47 天——“到期前手动续”的运维方式必须彻底废弃。
| 类型 | 验证内容 | 典型签发时长 | 适用场景 |
|---|---|---|---|
| DV 单域名 | 域名控制权 | 10 分钟内 | 个人站、API、测试环境 |
| DV 通配符 | 域名控制权 | 10 分钟–1 小时 | 多子域统一管理 |
| OV | 主体工商信息 + 电话回拨 | 1–3 个工作日 | 企业官网、B 端 SaaS |
| EV | 严格主体核验 + 法律存续证明 | 3–7 个工作日 | 金融、支付、招投标 |
| 多域名 SAN | 多个 FQDN 合并一张证书 | 同对应等级 | 主域 + 品牌域 + 后台域 |
第一步:生成 CSR 与私钥(RSA / ECDSA)
私钥必须在最终部署的服务器上生成,不要用第三方在线工具生成,否则等于私钥已泄露。RSA 2048 位是兼容性最好的选择;ECDSA P-256 性能更好、握手更快,但对极老的 Windows Server 2003 / Android 4.x 客户端不友好。
# RSA 2048 + SAN 扩展(一条命令生成私钥和 CSR)
openssl req -new -newkey rsa:2048 -sha256 -nodes
-keyout example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co., Ltd./CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# ECDSA P-256
openssl ecparam -genkey -name prime256v1 -out example.com.key
openssl req -new -key example.com.key -sha256 -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Tech Co., Ltd./CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
提交前务必自检 CSR 的 SAN 是否包含 www 与所有业务子域;OV/EV 的 O、C、ST、L 必须与营业执照逐字一致,否则 CA 会退回重提,白白多等几天:
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
openssl req -in example.com.csr -noout -verify
拿到证书后先确认私钥与证书是一对,再上传服务器:
openssl x509 -noout -modulus -in example.com.crt | openssl sha256
openssl rsa -noout -modulus -in example.com.key | openssl sha256 # 两行输出必须一致
chmod 600 example.com.key && chown root:root example.com.key
ECDSA 证书不能用 modulus 比对,改用公钥指纹:openssl x509 -in example.com.crt -noout -pubkey | openssl sha256 与 openssl pkey -in example.com.key -pubout | openssl sha256 对比结果。
第二步:Nginx 部署 HTTPS 完整实操
先把叶子证书与中间证书按顺序拼接成 fullchain。顺序错了(中间证书在前)同样报链错误;且绝对不要把根证书放进 fullchain,部分客户端会因此判定链无效:
cat example.com.crt intermediate.crt > fullchain.crt
cp fullchain.crt intermediate.crt example.com.key /etc/nginx/ssl/
chmod 600 /etc/nginx/ssl/example.com.key
站点配置(80 强制跳转 + 443 现代 TLS 参数):
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.crt;
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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305: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/intermediate.crt;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; }
}
校验并热加载:nginx -t && systemctl reload nginx。后端是 Tomcat/Node 时反向代理到 http 没问题,但页面内所有静态资源必须用 https 或协议相对地址,否则触发混合内容拦截。HSTS 建议先用 max-age=300 灰度一天,确认全站(含子域)HTTPS 可用后再改成一年,否则回滚代价极高。
第三步:Apache、Tomcat、IIS 配置示例
Apache(httpd-ssl.conf / vhost):
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/intermediate.crt
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Apache 2.4.8 起 SSLCertificateChainFile 已废弃并打印 AH02559 警告,此时把中间证书直接追加到 SSLCertificateFile 指向的文件末尾即可。修改后执行 apachectl configtest && systemctl reload httpd。
Tomcat(server.xml):
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" scheme="https" secure="true"
keystoreFile="/opt/tomcat/conf/example.jks" keystorePass="changeit"
clientAuth="false" sslProtocol="TLS"
sslEnabledProtocols="TLSv1.2,TLSv1.3" />
由 PEM 转 JKS(以 PKCS12 为中间格式,JDK 8 及以上通用):
openssl pkcs12 -export -in fullchain.crt -inkey example.com.key
-out example.p12 -name tomcat -passout pass:changeit
keytool -importkeystore -srckeystore example.p12 -srcstoretype PKCS12
-destkeystore example.jks -deststoretype JKS -deststorepass changeit
IIS:导入 .pfx 时必须包含私钥与全部中间证书(导出时勾选“包含所有证书”),站点绑定 443 并勾选“需要服务器名称指示(SNI)”;续期推荐 win-acme,导入后执行 iisreset。三者共同点是:证书路径、密码、端口任一处写错,表现都是“服务起不来”而不是“证书报错”,排错时先看服务日志再看浏览器。
面板环境部署与多环境对比
宝塔面板:网站 → 设置 → SSL → 其他证书,PEM 框粘贴 fullchain.crt 全文(必须含中间证书),私钥框粘贴 example.com.key,保存后打开“强制 HTTPS”。粘贴最容易丢的是换行和 -----END CERTIFICATE----- 结尾行,保存时报“证书格式错误”基本都是这个原因。phpStudy 在 vhosts.conf 中手写 ssl 指令或用面板 SSL 模块;WDCP 在“网站管理 → SSL”上传 crt 与 key,老版本面板不支持 TLS 1.3,需升级或改用源码编译的 Nginx。
| 环境 | 关键配置项 | 证书文件要求 | 生效命令 | 常见坑 |
|---|---|---|---|---|
| Nginx | ssl_certificate / ssl_certificate_key | fullchain(叶子+中间) | nginx -t && systemctl reload nginx | 只放叶子证书、漏配 http2 |
| Apache | SSLCertificateFile / ChainFile | 2.4.8+ 可合并到 File | apachectl configtest && reload | mod_ssl 未启用、指令废弃 |
| Tomcat | Connector port=443 / keystoreFile | JKS 或 PKCS12 | systemctl restart tomcat | 密码错、端口被占用 |
| IIS | 站点绑定 443 + SNI | PFX 含私钥与链 | iisreset | 导入时未含中间证书 |
| 宝塔 | 面板 SSL → 其他证书 | PEM 含完整链 | 面板自动 reload | 粘贴丢换行/结尾行 |
| phpStudy / WDCP | vhost 或面板 SSL | crt + key 分开 | 重启 Web 服务 | 面板版本旧不支持 TLS 1.3 |
无论哪个环境,验收标准一致:443 可握手、80 返回 301、证书链完整、TLS 1.0/1.1 已关闭。面板只是把配置文件包了一层,出问题时仍要回到 nginx -t 和 openssl s_client 这两条命令上看真实输出。
常见错误排查(真实报错对照)
下面这些报错在工单里出现频率最高,按“报错原文 → 根因 → 修复”对照处理:
curl: (60) SSL certificate problem: unable to get local issuer certificate:链不完整。把 intermediate.crt 拼进 fullchain 后重载;自建 CA 场景需把根证书装进系统信任库(update-ca-certificates)。nginx: [emerg] SSL_CTX_use_PrivateKey_file("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch):私钥与证书不是一对,用前面的 modulus/pubkey 命令比对后重新签发。- 浏览器
NET::ERR_CERT_AUTHORITY_INVALID、微信内置浏览器提示“证书无效”:链不全或用了自签证书,安卓与微信对链的校验比桌面 Chrome 严格得多。 NET::ERR_CERT_COMMON_NAME_INVALID:证书 SAN 不含当前访问域名,最常见是漏了 www。SSL_ERROR_RX_RECORD_TOO_LONG:用 https:// 访问了 HTTP 端口,或反向代理把 HTTPS 请求转到 http 后端却没带X-Forwarded-Proto。Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure element 'http://example.com/a.js':改相对路径,或加Content-Security-Policy: upgrade-insecure-requests。AH02559: The SSLCertificateChainFile directive is deprecated:Apache 2.4.8+ 把中间证书合并进 SSLCertificateFile。nginx: [warn] "ssl_stapling" ignored, issuer certificate not found for certificate:补上ssl_trusted_certificate指向中间证书。java.io.IOException: No Certificate file specified or invalid file format(Tomcat):keystoreFile 路径错,或把 PEM 直接当 JKS 用。NET::ERR_CERT_DATE_INVALID:客户端时间偏差,服务器执行chronyc makestep或ntpd -gq校时。
排查顺序固定:先 ss -lntp | grep 443 确认监听,再 openssl s_client -connect IP:443 -servername example.com 确认握手与链,最后才看应用日志,避免在错误的方向上翻半天日志。
效果验证与自动化续期
部署完必须用命令行验证,而不是“我这儿能打开”就算完:
# 1. 证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com /dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 链完整性:输出的证书张数应为 2 或 3(叶子 + 中间,可选根)
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | grep -c 'BEGIN CERTIFICATE'
# 3. 强制 TLS 1.2 / 1.3 握手
curl -sSI --tlsv1.2 https://example.com | head -3
curl -sSI --tlsv1.3 https://example.com | head -3
# 4. HTTP 是否 301 跳转
curl -sI http://example.com | grep -iE 'HTTP/|location'
# 5. OCSP Stapling 状态
openssl s_client -connect example.com:443 -servername example.com -status /dev/null | grep -i 'OCSP Response Status'
把到期检查写成脚本挂到 cron 上,比任何“到期提醒表格”都可靠:
#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -servername $DOMAIN -connect $DOMAIN:443 2>/dev/null
| openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ( $(date -d "$END" +%s) - $(date +%s) ) / 86400 ))
[ "$LEFT" -lt 20 ] && echo "WARN: $DOMAIN 证书剩余 ${LEFT} 天" | mail -s "SSL 到期告警" ops@example.com
自动续期:Let’s Encrypt 用 certbot renew --dry-run 先演练,再写 0 3 * * * root certbot renew -q --deploy-hook 'systemctl reload nginx';acme.sh 用 acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/fullchain.crt --reloadcmd 'systemctl reload nginx',DNS 方式签发要保留 --cron 任务。最后用 SSL Labs 跑一次,目标 A/A+:TLS 1.3 可握手、HSTS 生效、无 RC4/3DES、OCSP Stapling 正常。
常见问题
证书安装后浏览器仍显示“不安全”怎么办?
按三步定位:第一步 openssl s_client -connect 域名:443 -servername 域名 -showcerts 看链是否完整(应输出 2 张以上证书);第二步检查页面是否有 http:// 资源被引用(F12 Console 会打印 Mixed Content);第三步检查证书 SAN 是否覆盖当前访问的域名(含 www)。90% 的情况是只部署了叶子证书没拼中间证书。
一张证书能同时用于 example.com 和 www.example.com 吗?
可以,但必须申请时把两个域名都写进 SAN(多域名/含 www 的单域名证书)。只写了 example.com 的证书访问 www 会报 NET::ERR_CERT_COMMON_NAME_INVALID。通配符 *.example.com 同样不覆盖裸域 example.com,需要单独加一条 SAN。
免费证书和付费 DV 证书有区别吗?
加密强度没有区别,都是同样的 TLS 握手与算法。差别在有效期与保障:Let’s Encrypt 固定 90 天,必须自动化续期;付费 DV 最长 398 天(2026-03-15 起降为 200 天),通常带一定的签发错误赔付。OV/EV 才是身份核验层面的差异。
证书最长有效期到底是多久?
公有可信 CA 签发的 TLS 服务器证书当前上限为 398 天(2020-09-01 起生效),Let’s Encrypt 为 90 天。按 CA/B Forum SC-081 计划,2026-03-15 起降至 200 天、2027-03-15 降至 100 天、2029-03-15 降至 47 天,因此必须用 certbot/acme.sh 等工具做自动续期,不要再依赖人工台账。
内网或本地开发环境能用公网证书吗?
不能。公网 CA 无法为 192.168.x.x、localhost、.local 等域名签发证书。内网推荐两条路:用内部 CA(如 step-ca、mkcert)签发并把根证书下发到客户端信任库;或者用真实公网域名 + DNS-01 验证签发 Let’s Encrypt 证书,再通过内网 DNS 解析到私网 IP。
更换证书后需要重启服务器吗?
不需要重启操作系统,但要让 Web 服务重新加载配置:Nginx 用 systemctl reload nginx(平滑重载,不断连接),Apache 用 systemctl reload httpd,Tomcat 修改 server.xml 后必须 restart,IIS 导入证书后重新绑定即可,必要时 iisreset。重载后务必用 openssl s_client 复核生效的是新证书序列号。